Skip to Content
WalidoDocs
Public APIPrompts

Create a prompt

POST
/prompts

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key in the Authorization: Bearer <key> header. Keys are created in the Walido dashboard (Settings → API Keys).

Request Body

application/json
  1. body
name*string
Length1 <= length <= 200
prompt*string
Length1 <= length <= 100000
description?string
Lengthlength <= 2000
Default""

Response Body

Created.

application/json
  1. 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, with health_score: 0, approved: false and 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.

Example Request
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  }}