TAtako

Poll status for an Answer Agent run (free, receipt-authenticated)

Changed on
get/api/mpp/v1/agent/answer/runs/status

Request

  • Base URL
    https://tako.com
  • URL
    https://tako.com/api/mpp/v1/agent/answer/runs/status
  • Auth
    API key in header Authorization

Query parameters

run_idstring required

The run_id returned by POST /api/mpp/v1/agent/answer/runs.

Response

Current run status, including the cited answer once complete.

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 200

    • 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 200

    • 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 200

    • 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 200

    • 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