elmo
Sign up

Delete a prompt

DELETE
/prompts/{promptId}

Permanently delete a prompt and cancel all related scheduled jobs. This will also cascade delete all associated prompt runs.

Requires an instance admin key; organization keys receive 403. The dashboard has no delete either — stop tracking a prompt with PATCH /prompts/{promptId} and enabled: false, which keeps its history and frees the plan slot.

Authorization

BearerAuth
headerAuthorizationBearer <token>

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

Path Parameters

promptId*string

The ID of the prompt to delete

Formatuuid

Response Body

Prompt deleted (returns the deleted prompt)

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.

deletedRunsCount*integer

Number of related prompt_runs rows deleted by the cascade.

Example Request
curl -X DELETE 'https://app.elmohq.com/api/v1/prompts/497f6eca-6276-4993-bfeb-53cbbbba6f08'
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"
  ],
  "deletedRunsCount": 0
}