Agent tasks
Complete a task
Mark a task done with a plain-text summary the person sees in RankParse.
POST
https://api.rankparse.com/v1/agent-tasks/:id/completeFreeAPI keyFinishes a task with a summary of what you found and did. A task that is still open is claimed for your credential in the same step, so you do not need to claim it first.
Path parameters
idstringrequiredThe task id (tsk_...). A malformed id, an unknown id and another workspace's id return 404 task_not_found.
Body parameters
summarystringrequiredPlain text. Control and invisible characters are removed and the text is cut to 2000 characters. Missing, not a string, or empty after cleaning returns 400 invalid_task_summary.
Response
taskobjectThe task with status: "done", completed_at and result_summary set.
Behavior
- Completing writes a
task.completedevent, with your summary, to the website's activity feed. It stays visible to the team only unless a team member shares it with clients. - A task claimed by another credential, or already done, expired or cancelled, returns
409 task_not_claimable. Completing the same task twice therefore returns409the second time.
Errors
| HTTP | Code | When |
|---|---|---|
| 400 | invalid_task_summary | summary is missing, not a string, or empty after cleaning. |
| 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 | Done, expired, cancelled, or claimed by another credential. |
| 429 | rate_limited | More than 60 requests in a minute. |
Related
MCP tool: complete_agent_task (accepts task_id, summary).