Skip to main content
GET /v1/instances Returns all non-deleted instances belonging to the authenticated user, ordered by creation date (newest first).

Request

Headers

HeaderValue
AuthorizationBearer <token>

Response 200

Returns an array of instance objects.
FieldTypeDescription
idstringUnique instance ID
namestringInstance label
statusstringCREATED, CONFIGURED, or ACTIVE
metadataobjectInstance metadata
created_atstringISO 8601 timestamp
updated_atstringISO 8601 timestamp
[
  {
    "id": "inst_abc123",
    "name": "sales-team-a",
    "status": "ACTIVE",
    "metadata": {},
    "created_at": "2026-03-01T10:00:00Z",
    "updated_at": "2026-03-01T10:05:00Z"
  },
  {
    "id": "inst_def456",
    "name": "support-line",
    "status": "CONFIGURED",
    "metadata": {},
    "created_at": "2026-02-15T08:00:00Z",
    "updated_at": "2026-02-15T08:10:00Z"
  }
]
Deleted instances (status DELETED) are excluded from this list.

Errors

CodeDescription
401Missing or invalid token

Example

curl https://cawme.com/api/v1/instances \
  -H "Authorization: Bearer <token>"