Create a new Agent

This section provides instructions for using the /agent/create-agent endpoint to create a new agent.

Step 1: Prepare Your Request

  • Endpoint: /agent/create-agent

  • Method: POST

  • URL: https://api.talkstackai.com/agent/create-agent

  • Headers: Include Content-Type: application/json.

  • Authorization: Bearer token or x-api-key in headers

Step 2: Create the Request Body

  • name: name of the AI Agent to be created.

  • systemInstruction: instructions to the bot. The AI Agent will use these instructions for calling. For Example: "You are an agent called John. You can take any question related to Chemistry."

  • projectId: the id of the project for which the agent is to be created.

  • phoneNumber: phone number to be given to the AI Agent. The AI Agent will use this phone number to make calls.

  • voice_id: It is the id of the voice with which agent speaks.

{
    "name": "Jack",
    "systemInstruction": "You are an agent called John. You can take any questions related to Mathematics.",
    "projectId": "XXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "voice_id": "xxxxxxxxxxxxxxxxxxxxxxxx"
}

Step 3: Send the Request

Use your preferred HTTP client to send the POST request with the JSON body.

Step 4: Handle the Response

The response will provide detailed information about the new agent created.

Troubleshooting

  • 400 Bad Request: If the projectId, name, systemInstruction, or phoneNumber is missing in the request.

  • 500 Internal Server Error: For errors in creating a new agent.

Last updated 15 hours ago

Last updated