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
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | yes | Task id |
Request body: dto.AgentHandoffRequest
| Name | Type | Required | Description |
|---|---|---|---|
| target | string (cursor | claude_code) | no | Target 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