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.

The name of the agent to create a session for.

The API version to use for this operation.

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

Version indicator determining which agent version backs the session.

Version indicator that references a specific agent version by name.

Discriminator value for version_ref.

The agent version identifier returned by the agent version APIs.

The session identifier.

Version indicator determining which agent version backs the session.

Version indicator that references a specific agent version by name.

Discriminator value for version_ref.

The agent version identifier returned by the agent version APIs.

The status of an agent session.

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

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

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

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.

The public explanation for this block.

The public continuation instruction.

The public explanation for this block.

The public continuation instruction.