v51

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014102371.0 MB

Gets a list of AI prompt proposals.

Retrieves a paginated list of AI prompt proposal records for the authenticated customer.

get/aipromptproposals

Query parameters

page_sizeinteger

Example:25

Number of results to return per page.

page_tokenstring

Cursor token for pagination. Use the next_page_token value from the previous response.

ai_idstring uuid

Filter by AI ID.

statusstring

Filter by proposal status (progressing, completed, failed, accepted, rejected, expired).

Response

A list of AI prompt proposals.

next_page_tokenstring

Cursor token for the next page of results. Pass this value as the page_token parameter in the next request.

Example response

{
  "result": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
      "ai_id": "550e8400-e29b-41d4-a716-446655440000",
      "audit_ids": [
        "550e8400-e29b-41d4-a716-446655440001",
        "550e8400-e29b-41d4-a716-446655440002"
      ],
      "basis_prompt_history_id": "550e8400-e29b-41d4-a716-446655440000",
      "original_prompt": "You are a helpful support assistant.",
      "proposed_prompt": "You are a helpful and empathetic support assistant. Always confirm the customer's issue before proposing a fix.",
      "rationale": "The audits showed the assistant moved to solutions before fully acknowledging the customer's concern.",
      "status": "progressing",
      "error": "evaluator_unavailable",
      "applied_prompt_history_id": "550e8400-e29b-41d4-a716-446655440000",
      "tm_create": "2026-01-15T09:30:00.000000Z",
      "tm_update": "2026-01-15T09:30:00.000000Z",
      "tm_delete": "2026-01-15T09:30:00.000000Z"
    }
  ]
}