API Documentation

Create an Agent

Create a new AI agent under your team via the API.

Make a POST request to create an agent. The agent will be associated with your team and returned with a unique ID.

Endpoint

POST https://www.chatzuri.com/api/v1/create-agent

Request Headers

Authorization: Bearer <Your-Secret-Key> — Your team API key.
Content-Type: application/json

Request Body

agentName — (string, required) The display name of the agent.
sourceText — (string, optional) Knowledge base text for the agent.

Example Request

const res = await fetch('https://www.chatzuri.com/api/v1/create-agent', {
  method: 'POST',
  headers: {
    Authorization: `Bearer <Your-Secret-Key>`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    agentName: 'Support Agent',
    sourceText: 'We are a software company...'
  })
});

const data = await res.json();
console.log(data); // { agentId: 'agent_abc123' }

Response

{
  "agentId": "agent_abc123"
}

Error Handling

How to handle API errors gracefully

If there are any errors during the API request, appropriate HTTP status codes will be returned along with error messages in the response body.

That's it! You should now be able to create a agent using the create API.

Remember to implement proper error logging and user notifications in your application

400

Bad Request

401

Unauthorized

500

Server Error

Next: Message an Agent