alpha

Get turn events

Get where one Alpha answer stands, by its turn id (the turnId alpha_conversations_send returned): whether it is still running, and the index to follow it from. With Accept: text/event-stream (REST) or an MCP progress token, the call follows the answer while it runs: each event names the index it was stored under and carries AI SDK UI message chunks for the answer's message, and the last event carries settled, what the answer became (that question's messages exactly as alpha_conversations_get_v4 returns them), so nothing is read again. A reader that comes back passes startIndex, the index after the last event it drew, and is sent only what follows. An answer that already finished is an opening event and then the settled one. An API key follows only answers in conversations it started.

get/api/v1/alpha/turn-events/{id}

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/alpha/turn-events/{id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Path parameters

idstring uuid required

Alpha turn ID

Query parameters

startIndexinteger

Following again: the index after the last event this reader drew (the previous nextIndex); events before it are not sent again. Omit to follow from the turn's first event

Headers

Point11-Organizationstring uuid

Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.

Response

Success. With Accept: text/event-stream, the live events as server-sent events: one progress event per live event, then exactly one result (the output) or error (OperationError). A refusal before the first event is the ordinary JSON error.

turnIdstring uuid required
conversationIdstring uuid required
status'running' | 'succeeded' | 'failed' | 'cancelled' required

What the turn is now: running while it still works (a follow that ended early is followed again from nextIndex), else what it became

nextIndexinteger required

The startIndex to follow from next: the index after the last event sent

Changes

No recorded changes to this operation across all 1 revision of this API.