Update story

Applies a typed patch with a personal access token or supported service-account or OAuth credential only when expectedUpdatedAt matches the current task version. Omitted fields are preserved; clearFields clears optional values. A concurrent edit returns 409.

PATCH
/api/v1/workspaces/{workspaceId}/stories/{storyId}

Applies a typed patch with a personal access token or supported service-account or OAuth credential only when expectedUpdatedAt matches the current task version. Omitted fields are preserved; clearFields clears optional values. A concurrent edit returns 409.

Authorization

machineBearer
AuthorizationBearer <token>

Personal access tokens and supported service-account keys are accepted only in the Authorization header and never in URLs. Each operation documents which principal types it authorizes.

In: header

Path Parameters

workspaceId*string

Workspace UUID. It must match the workspace bound to the credential.

Formatuuid
storyId*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/api/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/stories/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "expectedUpdatedAt": "2019-08-24T14:15:22Z"  }'
Empty