List remote sessions
api/compliance/apps/sessions/remote/list
Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
api/compliance/apps/sessions/remote/list Changed · +30 / -17 lines
# List remote sessions ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List remote sessions ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
---- -title: List remote sessions -url: https://platform.claude.com/docs/en/api/compliance/apps/sessions/remote/list ---- +# List remote sessions -## List remote sessions +**GET** `/v1/compliance/apps/sessions/remote` -**get** `/v1/compliance/apps/sessions/remote` - List remote sessions (Cowork sessions that run in Anthropic-managed cloud environments) across the organizations the key may read.
forward-only: pass the response's `next_page` value back as `page` to retrieve the next page, and stop when `next_page` is null. -### Query Parameters +## Query parameters -- `created_at: optional object { gt, gte, lt, lte }` +- `created_at: optional object` - `gt: optional string` Filter remote sessions created after this time (RFC 3339 format) + format: date-time + - `gte: optional string` Filter remote sessions created at or after this time (RFC 3339 format) + format: date-time + - `lt: optional string` Filter remote sessions created before this time (RFC 3339 format) + format: date-time + - `lte: optional string` Filter remote sessions created at or before this time (RFC 3339 format) + format: date-time + - `limit: optional number` Maximum results (default: 100, max: 500) + default: 100, maximum: 500, minimum: 1 + - `organization_ids: optional array of string` Filter to specific child organization identifiers. Omit to enumerate every child organization the key may read. + maxItems: 500 + - `page: optional string` Opaque pagination token from a previous response's `next_page` field. Pass this to retrieve the next page of results. Clients should treat this value as an opaque string and not attempt to parse or interpret its contents, as the format may change without notice.
Filter to sessions owned by specific users (max 10 per request). Agent-owned sessions are excluded when this filter is set. -### Header Parameters + maxItems: 10 +## Headers + - `"x-api-key": optional string` -### Returns +## Returns -- `data: array of object { id, agent_id, claude_project_id, 7 more }` +- `data: array of object` - `id: string`
When the session was created (RFC 3339, UTC) + format: date-time + - `organization_uuid: string` UUID of the organization the session belongs to
The Claude product the session was created from. Currently `cowork_remote`, for Cowork sessions started on claude.ai web or mobile. More values will appear as other surfaces launch, so treat any unrecognized value as an unclassified surface rather than an error. Null for sessions created before this field was recorded, for surfaces that do not stamp it, and for unrecognized tag values. - - `started_by_user: object { id, email_address } or null` + - `started_by_user: object or null` A user associated with a remote session.
When the session was last modified (RFC 3339, UTC) - - `user: object { id, email_address } or null` + format: date-time + - `user: object or null` + A user associated with a remote session. - `id: string`
Opaque page token; pass as `page` to retrieve the next page. Null when no rows exist after this page. Treat this value as opaque; do not parse or store it long-term, as the format may change without notice. -### Example +## Example -```http +```bash curl https://api.anthropic.com/v1/compliance/apps/sessions/remote \ -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY" ``` -#### Response +### Response (200) ```json {