Public APIPrompts
Create a prompt
POST
bearerAuthheader
AuthorizationBearer <token>API key in the Authorization: Bearer <key> header.
Keys are created in the Walido dashboard (Settings → API Keys).
application/json- body
name*stringLength
1 <= length <= 200prompt*stringLength
1 <= length <= 100000description?stringLength
length <= 2000Default
""Created.
application/json- response
data?A reusable assistant prompt. When automated prompt rating is enabled,
every save is rated.
The rating fields (health_score, approved, feedback, rated_at,
rating_status) are read-only - create/update requests reject them -
and follow one of these rating_status lifecycles:
- Blocking defect:
null→"rated"immediately, withhealth_score: 0,approved: falseand feedback. - Otherwise:
null→"pending"→"rated"or"failed".
When changed prompt content enters "pending", stale rating fields are
cleared instead of being shown for the new content. On "failed", all
rating fields except rating_status are cleared - the next save
enqueues a fresh attempt. When rating is disabled,
rating_status, health_score, approved, and rated_at remain
null, and feedback remains an empty string.
curl -X POST 'https://api.walido.it/api/v1/prompts' \ -H 'Content-Type: application/json' \ -d '{ "name": "Reception", "prompt": "Answer customer questions clearly and concisely."}'Example Response
{ "data": { "id": "string", "name": "string", "description": "string", "prompt": "string", "type": "answering", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "health_score": 0, "approved": true, "feedback": "string", "rated_at": "2019-08-24T14:15:22Z", "rating_status": null }}