Talkstack
  • System architecture
  • Getting Started With Talkstack's API
  • Authentication
    • Signup
    • Verify Email
    • Resend email verification code
    • Login
    • Refresh Token
    • Change Password
    • Forgot Password
    • Reset Password
  • User
    • Generate API key
    • Set active Project
    • Get active Project
  • Project
    • Creating a new project
    • Get Project
    • Getting list of projects
    • Update a project
    • Delete Project
    • Webhook
    • Get Active Agent
    • Set Active Agent
    • Remove Active Agent
  • Agent
    • Create a new Agent
    • Get Agent Details
    • Update Agent
    • Delete an agent
    • Get All agents
  • Call
    • Make phone call
    • Get call data
    • Get call history
    • Get call analysis
    • Batch calls
  • Voices
    • List Voices
    • Get Voice data
  • Phone Number
    • Get phone number data
    • Assign Number to Agent
  • Hubspot
    • HubSpot Integration
Powered by GitBook
On this page
  1. Agent

Delete an agent

This section provides instructions on using /agent endpoint to delete agent data

Step1: Prepare Your Request

  • Endpoint: /agent

  • Method: DELETE

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

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

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

Step2: Create the Request Body

  • projectId: The id of the project in which the agent exists.

  • agentId: The id of the agent whose details you want to delete.

{
    "projectId": "XXXXXXXXXXXXXXXXXXXXXXXXX",
    "agentId": "ZZZZZZZZZZZZZZZZZZZZZZZZZZZ"
}

Step 3: Send the Request

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

Step 4: Handle the request

The response will show status of the deletion.

Success Response:

  • Status Code: 200 OK

  • Body: The response includes details like name, projectId, systemInstruction, id, and phoneNumber.

{
    "message": "Agent Deleted",
    "status": "success"
}

Troubleshooting

  • 400 Bad Request: If the projectId or agentId is missing in the request.

  • 404 Not Found: If the agent is not found.

  • 500 Internal Server Error: For errors in updating the agent details.

Last updated 15 hours ago

PreviousUpdate AgentNextGet All agents

Last updated 3 months ago