SMAO API Documentation
Public APIPrompts

List prompts (paginated)

GET
/prompts
AuthorizationBearer <token>

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

In: header

Query Parameters

cursor?string

Opaque cursor from a prior meta.next_cursor. Base64url-encoded (unpadded) — do not parse or construct it manually.

Match^[A-Za-z0-9_-]+$
limit?integer

Items per page (1–100, default 50).

Default50
Range1 <= value <= 100

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.smao.ai/api/v1/prompts"
{
  "data": [
    {
      "id": "65f8fa6f1a9d8e0012ab34cd",
      "name": "Sales — Initial Outreach",
      "description": "Opening prompt for cold outbound calls.",
      "prompt": "string",
      "type": "answering",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "health_score": 8,
      "approved": true,
      "feedback": "The prompt follows the template exactly and is production-ready. No changes required.",
      "rated_at": "2019-08-24T14:15:22Z",
      "rating_status": "rated"
    }
  ],
  "meta": {
    "has_more": true,
    "next_cursor": "string"
  }
}
{
  "error": {
    "code": "validation_failed",
    "message": "Validation failed"
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Missing API key"
  }
}
{
  "error": {
    "code": "subscription_required",
    "message": "This feature is not available in your current subscription. Please upgrade to a higher plan"
  }
}
{
  "error": {
    "code": "forbidden",
    "message": "No permission"
  }
}
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded"
  }
}
{
  "error": {
    "code": "internal_error",
    "message": "An unexpected error occurred."
  }
}