List lifecycle-managed resources for a session.

GET

/v1/sessions/{session_id}/resources

• Production API

Responses

200

Session leased resources

Array<object>

A lifecycle-managed external resource owned by a session-capable workflow.

object

cleanup_attempts

required

Number of cleanup attempts so far.

integer format: int32

cleanup_completed_at

Cleanup completion time for released resources.

string | null format: date-time

cleanup_started_at

Cleanup attempt start time when the resource is currently claimed.

string | null format: date-time

created_at

required

string format: date-time

display_name

Optional user-facing label.

string | null

external_id

required

Stable provider identifier for cleanup calls.

string

id

required

Unique identifier (format: resource_{32-hex}).

string

Example

resource_01933b5a00007000800000000000001

last_cleanup_error

Last cleanup error message, if any.

string | null

last_touched_at

required

Last successful touch from tool activity.

string format: date-time

lease_duration_seconds

required

Lease duration used when refreshing the lease.

integer format: int32

lease_expires_at

required

Absolute deadline after which cleanup becomes due.

string format: date-time

metadata

Provider-specific non-secret metadata for UI/debugging. THREAT[TM-API-015]: This field is returned by the session resources API and rendered in the UI, so providers must never persist bearer tokens or other secrets here.

owner_user_id

User connection owner used for provider cleanup, if known.

string | null format: uuid

provider

required

External provider responsible for the resource (e.g. “daytona”).

string

resource_type

required

Provider-specific resource type (e.g. “sandbox”, “browser_session”).

string

session_id

Session that currently owns the resource, if still attached.

string | null

Example

session_01933b5a00007000800000000000001

status

required

Current lifecycle status.

string

Allowed values: active cleaning released cleanup_failed

updated_at

required

string format: date-time

404

Session not found