Skip to content

All resources

task-handoff

1 endpoint

post /tasks/{id}/agent-handoff

Record that a task was handed to a coding agent

Requires authentication

Records one agent_handoff product event for the caller and the task (one per user, task, target and UTC day). It stores only the target, never the task's text, and a failure to write the event does not fail the call.

Parameters

NameInTypeRequiredDescription
idpathintegeryesTask id

Request body: dto.AgentHandoffRequest

NameTypeRequiredDescription
targetstring (cursor | claude_code)noTarget is "cursor" or "claude_code".

Responses

  • 200 OK · object
  • 400 Bad Request · apimodel.ErrorEnvelope
  • 401 Unauthorized · apimodel.ErrorEnvelope
  • 403 Forbidden · apimodel.ErrorEnvelope
  • 404 Not Found · apimodel.ErrorEnvelope