PATCH
Update agent session

Authorizations

Authorization
string
header
required

An opaque BMA personal or organization bearer token.

Path Parameters

orgID
string
required

Organization ID (org_...).

Pattern: ^org_[a-z2-7]{26}$
projectID
string
required

Project ID (proj_...).

Pattern: ^proj_[a-z2-7]{26}$
agentID
string
required

Agent ID (agt_...).

Pattern: ^agt_[a-z2-7]{26}$
sessionID
string
required

Agent session ID (ses_...).

Pattern: ^ses_[a-z2-7]{26}$

Body

application/json
agent_config_id
string
Pattern: ^acfg_[a-z2-7]{26}$
environment_id
string<uuid> | null
metadata
object
expected_updated_at
string<date-time>

Optimistic version check. The update applies only while the session's updated_at still equals this value; otherwise it answers 409 conflict. Anything that writes the session (an update, the automatic title) moves updated_at.

Response

Agent session updated.

session
object
required