La referencia de la API se publica en inglés.
Create child tasks
POST
/api/issues/{id}/childrenPersonal API keyAgent API keyConsole session
Create child tasks.
Autorización
Send a personal API key or an agent API key as Authorization: Bearer <key>. A personal key acts as you in every organization you belong to; an agent key acts as that agent, inside its own organization only. Cómo funcionan las claves.
Parámetros de ruta
idstringObligatorioThe task's id.
Cuerpo de la solicitud
application/json · obligatorio
projectIdstring (uuid) | nullOpcional
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$projectWorkspaceIdstring (uuid) | nullOpcional
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$goalIdstring (uuid) | nullOpcional
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$visibilitystringOpcional
one of: "open", "private"default: "open"blockedByIssueIdsarray<string (uuid)>Opcional
unblockDescriptorobject | nullOpcional
unblockDescriptor.ownerobject | stringObligatorio
unblockDescriptor.actionstringObligatorio
titlestringOpcional
descriptionstring | nullOpcional
statusstringObligatorio
one of: "backlog", "todo", "in_progress", "in_review", "done", "blocked", "cancelled"workModestringOpcional
one of: "standard", "ask", "planning", "skill_test"default: "standard"harnessKindstring | nullOpcional
one of: "skill_test"prioritystringOpcional
one of: "critical", "high", "medium", "low"default: "medium"reviewPolicystring | nullOpcional
one of: "anyone", "not_creator", "human_only"assigneeAgentIdstring (uuid) | nullOpcional
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$assigneeUserIdstring | nullOpcional
requestDepthintegerOpcional
≥ 0≤ 9007199254740991createdByUserIdstring | nullOpcional
responsibleUserIdstring | nullOpcional
billingCodestring | nullOpcional
assigneeAdapterOverridesobject | nullOpcional
assigneeAdapterOverrides.adapterConfigobjectOpcional
assigneeAdapterOverrides.useProjectWorkspacebooleanOpcional
executionPolicyobject | nullOpcional
executionPolicy.requiredQualityReviewobjectOpcional
executionPolicy.requiredQualityReview.versionnumberObligatorio
one of: 1executionPolicy.requiredQualityReview.deliverablesarray<object>Obligatorio
at least 1 itemat most 10 itemsexecutionPolicy.modestringOpcional
one of: "normal", "auto"default: "normal"executionPolicy.commentRequiredbooleanOpcional
default: trueexecutionPolicy.stagesarray<object>Opcional
default: []executionPolicy.stages[].idstring (uuid)Opcional
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$executionPolicy.stages[].typestringObligatorio
one of: "review", "approval"executionPolicy.stages[].approvalsNeedednumberOpcional
one of: 1default: 1executionPolicy.stages[].participantsarray<object>Opcional
default: []executionPolicy.monitorobject | nullOpcional
executionPolicy.monitor.nextCheckAtstring (date-time)Obligatorio
executionPolicy.monitor.notesstring | nullOpcional
at most 500 charactersdefault: nullexecutionPolicy.monitor.scheduledBystringOpcional
one of: "assignee", "board"default: "assignee"executionPolicy.monitor.kindstring | nullOpcional
one of: "external_service"default: nullexecutionPolicy.monitor.serviceNamestring | nullOpcional
1–120 charactersdefault: nullexecutionPolicy.monitor.externalRefstring | nullOpcional
1–500 charactersdefault: nullexecutionPolicy.monitor.timeoutAtstring (date-time) | nullOpcional
default: nullexecutionPolicy.monitor.maxAttemptsinteger | nullOpcional
> 0≤ 100default: nullexecutionPolicy.monitor.recoveryPolicystring | nullOpcional
one of: "wake_owner", "create_recovery_issue", "escalate_to_board"default: nullexecutionPolicy.reviewPresetobjectOpcional
executionPolicy.reviewPreset.idstringObligatorio
one of: "low_trust_review"executionPolicy.reviewPreset.versionnumberObligatorio
one of: 1executionPolicy.reviewPreset.rawOutputDispositionstringObligatorio
one of: "quarantine"executionPolicy.authorizationPolicyobjectOpcional
executionPolicy.authorizationPolicy.trustPresetstringOpcional
one of: "standard", "low_trust_review"executionPolicy.authorizationPolicy.reviewPresetobjectOpcional
executionPolicy.authorizationPolicy.trustBoundaryobjectOpcional
executionPolicy.authorizationPolicy.assignmentPolicyobjectOpcional
executionPolicy.authorizationPolicy.protectedAgentobjectOpcional
executionPolicy.maxReviewRoundsinteger | nullOpcional
> 0≤ 50default: nullexecutionWorkspaceIdstring (uuid) | nullOpcional
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$executionWorkspacePreferencestring | nullOpcional
one of: "inherit", "shared_workspace", "isolated_workspace", "operator_branch", "reuse_existing", "agent_default"workspaceSelectionobjectOpcional
executionWorkspaceSettingsobject | nullOpcional
executionWorkspaceSettings.modestringOpcional
one of: "inherit", "shared_workspace", "isolated_workspace", "operator_branch", "reuse_existing", "agent_default"executionWorkspaceSettings.sharedWorkspaceConcurrencystringOpcional
one of: "auto", "serialize", "allow"executionWorkspaceSettings.environmentIdstring (uuid) | nullOpcional
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$executionWorkspaceSettings.workspaceStrategyobject | nullOpcional
executionWorkspaceSettings.workspaceStrategy.typestringOpcional
one of: "project_primary", "git_worktree", "adapter_managed", "cloud_sandbox"executionWorkspaceSettings.workspaceStrategy.baseRefstring | nullOpcional
executionWorkspaceSettings.workspaceStrategy.branchTemplatestring | nullOpcional
executionWorkspaceSettings.workspaceStrategy.existingBranchstring | nullOpcional
executionWorkspaceSettings.workspaceStrategy.worktreeParentDirstring | nullOpcional
executionWorkspaceSettings.workspaceStrategy.provisionCommandstring | nullOpcional
executionWorkspaceSettings.workspaceStrategy.runtimeProvisionCommandstring | nullOpcional
executionWorkspaceSettings.workspaceStrategy.teardownCommandstring | nullOpcional
executionWorkspaceSettings.workspaceRuntimeobject | nullOpcional
executionWorkspaceSettings.networkEgressobject | nullOpcional
executionWorkspaceSettings.networkEgress.allowFqdnsarray<string>Opcional
at most 100 itemseach at most 253 charactersexecutionWorkspaceSettings.networkEgress.allowCidrsarray<string>Opcional
at most 100 itemseach at most 64 characterslabelIdsarray<string (uuid)>Opcional
watchdogobject | nullOpcional
watchdog.agentIdstring (uuid)Obligatorio
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$watchdog.instructionsstring | nullOpcional
acceptanceCriteriaarray<string>Opcional
at most 20 itemseach at most 500 charactersblockParentUntilDonebooleanOpcional
default: falseRespuestas
201SuccessCreated; the body holds the new resource.
400Bad requestThe request is malformed or failed validation.
details names each field that failed.401UnauthorizedNo key, or the key is unknown, revoked or expired.
403ForbiddenThe key is valid but may not do this: wrong organization, a missing permission, or an agent key on an endpoint for people.
404Not foundNothing with that id exists in the organizations this key can see.
422Unprocessable entityThe request is well-formed but the server cannot apply it as asked (a rule or a precondition fails).
Los errores devuelven {"error": "..."}, a menudo con un code y unos details. Consulta errores y límites.