TAtako

Run the Answer Agent for a cited, multi-step answer (async)

Changed on
post/api/mpp/v1/agent/answer/runs

Request

  • Base URL
    https://tako.com
  • URL
    https://tako.com/api/mpp/v1/agent/answer/runs
  • Auth
    none declared

Request body

querystring required

Natural-language request for the answer agent.

thread_idstring uuid nullable

Existing thread to continue (follow-up). Omit to start a new thread.

effort'medium' | 'high'

Effort levels for the Answer Agent (POST /v1/agent/answer/runs).

'medium' is the default. 'high' uses the same models and the same data. It only makes the model reason more, and it gives the run more time. A 'high' run can give a better answer, and it always takes longer. 'low' is not available. A request that sends 'low' gets a 400 response.

The effort is fixed for the life of a thread. A follow-up that sends a different effort gets a 409 response with the code 'effort_mismatch'. To use a different effort, start a new thread.

source_indexesstring[] nullable

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'.

localestring

BCP-47 locale. Drives the language of the agent's answer and the locale used when rendering card preview images.

timezonestring nullable

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.

Example request

{
  "query": "How have American Airlines' margins held up against fuel shocks?",
  "source_indexes": [
    "data"
  ]
}

Response

Answer Agent run queued — poll /api/mpp/v1/agent/answer/runs/status.

run_idstring required
object'agent.run'
thread_idstring nullable
status'queued' | 'running' | 'completed' | 'failed' required
created_atstring required
completed_atstring nullable

Example response

{
  "result": {
    "cards": [
      {
        "sources": [
          {
            "source_name": "S&P Global",
            "url": "https://xignite.com"
          }
        ],
        "methodologies": [
          {
            "methodology_name": "Where the Data Comes From - S&P Global",
            "methodology_description": "Financial metrics standardized by S&P Global from company regulatory filings, press releases, and restatements."
          }
        ],
        "metric_definitions": [
          {
            "name": "Gross Domestic Product (current US$)"
          }
        ],
        "data_freshness": {
          "coverage_end": "2026",
          "data_as_of": "2026-10-01",
          "last_updated": "2026-07-14"
        }
      }
    ]
  },
  "request": {
    "query": "How have American Airlines' margins held up against fuel shocks?",
    "source_indexes": [
      "data"
    ]
  }
}

Changes

  • b88b0829e406Revision changes
    • info

      added the optional property ////// to the response with the status

  • 169f9f7268d1Revision changes
    • breaking

      response property result/anyOf[subschema #1: AnswerAgentResult]/cards/items/content/anyOf[subschema #1: ResultContent]/dataset/anyOf[subschema #1: TakoDataset]/rows/items/items/ list-of-types was widened by adding types array to media type application/json of response 202

    • breaking

      response property result/anyOf[subschema #1: AnswerAgentResult]/cards/items/content/anyOf[subschema #1: ResultContent]/records/anyOf[subschema #1]/items/additionalProperties/ list-of-types was widened by adding types array to media type application/json of response 202

    • breaking

      response property result/anyOf[subschema #1: AnswerAgentResult]/citations/items/content/anyOf[subschema #1: ResultContent]/dataset/anyOf[subschema #1: TakoDataset]/rows/items/items/ list-of-types was widened by adding types array to media type application/json of response 202

    • breaking

      response property result/anyOf[subschema #1: AnswerAgentResult]/citations/items/content/anyOf[subschema #1: ResultContent]/records/anyOf[subschema #1]/items/additionalProperties/ list-of-types was widened by adding types array to media type application/json of response 202

    • warning

      added the new array enum value to the ////////// response property for the response status

    • warning

      added the new array enum value to the ////////// response property for the response status

    • warning

      added the new array enum value to the ////////// response property for the response status

    • warning

      added the new array enum value to the ////////// response property for the response status