{"uid":"cap_sUQPeh2sfZw8PuWLJfzcB","slug":"tako-agent-run-status-poller-3c31da07","name":"Tako Agent Run Status Poller","description":"Poll status for an agent run (free, receipt-authenticated)","url":"https://tako.com/api/mpp/v1/agent/runs/status?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["run_id"],"properties":{"run_id":{"type":"string","description":"The run_id returned by POST /api/mpp/v1/agent/runs."}}},"responseSchema":{"type":"object","title":"AgentRun","required":["run_id","status","created_at"],"properties":{"error":{"anyOf":[{"type":"object","title":"ErrorObject","required":["code","message"],"properties":{"code":{"type":"string","title":"Code"},"message":{"type":"string","title":"Message"}}},{"type":"null"}],"default":null},"usage":{"anyOf":[{"type":"object","title":"Usage","required":["total_cost_usd"],"properties":{"data":{"anyOf":[{"type":"object","title":"UsageData","required":["cost_usd","datasets"],"properties":{"cost_usd":{"type":"number","title":"Cost Usd","description":"USD cost of the inline data delivered in the response."},"datasets":{"type":"integer","title":"Datasets","description":"Number of billed datasets or content items included in the response."},"data_points":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Data Points","default":null,"description":"Number of billed quantitative data points included in the response."}},"description":"The cost and quantity of data delivered in the response.\n\n`datasets` counts billed datasets or content items. `data_points` counts\nbilled quantitative values in generated answer output."},{"type":"null"}],"default":null,"description":"Inline-data cost breakdown. Present only when the surface emitted billable inline data."},"compute":{"anyOf":[{"type":"object","title":"UsageCompute","required":["cost_usd"],"properties":{"cost_usd":{"type":"number","title":"Cost Usd","description":"USD cost of running the operation."}},"description":"The cost of running the operation. Absent on surfaces with no compute\nstep (contents)."},{"type":"null"}],"default":null,"description":"Compute cost breakdown. Present only on surfaces with a compute step (absent for contents)."},"variable_cost":{"anyOf":[{"type":"object","title":"UsageVariableCost","required":["cost_usd"],"properties":{"cost_usd":{"type":"number","title":"Cost Usd","description":"USD cost of the variable-cost charge."}},"description":"The variable-cost charge: the per-unit minimum of a variable-cost source\nthe response served, above the response's own price."},{"type":"null"}],"default":null,"description":"Variable-cost charge. Present only when the data a request or agent run served had a per-unit minimum above its own price: on a search, answer or contents request that set variable_cost, and on an agent run once it completes."},"total_cost_usd":{"type":"number","title":"Total Cost Usd","description":"Total quoted USD cost of this request: the sum of the components present."}},"description":"Usage for one metered request. `total_cost_usd` is always present (the\ntotal quoted charge). `compute` and `data` are the additive breakdown;\neach appears only where it applies. total_cost_usd always equals the sum\nof the components that appear."},{"type":"null"}],"default":null},"object":{"type":"string","const":"agent.run","title":"Object","default":"agent.run"},"result":{"anyOf":[{"type":"object","title":"AgentResult","properties":{"cards":{"type":"array","items":{"type":"object","title":"TakoCard","properties":{"nodes":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/TakoCardNode"}},{"type":"null"}],"title":"Nodes","default":null,"description":"Graph nodes (entities and metrics) behind this card. The response includes them by default. Absent for web-only cards or when node resolution was not available. Use each id with /v1/graph/node/{id} for full detail (aliases, subtype), or pass ids in sources.data.node_ids to pin these nodes in future searches."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null},"card_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Card Id","default":null},"content":{"anyOf":[{"$ref":"#/components/schemas/ResultContent"},{"type":"null"}],"default":null},"sources":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/TakoCardSource"}},{"type":"null"}],"title":"Sources","default":null},"card_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Card Type","default":null},"embed_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Embed Url","default":null},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","default":null},"relevance":{"anyOf":[{"$ref":"#/components/schemas/KnowledgeCardRelevance"},{"type":"null"}],"default":null,"description":"Tako's relevance label for this card, from the same ladder the flat `results` relevance uses. On `effort: deep` an LLM scores cards as integers 1 to 5, so a 5 is High and a 4 is Medium. A card the LLM leaves unscored keeps its continuous retrieval score and can be High below 5. Other efforts score continuously and can label the same card higher."},"exportable":{"type":"boolean","title":"Exportable","default":false,"description":"Whether the /contents endpoint can download this card's data. false means the export is not available; use the card's chart and inline preview instead. true means the export is eligible but not guaranteed; the /contents endpoint can still return 403, so fall back to the preview on error."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","default":null},"placeholder":{"anyOf":[{"$ref":"#/components/schemas/PlaceholderInfo"},{"type":"null"}],"default":null,"description":"Set when the card is a placeholder: it carries its title and no data points, because the request didn't include its source's data. Null on every card that carries its data."},"webpage_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webpage Url","default":null},"methodologies":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeCardMethodology"}},{"type":"null"}],"title":"Methodologies","default":null},"data_freshness":{"anyOf":[{"$ref":"#/components/schemas/DataFreshness"},{"type":"null"}],"default":null,"description":"Freshness dates for the card's data: where the data ends (coverage_end), the same point as a full date (data_as_of, deprecated), and the last refresh date (last_updated). Null when no date is available."},"source_indexes":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/TakoSourceIndex"}},{"type":"null"}],"title":"Source Indexes","default":null},"relevance_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Relevance Score","default":null,"description":"Numeric relevance of this card to the query on a 1.0-5.0 scale (5.0 = exact match; higher is more relevant). Only populated for entitled accounts; null otherwise."},"metric_definitions":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/MetricDefinition"}},{"type":"null"}],"title":"Metric Definitions","default":null,"description":"Definitions of the metrics this card displays (name + definition). Null when no displayed metric has a definition available."},"semantic_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Semantic Description","default":null}},"description":"A Tako knowledge card on the search and answer surfaces. It carries a\n`content` download descriptor."},"title":"Cards"},"answer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Answer","default":null},"metadata":{"anyOf":[{"type":"object","title":"AgentAnswerMetadata","properties":{"citations":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/AgentAnswerCitation"}},{"type":"null"}],"title":"Citations","default":null},"assumptions":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/AgentAnswerAssumption"}},{"type":"null"}],"title":"Assumptions","default":null},"definitions":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/AgentAnswerDefinition"}},{"type":"null"}],"title":"Definitions","default":null},"methodology":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/AgentAnswerMethodologyNote"}},{"type":"null"}],"title":"Methodology","default":null}},"description":"Supplementary answer metadata. All fields are optional — population\nvaries by effort and engine (low fills citations only today). Tako adds\nnew components here additively."},{"type":"null"}],"default":null},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","default":null},"web_results":{"type":"array","items":{"type":"object","title":"CitedWebResult","required":["title","url"],"properties":{"url":{"type":"string","title":"Url","description":"URL of the web page."},"title":{"type":"string","title":"Title","description":"Title of the web page."},"content":{"anyOf":[{"$ref":"#/components/schemas/ResultContent"},{"type":"null"}],"default":null,"description":"Downloadable content descriptor for this result, fetched via the Contents endpoint. Web results are always downloadable as text. None for callers that do not populate it."},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet","default":null,"description":"Excerpt(s) from the page that matched the query."},"source_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Name","default":null,"description":"Publisher or domain name, when Tako can extract it from the URL."},"publish_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publish Date","default":null,"description":"Publication date of the page, when available."},"citation_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Citation Number","default":null}},"description":"A web result that backs an inline [N] marker in agent prose.\n\ncitation_number is the 1-based index the answer's [N] markers reference.\nNone means card-backed: the source backs a chart or card and carries no\ninline marker. Numbers are contiguous over the cited subset, so a None\nrow doesn't consume an index. Published verbatim on /openapi.json — keep\nthis public-facing."},"title":"Web Results"},"refusal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refusal Code","default":null,"description":"Set when Tako rejected the query before the agent ran. Null on normal runs. Tako can add new codes, so accept a code you do not recognize. The current code is 'rejected_input_classifier'."}},"description":"Final agent output. answer is markdown prose with [n] citation markers;\ncards reuse the sibling TakoCard; metadata carries the structured\ncomponents behind the answer."},{"type":"null"}],"default":null},"run_id":{"type":"string","title":"Run Id"},"status":{"enum":["queued","running","completed","failed"],"type":"string","title":"AgentRunStatus"},"request":{"anyOf":[{"type":"object","title":"AgentRunRequest","required":["query"],"properties":{"query":{"type":"string","title":"Query","examples":["Compare Nvidia and AMD headcount since 2013"],"description":"Natural-language request for the agent."},"effort":{"anyOf":[{"enum":["low","medium"],"type":"string","title":"AgentEffortLevel","description":"Effort level for an agent run. `low` returns fast results for simple\nqueries; `medium` runs deeper multi-step analysis and takes longer, and is\nwhat an omitted effort resolves to. Published verbatim on /openapi.json —\nkeep this public-facing."},{"type":"null"}],"default":null,"description":"Agent effort. 'low' returns fast results for simple queries; 'medium' returns deeper analysis across multiple entities and metrics (slower). Omit it and Tako uses medium."},"locale":{"type":"string","title":"Locale","default":"en-US","description":"BCP-47 locale. Drives the language of the agent's answer (a non-English locale makes the agent respond in that language) and the locale used when rendering card preview images. Defaults to en-US."},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","default":null,"description":"IANA timezone (for example, 'America/New_York'). The agent uses it to render dates and times in card preview images. It does not affect the returned data."},"thread_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Thread Id","default":null,"description":"Existing thread to continue (follow-up). Omit to start a new thread."},"source_indexes":{"anyOf":[{"type":"array","items":{"enum":["data","web"],"type":"string"}},{"type":"null"}],"title":"Source Indexes","default":null,"examples":[["data"],["web"],["data","web"]],"description":"Which sources the agent may use: 'data' (curated knowledge), 'web' (open-web search), or both. Omit it on a new thread and the agent uses both; omit it on a follow-up and the run keeps the thread's sources. Tako accepts the legacy value 'tako' as a synonym for 'data'."},"output_settings":{"anyOf":[{"type":"object","title":"AgentOutputSettings","properties":{"image_dark_mode":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Image Dark Mode","default":null,"description":"Render card preview images in dark mode. Omit to use the default (dark)."}}},{"type":"null"}],"default":null,"description":"Settings that control the response and rendering."}},"description":"Request body for POST /api/v1/agent/runs."},{"type":"null"}],"default":null},"thread_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thread Id","default":null},"created_at":{"type":"string","title":"Created At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At","default":null}},"description":"The run resource returned by dispatch (202) and poll (GET)."},"example":null,"exampleRequest":null,"tags":["data","visualization","charts","research","search","answers","agents","reports","datasets","analytics","ai"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"Tako","brandSlug":"tako","brandBaseUrl":"https://tako.com","brandDocsUrl":"https://tako.com","whatItDoes":"Polls the status of an async deep-research agent run previously submitted to Tako","exampleAgentPrompt":"Can you check whether my Tako deep-research agent run has finished yet? The run ID is 'run_abc123xyz'.","exampleUseCases":[{"title":"Polling a deep research report to completion","prompt":"I kicked off a Tako agent run a few minutes ago with run ID 'run_7f3a29d1' — can you keep checking until it's done and tell me the final status and any cost info?"},{"title":"Verifying a failed agent run","prompt":"My Tako research run with ID 'run_err_00821' seems to have stalled — can you poll its status and tell me if there's an error code or message explaining what went wrong?"},{"title":"Confirming job completion before downloading data","prompt":"Before I try to download the results, can you confirm that the Tako agent run 'run_data_445b' has actually completed successfully and show me the usage and cost breakdown?"}],"resultDescription":"Returns an AgentRun object containing the run_id, current status, creation timestamp, and optionally an error object (with code and message if failed), plus a usage breakdown showing inline data cost, compute cost, number of datasets, data points, and total USD cost for the run.","failureModes":["Invalid or unknown run_id returns an error response","Run still in progress returns a pending/running status without final results","Malformed run_id format may cause a validation error","Network timeout if the status endpoint itself is temporarily unavailable","Authentication failure if receipt token is missing or invalid"],"whenToPreferThis":"Use this endpoint after submitting an async agent run via POST /api/mpp/v1/agent/runs to check whether processing has completed. This is a free polling endpoint (receipt-authenticated) specifically designed for tracking Tako deep-research agent jobs — prefer it over any general-purpose status checks when your agent has already received a run_id from Tako's agent runs endpoint.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:32:19.334Z","isFirstParty":false,"canonicalSlug":"tako-agent-run-status-poller-3c31da07"}