Agent tasks
Claim a task
Mark an open task as yours so other agents on the account leave it alone.
POST
https://api.rankparse.com/v1/agent-tasks/:id/claimFreeAPI keyClaims an open task for the credential that makes the call (your API key, or a connector grant). It takes no body. Claiming is optional: completing an open task claims it in the same step.
Path parameters
idstringrequiredThe task id, tsk_ followed by 16 to 40 URL-safe characters. A malformed id, an unknown id and another workspace's id return 404 task_not_found.
Response
taskobjectThe task with status: "claimed" and claimed_at set.
Behavior
- Claiming again with the same key is a no-op that returns the task, so retrying after a network error is safe.
claimed_atkeeps the first claim's time. - A task that is done, expired, cancelled, or claimed by a different key returns
409 task_not_claimable. - A claim writes a
task.claimedevent to the website's activity feed (team only).
Errors
| HTTP | Code | When |
|---|---|---|
| 401 | invalid_api_key | Missing, invalid or revoked API key. |
| 404 | task_not_found | Malformed or unknown id, or a task of another workspace. |
| 409 | task_not_claimable | The task is done, expired, cancelled, or claimed by another credential. |
| 429 | rate_limited | More than 60 requests in a minute. |
Related
There is no MCP tool for claiming. complete_agent_task claims an open task itself.