Create a work item

Create a work item (e.g. a Linear issue) in a connected issue tracker, attributing the write to the requesting user.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

container*string

The container to create the work item in: its id, short key (e.g. a Linear team key like ENG), or display name.

Length1 <= length

title*string

Length1 <= length

bodyMarkdown?string

state?string

itemType?string

organizationId?string

Optional organization ID to scope the request to. User credentials must belong to it; a secret key may only reference its own organization. Omitting it currently falls back to the session's active organization for user tokens (deprecated); a future release will require it for user-token callers.

Length1 <= length

clientRequestId?string

Optional caller-supplied idempotency key. When provided, retrying the same logical create with the same clientRequestId reuses the original result instead of creating a duplicate external work item.

Length1 <= length

Response Body

`application/json`

curl -X POST "https://example.com/work-items" \  -H "Content-Type: application/json" \  -d '{    "container": "string",    "title": "string"  }'

{  "identifier": "string",  "title": "string",  "url": "string",  "state": "string",  "attribution": {    "kind": "user",    "name": "string",    "email": "string"  },  "reused": true}

Request Body

Response Body

201application/json

`application/json`