PromptsList a prompt's AI answers

List a prompt's AI answers

Returns the AI answers collected for one prompt, one page at a time.

Required scope: v2:prompts.

  • text is the answer as Opttab stored it.
  • Only answers from the last year are returned.
  • A malformed id, or a prompt in another workspace, returns 404 PROMPT_NOT_FOUND.
curl -X GET "https://api.opttab.com/v1/external/prompts/33333333-3333-4333-8333-333333333333/responses?page=1&pageSize=20" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "items": [
    {
      "id": "44444444-4444-4444-8444-444444444444",
      "platform": "chatgpt",
      "generatedAt": "2026-10-18T12:00:00.000Z",
      "text": "A daily trainer with a soft midsole is the usual answer."
    }
  ],
  "page": 1,
  "pageSize": 20,
  "totalCount": 1
}
GET
/v1/external/prompts/{promptId}/responses
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

An API key secret from Settings › API. It starts with opt_live_. Send it as Authorization: Bearer opt_live_xxxxxxxx. A session cookie, an X-API-Key header and an ?api_key= query parameter do not authenticate.

An API key secret from Settings › API. It starts with opt_live_. Send it as Authorization: Bearer opt_live_xxxxxxxx. A session cookie, an X-API-Key header and an ?api_key= query parameter do not authenticate.
path
promptIdstring
Required

The prompt's id, from GET /v1/external/prompts.

Format: uuid
query
pageinteger

The page to return, starting at 1.

Min: 1
query
pageSizeinteger

Items per page. Maximum 100.

Min: 1 • Max: 100
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. An API key secret from Settings › API. It starts with opt_live_. Send it as Authorization: Bearer opt_live_xxxxxxxx. A session cookie, an X-API-Key header and an ?api_key= query parameter do not authenticate.

Path Parameters

promptIdstring
Required

The prompt's id, from GET /v1/external/prompts.

Example:
33333333-3333-4333-8333-333333333333

Query Parameters

pageinteger

The page to return, starting at 1.

Example:
1
pageSizeinteger

Items per page. Maximum 100.

Example:
20

Responses

itemsarray
Required
pageinteger
Required

The page returned.

pageSizeinteger
Required

Items per page.

totalCountinteger
Required

Total items across all pages.