---
title: "Poll for AI response"
method: GET
path: "/threads/{thread-id}/messages/{message-id}/response"
tags: ["Threads"]
---

# Poll for AI response

`GET /threads/{thread-id}/messages/{message-id}/response`

## Request

- Base URL: `https://api.korey.ai/api/v1`
- URL: `https://api.korey.ai/api/v1/threads/{thread-id}/messages/{message-id}/response`
- Auth: HTTP bearer

Polls for the AI response to a user message.

Returns `202 Accepted` while the thread is in `waiting` or `active` state.
Returns `200 OK` once the thread returns to `ready` and the full response is
available. Returns `404` if no response exists for the message.

Prefer the SSE stream endpoint for lower latency.

## Path parameters

- `thread-id` string, uuid, required
- `message-id` string, uuid, required

## Response `200`

Success

- object
  - `status` 'complete', required
  - `messages` object[], required
    - `id` string, required: Unique message ID.
    - `thread_id` string, required: ID of the thread this message belongs to.
    - `role` 'user' | 'assistant' | 'summary', required: Who sent the message.
    - `contents` union[], required: Ordered list of content blocks that make up the message.
      - union
        - object
          - `type` 'text', required
          - `text` string, required
        - object
          - `type` 'image', required
          - `attachment_id` string, required
        - object
          - `type` 'document', required
          - `attachment_id` string, required
        - object
          - `type` 'user_get_choice', required
          - `tool_use_id` string, required
          - `question` string, required
          - `choices` string[], required
    - `created_at` string, required: ISO 8601 timestamp when the message was created.
    - `app_url` string, required: Direct link to this message in the Korey web app.

## Other responses

- `202`: Accepted
- `401`: Unauthorized — Bearer token required or invalid
- `403`: Forbidden — token does not have required scope
- `404`: Not found

---

[API](https://skmtc.dev/korey/apis/korey-api.md) · [All operations](https://skmtc.dev/korey/apis/korey-api/llms.txt) · [OpenAPI document](https://skmtc.dev/korey/apis/korey-api/revisions/94087c83439c?raw)