Create a task

The task opens in the project’s initial state; use the returned id as taskId on subsequent events. The name is immutable.

Authentication

AuthorizationBearer

Organization-scoped API key.

Headers

X-API-VersionstringRequired
Idempotency-KeystringRequired

Idempotency key; duplicate submissions return the original event.

Request

This endpoint expects an object.
namestringRequired>=1 character

Human-readable case name

projectNamestringRequired>=1 character
Slug of an existing project
externalIdstringOptional1-200 characters

Optional client correlation id (e.g. agent session/run); bookkeeping only — not unique

metadataPatchobjectOptional

Response

Created