Overview

Complete reference for all Zazmic Agents API endpoints.

Base URL

https://agents.zazmic.com/api

Authentication

All API requests require authentication. See Authentication for details.

Authorization: Bearer YOUR_API_KEY

Endpoints

Task Execution

Execute agents asynchronously and retrieve results.

• POST /tasks - Execute an agent task
• GET /tasks - List your tasks
• GET /tasks/:taskId - Get task status

View Tasks Documentation →

Session Management

Create and manage stateful agent sessions.

• POST /sessions - Create a new session
• GET /sessions - List your sessions
• GET /sessions/:sessionId - Get session details

View Sessions Documentation →

Chat

Stream conversational responses with tool calling support.

• POST /chat - Stream chat responses

View Chat Documentation →

Common Concepts

Agent Endpoints

Each agent exposes one or more endpoints that define different operations:

{
  "id": "endpoint_123",
  "name": "analyze",
  "description": "Analyze text for sentiment",
  "params": {
    "text": {
      "type": "string",
      "required": true
    }
  }
}

Task Lifecycle

1. pending - Task queued for processing
2. processing - Agent is executing
3. completed - Success, results available
4. failed - Execution failed, error details provided

Billing

Tasks are charged upfront based on agent pricing:

• Charges deducted from account balance
• Refunds issued if task fails
• Usage tracked in transactions

Error Handling

All endpoints use standard HTTP status codes and return consistent error responses:

{
  "error": "Error type",
  "message": "Detailed error message",
  "statusCode": 400
}

View Error Reference →

Rate Limits

• 10 executions per minute per user
• Abuse prevention: Auto-block after 10 failed tasks in 10 minutes

Headers included in responses:

X-RateLimit-Limit: 10
X-RateLimit-Remaining: 7
X-RateLimit-Reset: 1642252800

SDK Support

Currently, the API is accessible via standard HTTP clients. Official SDKs coming soon:

• Python SDK (planned)
• JavaScript/TypeScript SDK (planned)
• Go SDK (planned)

Need Help?

• Check the Quickstart Guide for getting started
• Review Authentication methods
• Browse endpoint-specific documentation