Claude Platform Docs

To enable the Compliance API, see the setup guide.

Set up the Compliance API

원격 세션 목록 조회

GET/v1/compliance/apps/sessions/remote

키가 읽을 수 있는 조직 전체의 원격 세션(Anthropic 관리 클라우드 환경에서 실행되는 Cowork 세션)을 나열합니다.

각 항목은 세션 메타데이터만 포함합니다. 세션의 대화 기록은 메시지 엔드포인트에서 조회하세요. 기본적으로 목록은 해당하는 모든 조직을 포함합니다. 범위를 좁히려면 최대 500개의 organization_ids[] 값을 전달하세요. 특정 사용자로 목록 범위를 지정하려면 1~10개의 user_ids[] 값을 전달하세요. 이 필터는 세션의 소유 사용자와 일치하므로, 설정된 경우 에이전트 소유 세션은 제외됩니다. created_at 범위 매개변수(created_at.gte, created_at.gt, created_at.lt, created_at.lte; RFC 3339)로 결과를 시간 범위로 제한하세요. updated_at 필터는 없습니다.

결과는 created_at 기준 최신순으로 정렬되며, 페이지당 최대 limit개의 세션이 반환됩니다(기본값 100, 최대 500). 페이지네이션은 정방향 전용입니다. 다음 페이지를 조회하려면 응답의 next_page 값을 page로 다시 전달하고, next_page가 null이면 중단하세요.

Query parameters
created_at: optional object{ gt, gte, lt, lte }
gt: optional string

Filter remote sessions created after this time (RFC 3339 format)

formatdate-time
gte: optional string

Filter remote sessions created at or after this time (RFC 3339 format)

formatdate-time
lt: optional string

Filter remote sessions created before this time (RFC 3339 format)

formatdate-time
lte: optional string

Filter remote sessions created at or before this time (RFC 3339 format)

formatdate-time
limit: optional number

Maximum results (default: 100, max: 500)

default100
maximum500
minimum1
organization_ids: optional array of string

Filter to specific child organization identifiers. Omit to enumerate every child organization the key may read.

maxItems500
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.

user_ids: optional array of string

Filter to sessions owned by specific users (max 10 per request). Agent-owned sessions are excluded when this filter is set.

maxItems10
Headers
"x-api-key": optional string
Returns
data: array of object{ id, agent_id, claude_project_id, 7 more }
id: string

Remote session identifier

agent_id: string or null

Identifier of the automated agent that owns the session. Null for user-owned sessions. At most one of user and agent_id is set.

claude_project_id: string or null

ID of the project the session is bound to. Null when the session has no project binding.

created_at: string

When the session was created (RFC 3339, UTC)

formatdate-time
organization_uuid: string

UUID of the organization the session belongs to

product_surface: string or null

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

A user associated with a remote session.

id: string

User identifier

email_address: string or null

User's email address. Null when the user is no longer a member of an organization the key may read — id remains set so attribution is preserved. The messages endpoint does not resolve email addresses; this field is always null there.

status: string

Session lifecycle state. One of active, paused, archived, or failed — the lifecycle states the owning product surface exposes — plus pending, a brief transient state that resolves before any transcript content exists. The list endpoint includes pending; the messages endpoint returns 404 for it. Deleted sessions are not returned on either endpoint. Treat unrecognized values as an unknown state rather than an error.

updated_at: string

When the session was last modified (RFC 3339, UTC)

formatdate-time
user: object{ id, email_address } or null

A user associated with a remote session.

id: string

User identifier

email_address: string or null

User's email address. Null when the user is no longer a member of an organization the key may read — id remains set so attribution is preserved. The messages endpoint does not resolve email addresses; this field is always null there.

next_page: string or null

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.

원격 세션 목록 조회
cURL
curl https://api.anthropic.com/v1/compliance/apps/sessions/remote \
    -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"
Returns Examples
Response 200
{
  "data": [
    {
      "id": "cse_01A0000000000000000000000",
      "organization_uuid": "00000000-0000-0000-0000-000000000000",
      "user": {
        "id": "user_01A0000000000000000000000",
        "email_address": "user@example.com"
      },
      "status": "active",
      "created_at": "2026-01-02T03:04:05.000000Z",
      "updated_at": "2026-01-02T03:04:05.000000Z",
      "product_surface": "cowork_remote",
      "claude_project_id": "claude_proj_01Nm7PqRsTuVwXyZaBcDeFgH"
    }
  ],
  "next_page": "page_AAE..."
}