Cancel a session

DELETE

api

sessions

{id}

holo sessions cancel "$SESSION_ID" --yes

from hai_agents import Client

client = Client()

client.sessions.cancel_session(session_id)

import { HaiAgentsClient } from "hai-agents";

const client = new HaiAgentsClient();

await client.sessions.cancelSession({ id: sessionId });

curl -X DELETE https://agp.eu.hcompany.ai/api/v2/sessions/$SESSION_ID \
  -H "Authorization: Bearer $HAI_API_KEY"

Behavior

A queued session is dequeued before it starts. On a finished session, the call is a harmless no-op. A message restarts a cancelled session.

Action	Effect	Can resume?	Frees quota?
Cancel (`DELETE`)	Stops the agent, terminal state	With a message	Yes
Pause (`POST /pause`)	Halts the agent, preserves state	Yes	No

string

required

The session ID to cancel.

204 No Content.

holo sessions cancel "$SESSION_ID" --yes

from hai_agents import Client

client = Client()

client.sessions.cancel_session(session_id)

import { HaiAgentsClient } from "hai-agents";

const client = new HaiAgentsClient();

await client.sessions.cancelSession({ id: sessionId });

curl -X DELETE https://agp.eu.hcompany.ai/api/v2/sessions/$SESSION_ID \
  -H "Authorization: Bearer $HAI_API_KEY"

Status	Cause
`404`	Not found, or not in your organization.

holo sessions cancel "$SESSION_ID" --yes

from hai_agents import Client

client = Client()

client.sessions.cancel_session(session_id)

import { HaiAgentsClient } from "hai-agents";

const client = new HaiAgentsClient();

await client.sessions.cancelSession({ id: sessionId });

curl -X DELETE https://agp.eu.hcompany.ai/api/v2/sessions/$SESSION_ID \
  -H "Authorization: Bearer $HAI_API_KEY"