GET /v1/conversations
List the key's conversations
Key-scoped, live conversations only (deleted conversations are invisible), most-recently-active first. Pagination never errors: limit defaults to 25, non-positive becomes 25, above 100 clamps to 100; total is the unpaginated count.
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| limit | integer | no | Query — Page size; never an error (§4.5 limit law). |
| offset | integer | no | Query |
Request
No request body.
Responses
200 The list envelope.
| Field | Type | Required | Description |
|---|---|---|---|
| object | string enum | no | — |
| data | array of object | no | — |
| total | integer | no | Unpaginated live count for this key. |
| limit | integer | no | — |
| offset | integer | no | — |
401 401
| Field | Type | Required | Description |
|---|---|---|---|
| error | object | yes | — |
Example
curl https://api.ironstratum.com/v1/conversations \
-H "Authorization: Bearer $IRONSTRATUM_API_KEY"