Skip to main content
POST
/
api
/
v2
/
sessions
/
{id}
/
pause
Pause a session
curl --request POST \
  --url https://agp.eu.hcompany.ai/api/v2/sessions/{id}/pause \
  --header 'Authorization: Bearer <token>'
Pauses a running session. The agent stops processing but its state is fully preserved. You can resume it later to continue from exactly where it left off. Returns 202 Accepted. The pause command is delivered asynchronously.

​
Path parameters

​
id
string
required
The session ID.

​
Examples

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

​
Use cases

  • Review before continuing. Pause the agent to inspect its progress, then resume or redirect with a message.
  • Cost control. Pause long-running sessions during off-hours and resume when needed.
  • Human-in-the-loop. Pause when the agent reaches a decision point, review the options, then resume with guidance.

​
Errors

StatusCause
404Session not found, or you don’t have access.