La referencia de la API se publica en inglés.

Create child tasks

POST/api/issues/{id}/children
Personal API keyAgent API keyConsole session
Veyra Docs TeamActualizado el Versión 3 · Historial

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) | nullOpcionalpattern: ^([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) | nullOpcionalpattern: ^([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) | nullOpcionalpattern: ^([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})$
visibilitystringOpcionalone of: "open", "private"default: "open"
blockedByIssueIdsarray<string (uuid)>Opcional
unblockDescriptorobject | nullOpcional
unblockDescriptor.ownerobject | stringObligatorio
unblockDescriptor.actionstringObligatorio
titlestringOpcional
descriptionstring | nullOpcional
statusstringObligatorioone of: "backlog", "todo", "in_progress", "in_review", "done", "blocked", "cancelled"
workModestringOpcionalone of: "standard", "ask", "planning", "skill_test"default: "standard"
harnessKindstring | nullOpcionalone of: "skill_test"
prioritystringOpcionalone of: "critical", "high", "medium", "low"default: "medium"
reviewPolicystring | nullOpcionalone of: "anyone", "not_creator", "human_only"
assigneeAgentIdstring (uuid) | nullOpcionalpattern: ^([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≤ 9007199254740991
createdByUserIdstring | nullOpcional
responsibleUserIdstring | nullOpcional
billingCodestring | nullOpcional
assigneeAdapterOverridesobject | nullOpcional
assigneeAdapterOverrides.adapterConfigobjectOpcional
assigneeAdapterOverrides.useProjectWorkspacebooleanOpcional
executionPolicyobject | nullOpcional
executionPolicy.requiredQualityReviewobjectOpcional
executionPolicy.requiredQualityReview.versionnumberObligatorioone of: 1
executionPolicy.requiredQualityReview.deliverablesarray<object>Obligatorioat least 1 itemat most 10 items
executionPolicy.modestringOpcionalone of: "normal", "auto"default: "normal"
executionPolicy.commentRequiredbooleanOpcionaldefault: true
executionPolicy.stagesarray<object>Opcionaldefault: []
executionPolicy.stages[].idstring (uuid)Opcionalpattern: ^([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[].typestringObligatorioone of: "review", "approval"
executionPolicy.stages[].approvalsNeedednumberOpcionalone of: 1default: 1
executionPolicy.stages[].participantsarray<object>Opcionaldefault: []
executionPolicy.monitorobject | nullOpcional
executionPolicy.monitor.nextCheckAtstring (date-time)Obligatorio
executionPolicy.monitor.notesstring | nullOpcionalat most 500 charactersdefault: null
executionPolicy.monitor.scheduledBystringOpcionalone of: "assignee", "board"default: "assignee"
executionPolicy.monitor.kindstring | nullOpcionalone of: "external_service"default: null
executionPolicy.monitor.serviceNamestring | nullOpcional1–120 charactersdefault: null
executionPolicy.monitor.externalRefstring | nullOpcional1–500 charactersdefault: null
executionPolicy.monitor.timeoutAtstring (date-time) | nullOpcionaldefault: null
executionPolicy.monitor.maxAttemptsinteger | nullOpcional> 0≤ 100default: null
executionPolicy.monitor.recoveryPolicystring | nullOpcionalone of: "wake_owner", "create_recovery_issue", "escalate_to_board"default: null
executionPolicy.reviewPresetobjectOpcional
executionPolicy.reviewPreset.idstringObligatorioone of: "low_trust_review"
executionPolicy.reviewPreset.versionnumberObligatorioone of: 1
executionPolicy.reviewPreset.rawOutputDispositionstringObligatorioone of: "quarantine"
executionPolicy.authorizationPolicyobjectOpcional
executionPolicy.authorizationPolicy.trustPresetstringOpcionalone of: "standard", "low_trust_review"
executionPolicy.authorizationPolicy.reviewPresetobjectOpcional
executionPolicy.authorizationPolicy.trustBoundaryobjectOpcional
executionPolicy.authorizationPolicy.assignmentPolicyobjectOpcional
executionPolicy.authorizationPolicy.protectedAgentobjectOpcional
executionPolicy.maxReviewRoundsinteger | nullOpcional> 0≤ 50default: null
executionWorkspaceIdstring (uuid) | nullOpcionalpattern: ^([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 | nullOpcionalone of: "inherit", "shared_workspace", "isolated_workspace", "operator_branch", "reuse_existing", "agent_default"
workspaceSelectionobjectOpcional
executionWorkspaceSettingsobject | nullOpcional
executionWorkspaceSettings.modestringOpcionalone of: "inherit", "shared_workspace", "isolated_workspace", "operator_branch", "reuse_existing", "agent_default"
executionWorkspaceSettings.sharedWorkspaceConcurrencystringOpcionalone of: "auto", "serialize", "allow"
executionWorkspaceSettings.environmentIdstring (uuid) | nullOpcionalpattern: ^([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.typestringOpcionalone 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>Opcionalat most 100 itemseach at most 253 characters
executionWorkspaceSettings.networkEgress.allowCidrsarray<string>Opcionalat most 100 itemseach at most 64 characters
labelIdsarray<string (uuid)>Opcional
watchdogobject | nullOpcional
watchdog.agentIdstring (uuid)Obligatoriopattern: ^([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>Opcionalat most 20 itemseach at most 500 characters
blockParentUntilDonebooleanOpcionaldefault: false

Respuestas

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.

Tasks