Get a Context Graph ask

GET

/context-graph/asks/:askId

GET

/context-graph/asks/:askId

curl https://api.postman.com/context-graph/asks/01a03dd2-114a-766f-820b-4209e4fc78d2 \
     -H "x-api-key: <apiKey>"

{
  "askId": "01a03dd2-114a-766f-820b-4209e4fc78d2",
  "status": "completed",
  "question": "What endpoints does authentication-service expose?",
  "revision": 1,
  "createdAt": "2026-08-26T11:26:12.000Z",
  "completedAt": "2026-08-26T11:26:28.000Z",
  "result": {
    "provenance": {
      "revision": 1,
      "steps": [
        {
          "tool": "run_typed_query",
          "type": "api-detail"
        },
        {
          "tool": "run_cypher",
          "rowCount": 31
        }
      ]
    },
    "citations": [
      {
        "api_name": "authentication-service"
      },
      {
        "path": "/api/auth/logout"
      }
    ],
    "usage": {
      "steps": 2,
      "outputTokens": 707
    },
    "answer": "The authentication-service exposes 31 endpoints, organized into health checks, public auth, handover and token exchange, certificate management, and internal auth-scheme management.",
    "structured": {
      "entities": [
        {
          "name": "authentication-service",
          "type": "api"
        }
      ]
    }
  }
}

Gets a submitted ask’s status and, once the ask completes, its result.

Poll this endpoint after submitting an ask. The status property is pending or running while the ask is in progress, and completed or failed once it reaches a terminal state. The result property is only present once status is completed.

Gets a submitted ask's status and, once the ask completes, its result. Poll this endpoint after submitting an ask. The `status` property is `pending` or `running` while the ask is in progress, and `completed` or `failed` once it reaches a terminal state. The `result` property is only present once `status` is `completed`.

Authentication

x-api-keystring

API Key authentication via header

Path parameters

askIdstringRequired

The ask's ID.

Response

Successful Response

askIdstring

The ask's ID.

statusenum

The ask's lifecycle state.

questionstring

The natural-language question that was asked.

revisioninteger or null

The graph revision the ask was evaluated against.

createdAtdatetime

The date and time the ask was submitted, in ISO 8601 format.

completedAtdatetime or nullOptional

The date and time the ask reached a terminal state, in ISO 8601 format. This value is null until the ask is completed or failed.

errorstring or nullOptional

A short reason the ask failed, such as the ask having timed out. This property is only present if status is failed.

resultobjectOptional

The ask’s result. This property is only present if status is completed.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error