# The Response object

A stored Genie One response.

## Attributes

- `id` (string, Beta, Output only)
  The opaque response identifier.
- `object` (string, Beta, Output only)
  Always `response`.
- `model` (string, Beta, Output only)
  The server-managed model profile, `genie-one`.
- `status` (string, Beta, Output only)
  One of `in_progress`, `completed`, `failed`, or `incomplete`.
- `output` (array of object, Beta, Output only)
  The public assistant messages produced by this response, in output order.
  - `type` (string, Beta, Output only)
    The item discriminator, `message`.
  - `id` (string, Beta, Output only)
    The opaque item identifier. Clients must not parse or derive identifiers from it.
  - `role` (string, Beta, Output only)
    Always `assistant`. To retrieve user messages, list the conversation items.
  - `content` (array of object, Beta, Output only)
    The ordered text parts of the message.
    - `type` (string, Beta, Output only)
      Always `output_text`.
    - `text` (string, Beta, Output only)
      The text of this content part. Output text may contain Markdown, including result tables.
    - `annotations` (array of object, Beta, Output only)
      Public source references used by the assistant text. The array can be empty.
      - `type` (string, Beta, Output only)
        The citation discriminator, `asset`.
      - `title` (string, Beta, Output only)
        The customer-visible source title.
      - `asset_type` (string, Beta, Output only)
        The kind of cited source, such as `TABLE`, `NOTEBOOK`, or `WEB`.
      - `identifier` (string, Beta, Output only)
        The public asset identifier, volume path, or source web URL.
      - `index` (int32, Beta, Output only)
        The one-based citation number. It is neither a character offset nor an
        index into `annotations`. Numbers remain stable if unsupported citations
        are omitted.
  - `status` (string, Beta, Output only)
    The lifecycle status of this message, when available.
  - `phase` (string, Beta, Output only)
    The assistant message phase: `commentary` or `final_answer`.
  - `create_time` (string, Beta, Output only)
    The message creation time as an RFC 3339 timestamp, when available.
  - `complete_time` (string, Beta, Output only)
    The message completion time as an RFC 3339 timestamp, when available.
- `conversation_id` (string, Beta, Output only)
  The conversation that contains the response.
- `create_time` (string, Beta, Output only)
  The response creation time as an RFC 3339 timestamp, when available.
- `error` (object, Beta, Output only)
  Sanitized failure information on a failed response, when available.
  - `type` (string, Beta, Output only)
    The stable public error category.
  - `message` (string, Beta, Output only)
    A sanitized customer-facing description.
  - `code` (string, Beta, Output only)
    The stable Genie One error code, such as `internal_error`, when available.
  - `retryable` (boolean, Beta, Output only)
    Whether retrying the failed response may succeed.
- `previous_response_id` (string, Beta, Output only)
  The preceding response in the conversation, when this response has a parent.

## Example

```json
{
  "id": "9f7c84c6d3af4ae8ac5cc43590a15366",
  "object": "response",
  "model": "genie-one",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "id": "2b6aa43956be4fe89ff68ccb565a214d",
      "role": "assistant",
      "status": "completed",
      "phase": "final_answer",
      "create_time": "2026-10-19T10:01:01Z",
      "complete_time": "2026-10-19T10:01:06Z",
      "content": [
        {
          "type": "output_text",
          "text": "Revenue increased 12% last quarter.",
          "annotations": []
        }
      ]
    }
  ],
  "conversation_id": "6a34b9a50cb4435da7c463130c9d42c1",
  "create_time": "2026-10-19T10:01:00Z"
}
```