Reassign a task

View as Markdown

Reassigns a task to another user (self/starter handoff or project:manage override).

Authentication

AuthorizationBearer

WorkOS session JWT or an organization API key, sent as Authorization: Bearer <token>.

Path parameters

projectIdstringRequired
runIdstringRequired
taskIdstringRequired

Request

This endpoint expects an object.
toUserIdstringRequired
The user id to reassign the task to.
reasonstringOptional
An optional reason for the reassignment.

Response

The reassigned task state.
taskmap from strings to any
An arbitrary JSON object.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error