Tako agent API
The agent API from Tako — 4 operation(s) for agent.
Tako agent API is one of 2 APIs that Tako publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include agent. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.
This API exposes 6 operations across 4 paths, and defines 59 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.
Requests are made against a single base URL, https://tako.com/api/.
6 operations
4 paths
59 schemas
4 GET2 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Tako agent API declares
1 security scheme
for authenticating requests.
An API key is passed in the header as X-API-Key (apiKey).
Paths & Operations 6
Across 4 paths, the API surfaces 6 operations — 4 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.
agent 6
GET
/v1/agent/answer/runs
List answer agent runs
POST
/v1/agent/answer/runs
Dispatch an answer agent run
GET
/v1/agent/answer/runs/{run_id}
Poll an answer agent run
GET
/v1/agent/retrieval/runs
List retrieval agent runs
POST
/v1/agent/retrieval/runs
Dispatch a retrieval agent run
GET
/v1/agent/retrieval/runs/{run_id}
Poll a retrieval agent run
Schemas 59
The contract defines 59 schemas that model the data the API accepts and returns. The most detailed are TakoCard (17 properties), ResultContent (10 properties), RetrievalAgentRun (10 properties), AnswerAgentRun (10 properties). Each schema is shown below with its type and property counts.
TextEvent
object
4 properties
2 required
KnowledgeCardMethodology
object
2 properties
2 required
ContentsFormat
string
Serialization of tabular (Tako card) data. Web content is always raw text and carries no content format (contentformat is null).
RetrievalAgentResult
object
Final retrieval-agent output. answer is markdown prose with [n] citation markers. cards reuse the sibling TakoCard. citations is the unified top-level registry…
10 properties
RetrievalAgentRun
object
The retrieval-agent run resource returned by dispatch (202) and poll (GET).
10 properties
3 required
AgentAnswerDefinition
object
3 properties
2 required
AgentAnswerMetadata
object
Supplementary answer metadata. All fields are optional — population varies by effort and engine (low fills citations only today). Tako adds new components here…
4 properties
ExportPricing
object
Card-CSV export pricing RATE, published so a caller can compute an export's cost before fetching. Full charge = baselineusd + rowcpmusd max(0, rows - freerows)…
4 properties
4 required
AgentRunStatus
string
HeartbeatEvent
object
1 property
SubagentEvent
object
5 properties
3 required
TakoDatasetColumn
object
Typed header entry; type is the JSON-facing column type.
2 properties
2 required
GraphNodeType
string
AgentOutputSettings
object
1 property
AnswerAgentEffort
string
Effort taxonomy for the Answer Agent (POST /v1/agent/answer/runs). The Answer Agent shares the effort vocabulary with the Retrieval Agent, but only 'medium' is…
RetrievalAgentRunSummary
object
7 properties
3 required
ToolCallEvent
object
6 properties
2 required
UsageData
object
The cost and quantity of inline data delivered in the response: the agent per-dataset surcharge, the search and answer includecontents charge, or the contents…
2 properties
2 required
TakoCardSource
object
A source that backs a TakoCard on the SDK surfaces. It uses the {data, web} TakoSourceIndex taxonomy.
5 properties
1 required
Usage
object
Usage for one metered request. totalcostusd is always present (the total quoted charge). compute and data are the additive breakdown; each appears only where i…
3 properties
1 required
UsageCompute
object
The cost of running the operation. Absent on surfaces with no compute step (contents).
1 property
1 required
ReasoningEvent
object
4 properties
2 required
TakoDatasetColumnType
string
Logical column type declared in a TakoDataset header. Temporal cells are ISO-8601 strings. Each column declares 'date' or 'datetime' on its own: a temporal col…
ToolRetryEvent
object
6 properties
3 required
StreamResetEvent
object
1 property
AnswerAgentRunRequest
object
Request body for POST /v1/agent/answer/runs. Frozen contract: no outputschema, no structured outputs, and no inline data — ever. Cards are the only data-export…
7 properties
1 required
RetrievalAgentRunRequest
object
Request body for POST /v1/agent/retrieval/runs.
9 properties
1 required
TakoDatasetSource
object
Per-dataset provenance entry. index names the source index, not a citation display number. It is "data" for every dataset today — web content never fills a dat…
2 properties
1 required
AnswerAgentRunList
object
List envelope for GET /v1/agent/answer/runs. The shape follows the OpenAI and Exa list convention.
4 properties
1 required
ErrorObject
object
2 properties
2 required
AnswerAgentResultEvent
object
3 properties
2 required
RetrievalAgentRunList
object
List envelope for GET /v1/agent/retrieval/runs. The shape follows the OpenAI and Exa list convention.
4 properties
1 required
AnswerAgentRunSummary
object
7 properties
3 required
TakoDataset
object
The dataset-slot envelope: exact retrieved rows as positional arrays in columns order. The rows come directly from the data source; the LLM never transcribes t…
7 properties
6 required
StructuredOutputStatus
string
Terminal status of the structured-output channel.
ToolErrorEvent
object
5 properties
3 required
AnswerAgentRun
object
The answer-agent run resource returned by dispatch (202) and poll (GET).
10 properties
3 required
AgentAnswerAssumption
object
4 properties
2 required
TakoSourceIndex
string
Public source taxonomy for the SDK card surfaces (v3 search, v1 answer, agent). It is symmetric with the request taxonomy {data, web}.
AnswerAgentResult
object
Final answer-agent output. answer is markdown prose with [n] citation markers. citations is the unified top-level registry that the [n] markers join. cards reu…
5 properties
RunSummaryEvent
object
Terminal run metadata. The stream emits it once, immediately before streamdone. It mirrors the GET-poll run fields that the stream otherwise lacks; the result…
6 properties
2 required
TakoCard
object
A Tako knowledge card on the search and answer surfaces. It carries a content download descriptor.
17 properties
DataFreshness
object
When the card's data was last observed and last refreshed. Either field may be null when that date isn't available for the card type.
2 properties
RetrievalAgentEffort
string
Effort taxonomy for the Retrieval Agent (POST /v1/agent/retrieval/runs). Only 'medium' is available today. effort stays a request field for forward compatibili…
ResultContent
object
Describes the downloadable content behind a result. Pricing: for a Tako card CSV export, the charge is a flat per-export baseline plus a per-source, per-row CP…
10 properties
DataPipelineAnswerEvent
object
Signals that the data pipeline produced one or more charts for the answer. It carries only chart references. The answer text streams in text events, and the st…
3 properties
1 required
StreamCategory
string
AgentAnswerMethodologyNote
object
2 properties
2 required
MetricDefinition
object
Definition of a metric shown on a card. Sourced from the metric's ValueType definition — the same text as the in-app methodology 'Metrics' tab.
2 properties
2 required
RetrievalAgentStreamEnvelope
object
Public SSE envelope for the Retrieval Agent run stream. It has the same wire shape as AgentStreamEnvelope. The only difference is that the terminal agentresult…
5 properties
4 required
AnswerAgentMetadata
object
Answer-agent metadata. Citations live in the top-level citations registry, so this carries only definitions, assumptions, and methodology. Distinct from the sh…
3 properties
KnowledgeCardRelevance
string
AgentAnswerCitation
object
One indexed source behind the answer. Every inline [n] marker in the answer joins to a citation's index. A citation can also back the answer without a survivin…
8 properties
2 required
TakoCardNode
object
Slim graph node for the search and answer card surface (TakoCard.nodes). It is deliberately narrower than GraphNode: it carries no aliases and no subtype. Call…
4 properties
3 required
AnswerAgentStreamEnvelope
object
Public SSE envelope for the Answer Agent run stream. Identical wire shape to AgentStreamEnvelope; the only difference is the terminal agentresult block carries…
5 properties
4 required
RetrievalAgentResultEvent
object
3 properties
2 required
StreamDoneEvent
object
1 property
StatusEvent
object
3 properties
1 required
ToolResultEvent
object
6 properties
2 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Tako 1
Other APIs Tako publishes across the network.
Tako tako API
#agent