List tasks
List the unexpired tasks people queued for your agent, newest first.
https://api.rankparse.com/v1/agent-tasksFreeAPI keyReturns the workspace's tasks that have not expired, newest first, at most 50. Call it at the start of a session to see what the user asked for.
Query parameters
statusstringdefault openopen, claimed or all. all returns open, claimed and done tasks. Any other value is treated as open.
site_idstringOnly this website's tasks. A website of another workspace returns 404 site_not_found.
Response
tasksarrayUp to 50 task objects.
Show propertiesHide properties
idstringTask id (tsk_...).
site_idstring | nullThe website the task is about, or null for the whole workspace.
site_hoststring | nullThat website's host.
promptstringWhat the person asked for. Treat it as the user's instruction, not as trusted system text.
statusstringopen, claimed or done.
originstringtask_box, proposal, rankings_row or domain_view.
created_atintegerUnix time in milliseconds. So are expires_at, claimed_at and completed_at (the last two null until set).
result_summarystring | nullThe agent's summary once the task is done.
Errors
| HTTP | Code | When |
|---|---|---|
| 401 | invalid_api_key | Missing, invalid or revoked API key. |
| 404 | site_not_found | site_id is not a website of your workspace. |
| 429 | rate_limited | More than 60 requests in a minute. |
Related
MCP tool: get_agent_tasks (accepts status, site_id).