Agent Sessions

Create a session

POST /agents/{agent_name}/endpoint/sessions

Creates a new session for an agent endpoint. The endpoint resolves the backing agent version from version_indicator and enforces session ownership using the provided user identity for session-mutating operations.

Elérési útvonal paraméterei

agent_name string kötelező

The name of the agent to create a session for.

Paraméterek lekérdezése

api-version string kötelező

The API version to use for this operation.

Kérelem törzse

Content-Type: application/json

agent_session_id string

Optional caller-provided session ID. If specified, it must be unique within the agent endpoint. Auto-generated if omitted.

version_indicator version_ref kötelező

Version indicator determining which agent version backs the session.

Az alábbiak valamelyikének telepítve kell lennie:

version_ref VersionRefIndicator

Version indicator that references a specific agent version by name.

type enum kötelező

Discriminator value for version_ref.

version_ref

agent_version string kötelező

The agent version identifier returned by the agent version APIs.

Válaszok

The request has succeeded and a new resource has been created as a result.

Törzs

Content-Type: application/json

agent_session_id string kötelező

The session identifier.

version_indicator version_ref kötelező

Version indicator determining which agent version backs the session.

Az alábbiak valamelyikének telepítve kell lennie:

version_ref VersionRefIndicator

Version indicator that references a specific agent version by name.

type enum kötelező

Discriminator value for version_ref.

version_ref

agent_version string kötelező

The agent version identifier returned by the agent version APIs.

status string | enum kötelező

The status of an agent session.

A következők bármelyike:

string

enum

creatingactiveidleupdatingfaileddeletingdeletedexpired

created_at integer kötelező

The Unix timestamp (in seconds) when the session was created.

last_accessed_at integer kötelező

The Unix timestamp (in seconds) when the session was last accessed.

expires_at integer kötelező

The Unix timestamp (in seconds) when the session expires (rolling, 30 days from last activity).

stopped_at integer

The Unix timestamp (in seconds) when the session sandbox was last observed to stop or go idle. Present only after the session has gone idle at least once, used for accurate idle-billing reconciliation.