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 Agents. 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.2.0, at version 1.0.0.
Requests are made against a single base URL, https://tako.com/api/.
The identity and technical contract details declared by the specification.
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
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…
AgentAnswerAssumption
object
4 properties
2 required
ToolResultEvent
object
6 properties
2 required
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…
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
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
RetrievalAgentRun
object
The retrieval-agent run resource returned by dispatch (202) and poll (GET).
10 properties
3 required
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
ToolRetryEvent
object
6 properties
3 required
AgentAnswerDefinition
object
3 properties
2 required
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
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
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
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
StreamDoneEvent
object
1 property
SubagentEvent
object
5 properties
3 required
TakoCard
object
A Tako knowledge card on the search and answer surfaces. It carries a content download descriptor.
17 properties
AnswerAgentRun
object
The answer-agent run resource returned by dispatch (202) and poll (GET).
10 properties
3 required
AnswerAgentResultEvent
object
3 properties
2 required
RetrievalAgentResultEvent
object
3 properties
2 required
TakoDatasetColumn
object
Typed header entry; type is the JSON-facing column type.
2 properties
2 required
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…
StatusEvent
object
3 properties
1 required
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
StructuredOutputStatus
string
Terminal status of the structured-output channel.
KnowledgeCardMethodology
object
2 properties
2 required
ToolCallEvent
object
6 properties
2 required
HeartbeatEvent
object
1 property
TextEvent
object
4 properties
2 required
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
RetrievalAgentRunSummary
object
7 properties
3 required
RetrievalAgentRunRequest
object
Request body for POST /v1/agent/retrieval/runs.
9 properties
1 required
ContentsFormat
string
Serialization of tabular (Tako card) data. Web content is always raw text and carries no content format (contentformat is null).
RetrievalAgentRunList
object
List envelope for GET /v1/agent/retrieval/runs. The shape follows the OpenAI and Exa list convention.
4 properties
1 required
ToolErrorEvent
object
5 properties
3 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
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
AnswerAgentRunSummary
object
7 properties
3 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
StreamResetEvent
object
1 property
AgentOutputSettings
object
1 property
KnowledgeCardRelevance
string
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
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
ErrorObject
object
2 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}.
AgentAnswerMethodologyNote
object
2 properties
2 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
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
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
UsageCompute
object
The cost of running the operation. Absent on surfaces with no compute step (contents).
1 property
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
ReasoningEvent
object
4 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
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
The full machine-readable OpenAPI contract behind this narrative.
Other APIs Tako publishes across the network.
