/agents

Retrieve all available Agents

GET /v1 /agents

Query a paginated list of all Zams Agents available to your organization. These agents represent modular, model-backed entities capable of reasoning, tool use, and autonomous task execution — all backed by foundation models and governed by your enterprise context.

Header

Key	Value
Authorization	YOUR_API_KEY

Parameters

Key	Type	Description
page_number	Integer	Default is 1

Request

import requests

url = "https://api.zams.com/v1/agents"

headers = {
    "Authorization": "ApiKey <your_api_key>",
    "Content-Type": "application/json"
}

payload = {
    "page_number": 1
}

response = requests.get(url, headers=headers, json=payload)

print(response.json())

Response

A paginated mapping of agent identifiers to their associated details.

✅ 200 OK

{
    {
        "name": "Support Bot",
        "agent_id": "km0v7j3a",
        "dataspace_id": "txf19l2br",
        "status": "Live",
        "created_by": "Eva Snyder",
        "created_at": "2025-04-02T07:15:45Z"
    },
    {
        "name": "CRM Querying",
        "agent_id": "qz7n1c3vbd",
        "dataspace_id": "e94zvkcq",
        "status": "Not live",
        "created_by": "John Doe",
        "created_at": "2025-04-02T14:30:00Z"
    },
}

❌ 400 ERROR

{
    "error": "Unauthorized"
}