{"uid":"cap_vL5IuaJ2uQFB1sQJ_7eKL","slug":"tako-deep-research-agent-run-438303ee","name":"Tako Deep-Research Agent Run","description":"Run a deep-research agent (multi-step research, async)","url":"https://tako.com/api/mpp/v1/agent/runs?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."},"responseSchema":{"type":"object","title":"MppAgentRunDispatchResponse","required":["run_id","status"],"properties":{"run_id":{"type":"string","title":"Run Id"},"status":{"type":"string","title":"Status","description":"Always \"running\" on dispatch; poll /api/mpp/v1/agent/runs/status."}},"description":"202 body of POST /api/mpp/v1/agent/runs.","additionalProperties":false},"example":null,"exampleRequest":null,"tags":["data","visualization","charts","research","search","answers","agents","reports","datasets","analytics","ai"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","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":"static","summary":"$1/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cb1HikyxKmuA5N6PW23qH","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Tako","brandSlug":"tako","brandBaseUrl":"https://tako.com","brandDocsUrl":"https://tako.com","whatItDoes":"Dispatches an async multi-step deep-research agent that searches curated data and/or the web to answer complex analytical queries, returning a run ID to poll for results","exampleAgentPrompt":"Run a deep research on Tako comparing Nvidia and AMD headcount, revenue, and R&D spending from 2013 to today — use medium effort and search both curated data and the web.","exampleUseCases":[{"title":"Competitive headcount and growth analysis","prompt":"Can you run a deep research comparing Nvidia, AMD, and Intel employee headcount and revenue growth since 2015? I want a thorough multi-step analysis using both Tako's curated data and the web."},{"title":"Market share trends report","prompt":"Research the global EV market share breakdown by manufacturer from 2018 through 2024 — use medium effort and pull from both data and web sources so I get a comprehensive cited report."},{"title":"Follow-up thread on prior research","prompt":"Building on the semiconductor analysis we started earlier, can you dig deeper into TSMC's capital expenditure trends versus Samsung over the last decade? Continue that same research thread."}],"resultDescription":"An immediate 202 response containing a run_id (UUID string) and a status field always set to 'running'. The agent must then poll the dedicated status endpoint (/api/mpp/v1/agent/runs/status) using the run_id to retrieve the completed research results, citations, and data once the async multi-step agent finishes.","failureModes":["Missing required 'query' field returns a 422 validation error","Invalid thread_id UUID format causes a 422 error","Invalid source_indexes values (not 'data' or 'web') cause a 422 error","Invalid effort level value (not 'low' or 'medium') causes a 422 error","Payment not provided or insufficient USDC results in a 402 payment required error","Downstream research agent timeout may result in a failed status when polling","Invalid BCP-47 locale string may cause unexpected language behavior"],"whenToPreferThis":"Choose this endpoint when the user's question requires multi-step research across multiple entities, time periods, or metrics — especially when a single search or answer won't suffice. Prefer this over Tako's synchronous Answer or Search endpoints when the query is complex, comparative, or requires synthesizing data from multiple sources. Use the 'low' effort mode for simpler factual questions needing speed, and 'medium' (default) for deep analytical reports. Use thread_id to continue a prior conversation thread with follow-up questions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:46:11.532Z","isFirstParty":false,"canonicalSlug":"tako-deep-research-agent-run-438303ee"}