# changes.actors

> List the identities that collaboration clients declared for this document. Identities and claims are declared by each client and are not verified by SuperDoc.



- Member path: `await doc.changes.actors(…)`
- Mutates document: no
- Idempotency: `idempotent`
- Supports tracked mode: no
- Supports dry run: no

## Expected result

Returns a ChangesActorsResult with one item per declared client binding: client id, actor id, optional name, email and claim, session id and declaration time.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {},
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {},
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "clientId": {
            "type": "integer",
            "minimum": 0
          },
          "actorId": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "declaredAt": {
            "type": "string"
          },
          "claim": {
            "type": "string"
          }
        },
        "additionalProperties": false,
        "required": [
          "clientId",
          "actorId",
          "sessionId",
          "declaredAt"
        ]
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "items"
  ]
}
```

## Pre-apply throws

- `CAPABILITY_UNAVAILABLE`

## Non-applied receipt codes

- None