Sign in
Work Items

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.

post/work-items

Request body

containerstring required

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

titlestring required
bodyMarkdownstring
statestring
itemTypestring
organizationIdstring

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.

clientRequestIdstring

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.

Response

OK

identifierstring required
titlestring required
urlstring required
statestring required
reusedboolean required

Changes

No recorded changes to this endpoint across all 4 revisions of this API.