Samva
DashboardAPI
ChannelsPlatformMailboxesDevelopersEmail templatesIntegrationsAPI Reference
Agents

List agents (Preview)

Preview · Available to selected organizations. Returns the agents the caller can reach, newest first, without their drafts. Pass nextCursor back as cursor for the next page.

GET
/v1/agents

Returns the agents the caller can reach, newest first, without their drafts. Pass nextCursor back as cursor for the next page.

Authorization

apiKey
x-api-key<token>

In: header

Query Parameters

limit?string|null
cursor?Cursor|null

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/agents"
{  "items": [    {      "id": "string",      "name": "string",      "namespaceId": "string",      "publishedVersion": -9007199254740991,      "publishedAt": "string",      "createdAt": "string",      "updatedAt": "string"    }  ],  "nextCursor": "string"}

Related documentation

Get a published agent version (Preview)

Preview · Available to selected organizations. Returns the immutable definition of one published version. Use this endpoint to get a published agent version through the Samva email API.

List published agent versions (Preview)

Preview · Available to selected organizations. Returns an agent's published versions, newest first, without their definitions. Pass nextCursor back as cursor for the next page.