Stop an Agent session

Stop a running agent session and clean up its resources.

DELETE /agents/{agentName}/sessions/{sessionId}

Stop an agent session

cURL

curl --request DELETE \
  --url https://api.pipecat.daily.co/v1/agents/{agentName}/sessions/{sessionId} \
  --header 'Authorization: Bearer <token>'

200

{
  "status": "terminated",
  "session_id": "639f91d8-d511-4677-a83b-bd7564d5d92f"
}

Authorizations

Authorization · string · header · required

Authentication requires a Pipecat Cloud Private API token.

Generate a Private API key from your Dashboard (Settings > API Keys > Private > Create key) and include it as a Bearer token in the Authorization header.

Path Parameters

agentName · string · required

Name of the agent

sessionId · string<uuid> · required

UUID of the session to stop

Response

200

application/json

Session stopped successfully

status · string

Status of the stop operation

Example:

"terminated"

session_id · string<uuid>

Session ID of the stopped session

Example:

"639f91d8-d511-4677-a83b-bd7564d5d92f"