Skip to content
Last updated

🔨 In Development — This section is still being developed and may change.
Add a new preset prompt to an assistant for quick-start conversations.
POSThttps://api.freddy.aitronos.com/v1/assistants/{assistant_id}/preset-prompts

Path Parameters

assistant_id string required

The unique identifier of the assistant to add the preset prompt to.

Request Body

name string required

Display name of the preset prompt (1-255 characters).

value string required

The full prompt text inserted into the conversation (minimum 1 character).

icon_id string optional

Identifier of a predefined icon from the icons catalog. List icons →

— or —

icon object optional

Custom icon metadata used when icon_id is not provided.

Show properties

id string · Stable icon identifier

url string · Absolute URL of the icon asset (SVG/PNG)

alt string · Accessible description for the icon

order_index integer optional · Defaults to 0

Zero-based position for ordering.

Bash
curl https://api.freddy.aitronos.com/v1/assistants/ass_0c23daea5e34/preset-prompts \
  -X POST \
  -H "Authorization: Bearer $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome Message",
    "value": "Hello! How can I help you today?",
    "icon_id": "icon_welcome",
    "order_index": 0
  }'

Response

Returns

A Preset Prompt object.

{
  "preset_prompt_id": 1,
  "preset_prompt_name": "Welcome Message",
  "preset_prompt_value": "Hello! How can I help you today?",
  "preset_prompt_icon": {
    "id": "icon_welcome",
    "url": "https://cdn.aitronos.com/icons/icon-welcome.svg",
    "alt": "Speech bubble icon"
  },
  "order_index": 0,
  "is_active": true,
  "created_at": "2025-01-20T10:30:00Z",
  "updated_at": "2025-01-20T10:30:00Z"
}