---
title: "Ask a question about a space"
method: POST
path: "/spaces/{id}/ask"
---

# Ask a question about a space

`POST /spaces/{id}/ask`

## Request

- Base URL: `https://api.spacecontext.app/v1`
- URL: `https://api.spacecontext.app/v1/spaces/{id}/ask`
- Auth: HTTP bearer

Answers from the records of the current document this key may read, in one to three sentences, with the records it relies on and their evidence images. Says so when the answer is not documented, and never reveals a redacted value. Test keys get the best-matching record of the demo, without a model. A key without `spaces:sensitive` gets 409 `ENRICHMENT_PENDING` until the space is screened. Limits: 20 a minute and, by default, 200 a day per account.

## Path parameters

- `id` string, required

## Request body

- object
  - `question` string, required

## Response `200`

Answer

- SpaceAnswer
  - `object` 'answer', required
  - `space_id` string, required
  - `scan_id` string, required
  - `question` string, required
  - `answer` string, required
  - `documented` boolean, required
  - `citations` object[], required
    - `record_type` 'area' | 'item' | 'issue' | 'key_location' | 'instruction' | 'fact' | 'qa', required
    - `record_id` string, required
    - `title` string, required
    - `area` string, nullable, required
    - `evidence` object[], required
      - `frame_id` string, required
      - `timestamp_ms` integer, nullable, required
      - `url` string, nullable, required

## Other responses

- `400`: Error response
- `401`: Error response
- `403`: Error response
- `404`: Error response
- `409`: Error response
- `429`: Too many requests. Retry after the number of seconds in `Retry-After`.

---

[API](https://skmtc.dev/spacecontext/apis/space-context-api.md) · [All operations](https://skmtc.dev/spacecontext/apis/space-context-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spacecontext/apis/space-context-api/revisions/1dca940259b4?raw)