Boltly Boltly / Docs
Docs / API Reference / Quick Replies

Quick Replies

Manage saved replies your agents insert with short codes to answer common questions faster.

POST /v1/quick-replies

Create quick reply

Create a saved reply that agents can insert with a short code.

Parameters

short_code string required

The shortcut agents type to insert this reply (e.g. greeting).

content string required

The full message text inserted when the short code is used.

Request

cURL
curl -X POST https://api.boltly.online/v1/quick-replies \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "short_code": "greeting",
    "content": "Hi! Thanks for reaching out. How can we help you today?"
  }'

Response

JSON
{
  "data": {
    "id": "3c4d5e6f-...",
    "organization_id": "b7a1d2c3-...",
    "short_code": "greeting",
    "content": "Hi! Thanks for reaching out. How can we help you today?",
    "created_by": "4d5e6f7a-...",
    "created_at": "2026-04-03T12:00:00Z",
    "updated_at": "2026-04-03T12:00:00Z"
  }
}

GET /v1/quick-replies

List quick replies

List all quick replies for your organization, optionally filtered by search term.

Parameters

search string

Filter quick replies whose short code or content matches this term.

Request

cURL
curl https://api.boltly.online/v1/quick-replies?search=greet \
  -H "X-API-Key: $API_KEY"

Response

JSON
{
  "data": [
    {
      "id": "3c4d5e6f-...",
      "organization_id": "b7a1d2c3-...",
      "short_code": "greeting",
      "content": "Hi! Thanks for reaching out. How can we help you today?",
      "created_by": "4d5e6f7a-...",
      "created_at": "2026-04-03T12:00:00Z",
      "updated_at": "2026-04-03T12:00:00Z"
    }
  ],
  "meta": { "total": 1 }
}

PUT /v1/quick-replies/{id}

Update quick reply

Update the short code or content of an existing quick reply.

Parameters

id string required

Quick reply ID.

short_code string

New shortcut for this reply.

content string

New message text for this reply.

Request

cURL
curl -X PUT https://api.boltly.online/v1/quick-replies/3c4d5e6f-... \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello! How can we help you today?"
  }'

Response

JSON
{
  "data": {
    "id": "3c4d5e6f-...",
    "organization_id": "b7a1d2c3-...",
    "short_code": "greeting",
    "content": "Hello! How can we help you today?",
    "created_by": "4d5e6f7a-...",
    "created_at": "2026-04-03T12:00:00Z",
    "updated_at": "2026-04-03T12:30:00Z"
  }
}

DELETE /v1/quick-replies/{id}

Delete quick reply

Permanently delete a quick reply.

Parameters

id string required

Quick reply ID.

Request

cURL
curl -X DELETE https://api.boltly.online/v1/quick-replies/3c4d5e6f-... \
  -H "X-API-Key: $API_KEY"

Response

JSON
{
  "data": {
    "deleted": true
  }
}