elmo
Sign up

List all prompts

GET
/prompts

Retrieve a paginated list of all prompts across all brands

Authorization

BearerAuth
headerAuthorizationBearer <token>

An instance admin key from ADMIN_API_KEYS, or an organization key (elmo_…) issued from the dashboard.

Query Parameters

brandId?string

Filter prompts by brand ID

page?integer

Page number, 1-based.

Range1 <= value
Default1
limit?integer

Items per page. Values above the maximum are clamped, not rejected. This list had no ceiling before, so the maximum is set to bound a runaway query rather than to change what an existing caller gets back.

Range1 <= value <= 1000
Default20
enabled?boolean

Only prompts with this tracking state.

tags?string

Comma-separated tags. A prompt matches if it carries any of them.

q?string

Case-insensitive substring match on prompt text.

Response Body

List of prompts

application/json
  1. response
data*array<>

The items on this page. Read this rather than the named key below.

prompts*array<>Deprecated

Deprecated: read data instead. Kept while the one known consumer migrates, and removed in a future release.

pagination*
Example Request
curl -X GET 'https://app.elmohq.com/api/v1/prompts'
Example Response
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "brandId": "string",
      "value": "string",
      "enabled": true,
      "tags": [
        "string"
      ],
      "systemTags": [
        "string"
      ],
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "premiumModels": [
        "string"
      ]
    }
  ],
  "prompts": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "brandId": "string",
      "value": "string",
      "enabled": true,
      "tags": [
        "string"
      ],
      "systemTags": [
        "string"
      ],
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "premiumModels": [
        "string"
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "limit": 0,
    "total": 0,
    "totalPages": 0
  }
}