elmo
Sign up

Create a new prompt

POST
/prompts

Create a new prompt for a brand. This will automatically schedule the prompt for execution.

Authorization

BearerAuth
headerAuthorizationBearer <token>

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

Request Body

application/json
  1. body
brandId*string

Brand identifier this prompt belongs to

value*string

The prompt text

Length1 <= length
tags?array<string>

User-defined tags for categorizing this prompt

Response Body

Prompt created successfully

application/json
  1. response
id*string

Unique identifier for the prompt

Formatuuid
brandId*string

Brand identifier this prompt belongs to

value*string

The actual prompt text

enabled*boolean

Whether the prompt is currently enabled

tags*array<string>

User-defined tags for categorizing this prompt

systemTags*array<string>

Auto-computed system tags (e.g., 'branded', 'unbranded'). Read-only.

createdAt*string

Timestamp when the prompt was created

Formatdate-time
updatedAt*string

Timestamp when the prompt was last updated

Formatdate-time
premiumModels*array<string>

Models this prompt is tracked on grounded. Each entry spends one premium pairing.

Example Request
curl -X POST 'https://app.elmohq.com/api/v1/prompts' \
  -H 'Content-Type: application/json' \
  -d '{
  "brandId": "string",
  "value": "string"
}'
Example Response
{
  "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"
  ]
}