# Session configuration

## Endpoints

- `GET /platform/session-configuration`: [Get session configuration defaults](https://docs.polymorfa.com/api/session-configuration/get-session-configuration-defaults)
- `PUT /platform/session-configuration`: [Update session configuration defaults](https://docs.polymorfa.com/api/session-configuration/update-session-configuration-defaults)

## The session configuration object

### Attributes

- `requestedHistory` (object, required). Structured requested history values for this management session configuration view.
  - `mode` (string, required). Operating mode selected for this feature. Values: `metadata_only`, `deliver`.
  - `requestFull` (boolean, required). Whether request full.
  - `delivery` (string). Polymorfa-Version 2026-10-14 and later; omitted for earlier versions. `descriptor` is direct history; `archive` is the earlier downloaded-archive delivery. Values: `archive`, `descriptor`.
- `historyConsent` (string). Specifies history consent for this management session configuration view. Values: `pending`, `accepted`, `declined`.
- `effective` (object, required). Structured effective values for this management session configuration view.
  - `observation` (object, required). Structured observation values for this effective.
    - `presenceMode` (string, required). Behavior selected for presence. Values: `off`, `events`, `cache`.
    - `typingMode` (string, required). Behavior selected for typing. Values: `off`, `events`, `cache`.
    - `labelMode` (string, required). Behavior selected for label. Values: `off`, `events`, `cache`, `project`.
    - `quickReplyMode` (string, required). Behavior selected for quick reply. Values: `off`, `events`, `cache`.
  - `historySync` (object, required). History synchronization behavior for newly connected sessions.
    - `mode` (string, required). Operating mode selected for this feature. Values: `metadata_only`, `deliver`.
    - `requestFull` (boolean, required). Whether request full.
    - `delivery` (string). Polymorfa-Version 2026-10-14 and later; omitted for earlier versions. `descriptor` is direct history; `archive` is the earlier downloaded-archive delivery. Values: `archive`, `descriptor`.
  - `hms` (object, required). Specifies hms for this effective.
    - One of:
      - `false` (object).
        - `enabled` (boolean, required). Whether this feature is enabled. Values: `false`.
      - `true` (object).
        - `enabled` (boolean, required). Whether this feature is enabled. Values: `true`.
        - `region` (string, required, pattern ^[a-z0-9][a-z0-9-]{0,31}$). Specifies region for this any of.
        - `policy` (string, required). Specifies policy for this any of. Values: `short`, `standard`, `extended`, `compliance`, `enterprise_archive`.
        - `retentionDays` (integer, range 1–2555). Specifies retention days for this any of.
        - `policyVersion` (string, length 1–128). Specifies policy version for this any of.
        - `legalHold` (boolean). Whether legal hold.
- `overrides` (object, required). Structured overrides values for this management session configuration view.
  - `historySync` (object). History synchronization behavior for newly connected sessions.
    - `mode` (string). Operating mode selected for this feature. Values: `metadata_only`, `deliver`.
    - `requestFull` (boolean). Whether request full.
    - `delivery` (string). Polymorfa-Version 2026-10-14 and later. `descriptor` makes history.sync carry the chunk descriptor or inline payload; Polymorfa never downloads the chunk. Reset it to inherit the project or team delivery setting. Without an inherited choice, delivery is archive. Existing Numbers require confirmed cleanup before switching to descriptor delivery. Values: `descriptor`.
  - `hms` (object). Specifies hms for this override.
    - One of:
      - `false` (object).
        - `enabled` (boolean, required). Whether this feature is enabled. Values: `false`.
      - `true` (object).
        - `enabled` (boolean, required). Whether this feature is enabled. Values: `true`.
        - `region` (string, required, pattern ^[a-z0-9][a-z0-9-]{0,31}$). Specifies region for this any of.
        - `policy` (string, required). Specifies policy for this any of. Values: `short`, `standard`, `extended`, `compliance`, `enterprise_archive`.
        - `retentionDays` (integer, range 1–2555). Specifies retention days for this any of.
        - `policyVersion` (string, length 1–128). Specifies policy version for this any of.
        - `legalHold` (boolean). Whether legal hold.
  - `observation` (object). Structured observation values for this override.
    - `presenceMode` (string). Behavior selected for presence. Values: `off`, `events`, `cache`.
    - `typingMode` (string). Behavior selected for typing. Values: `off`, `events`, `cache`.
    - `labelMode` (string). Behavior selected for label. Values: `off`, `events`, `cache`, `project`.
    - `quickReplyMode` (string). Behavior selected for quick reply. Values: `off`, `events`, `cache`.
- `sources` (object, required). Structured sources values for this management session configuration view.
  - `observation.presenceMode` (string, required). Behavior selected for observation.presence. Values: `platform`, `team`, `project`, `session`.
  - `observation.typingMode` (string, required). Behavior selected for observation.typing. Values: `platform`, `team`, `project`, `session`.
  - `observation.labelMode` (string, required). Behavior selected for observation.label. Values: `platform`, `team`, `project`, `session`.
  - `observation.quickReplyMode` (string, required). Behavior selected for observation.quick reply. Values: `platform`, `team`, `project`, `session`.
  - `historySync.mode` (string, required). Behavior selected for history sync.mode. Values: `platform`, `team`, `project`, `session`, `consent`.
  - `historySync.requestFull` (string, required). Specifies history sync.request full for this source. Values: `platform`, `team`, `project`, `session`, `consent`.
  - `historySync.delivery` (string). Specifies history sync.delivery for this source. Values: `platform`, `team`, `project`, `session`.
  - `hms` (string, required). Specifies hms for this source. Values: `platform`, `team`, `project`, `session`.
- `revisions` (object, required). Structured revisions values for this management session configuration view.
  - `team` (integer, required, min 0). Specifies team for this revision.
  - `project` (integer, required, min 0). Specifies project for this revision.
  - `session` (integer, required, min 0). Identifier of the connected Polymorfa session.
- `application` (object). Structured application values for this management session configuration view.
  - `desiredGeneration` (integer, required, min 0). Specifies desired generation for this application.
  - `appliedGeneration` (integer, required, min 0). Specifies applied generation for this application.
  - `status` (string, required). Current status of this resource or operation. Values: `pending`, `applied`.
```json
{
  "requestedHistory": {
    "mode": "metadata_only",
    "requestFull": true,
    "delivery": "archive"
  },
  "historyConsent": "pending",
  "effective": {
    "observation": {
      "presenceMode": "off",
      "typingMode": "off",
      "labelMode": "off",
      "quickReplyMode": "off"
    },
    "historySync": {
      "mode": "metadata_only",
      "requestFull": true,
      "delivery": "archive"
    },
    "hms": {
      "enabled": false
    }
  },
  "overrides": {
    "historySync": {
      "mode": "metadata_only",
      "requestFull": true,
      "delivery": "descriptor"
    },
    "hms": {
      "enabled": false
    },
    "observation": {
      "presenceMode": "off",
      "typingMode": "off",
      "labelMode": "off",
      "quickReplyMode": "off"
    }
  },
  "sources": {
    "observation.presenceMode": "platform",
    "observation.typingMode": "platform",
    "observation.labelMode": "platform",
    "observation.quickReplyMode": "platform",
    "historySync.mode": "platform",
    "historySync.requestFull": "platform",
    "historySync.delivery": "platform",
    "hms": "platform"
  },
  "revisions": {
    "team": 0,
    "project": 0,
    "session": 0
  },
  "application": {
    "desiredGeneration": 0,
    "appliedGeneration": 0,
    "status": "pending"
  }
}
```

## Get session configuration defaults

`GET https://api.polymorfa.com/platform/session-configuration` (Platform API)

Required permission: `sessions:read`

Returns effective team or project defaults, explicit overrides, and their source.

Requires `sessions:read`. Project tokens only access resources in their own project.

### Query parameters

- `projectId` (string). Identifier of the Polymorfa project that owns this resource.

### Request

```bash
curl "https://api.polymorfa.com/platform/session-configuration" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22"
```

### Responses

#### 200

Success
- `data` (object, required). Structured data carried by this object.
  - `requestedHistory` (object, required). Structured requested history values for this management session configuration view.
    - `mode` (string, required). Operating mode selected for this feature. Values: `metadata_only`, `deliver`.
    - `requestFull` (boolean, required). Whether request full.
    - `delivery` (string). Polymorfa-Version 2026-10-14 and later; omitted for earlier versions. `descriptor` is direct history; `archive` is the earlier downloaded-archive delivery. Values: `archive`, `descriptor`.
  - `historyConsent` (string). Specifies history consent for this management session configuration view. Values: `pending`, `accepted`, `declined`.
  - `effective` (object, required). Structured effective values for this management session configuration view.
    - `observation` (object, required). Structured observation values for this effective.
      - `presenceMode` (string, required). Behavior selected for presence. Values: `off`, `events`, `cache`.
      - `typingMode` (string, required). Behavior selected for typing. Values: `off`, `events`, `cache`.
      - `labelMode` (string, required). Behavior selected for label. Values: `off`, `events`, `cache`, `project`.
      - `quickReplyMode` (string, required). Behavior selected for quick reply. Values: `off`, `events`, `cache`.
    - `historySync` (object, required). History synchronization behavior for newly connected sessions.
      - `mode` (string, required). Operating mode selected for this feature. Values: `metadata_only`, `deliver`.
      - `requestFull` (boolean, required). Whether request full.
      - `delivery` (string). Polymorfa-Version 2026-10-14 and later; omitted for earlier versions. `descriptor` is direct history; `archive` is the earlier downloaded-archive delivery. Values: `archive`, `descriptor`.
    - `hms` (object, required). Specifies hms for this effective.
      - One of:
        - `false` (object).
          - `enabled` (boolean, required). Whether this feature is enabled. Values: `false`.
        - `true` (object).
          - `enabled` (boolean, required). Whether this feature is enabled. Values: `true`.
          - `region` (string, required, pattern ^[a-z0-9][a-z0-9-]{0,31}$). Specifies region for this any of.
          - `policy` (string, required). Specifies policy for this any of. Values: `short`, `standard`, `extended`, `compliance`, `enterprise_archive`.
          - `retentionDays` (integer, range 1–2555). Specifies retention days for this any of.
          - `policyVersion` (string, length 1–128). Specifies policy version for this any of.
          - `legalHold` (boolean). Whether legal hold.
  - `overrides` (object, required). Structured overrides values for this management session configuration view.
    - `historySync` (object). History synchronization behavior for newly connected sessions.
      - `mode` (string). Operating mode selected for this feature. Values: `metadata_only`, `deliver`.
      - `requestFull` (boolean). Whether request full.
      - `delivery` (string). Polymorfa-Version 2026-10-14 and later. `descriptor` makes history.sync carry the chunk descriptor or inline payload; Polymorfa never downloads the chunk. Reset it to inherit the project or team delivery setting. Without an inherited choice, delivery is archive. Existing Numbers require confirmed cleanup before switching to descriptor delivery. Values: `descriptor`.
    - `hms` (object). Specifies hms for this override.
      - One of:
        - `false` (object).
          - `enabled` (boolean, required). Whether this feature is enabled. Values: `false`.
        - `true` (object).
          - `enabled` (boolean, required). Whether this feature is enabled. Values: `true`.
          - `region` (string, required, pattern ^[a-z0-9][a-z0-9-]{0,31}$). Specifies region for this any of.
          - `policy` (string, required). Specifies policy for this any of. Values: `short`, `standard`, `extended`, `compliance`, `enterprise_archive`.
          - `retentionDays` (integer, range 1–2555). Specifies retention days for this any of.
          - `policyVersion` (string, length 1–128). Specifies policy version for this any of.
          - `legalHold` (boolean). Whether legal hold.
    - `observation` (object). Structured observation values for this override.
      - `presenceMode` (string). Behavior selected for presence. Values: `off`, `events`, `cache`.
      - `typingMode` (string). Behavior selected for typing. Values: `off`, `events`, `cache`.
      - `labelMode` (string). Behavior selected for label. Values: `off`, `events`, `cache`, `project`.
      - `quickReplyMode` (string). Behavior selected for quick reply. Values: `off`, `events`, `cache`.
  - `sources` (object, required). Structured sources values for this management session configuration view.
    - `observation.presenceMode` (string, required). Behavior selected for observation.presence. Values: `platform`, `team`, `project`, `session`.
    - `observation.typingMode` (string, required). Behavior selected for observation.typing. Values: `platform`, `team`, `project`, `session`.
    - `observation.labelMode` (string, required). Behavior selected for observation.label. Values: `platform`, `team`, `project`, `session`.
    - `observation.quickReplyMode` (string, required). Behavior selected for observation.quick reply. Values: `platform`, `team`, `project`, `session`.
    - `historySync.mode` (string, required). Behavior selected for history sync.mode. Values: `platform`, `team`, `project`, `session`, `consent`.
    - `historySync.requestFull` (string, required). Specifies history sync.request full for this source. Values: `platform`, `team`, `project`, `session`, `consent`.
    - `historySync.delivery` (string). Specifies history sync.delivery for this source. Values: `platform`, `team`, `project`, `session`.
    - `hms` (string, required). Specifies hms for this source. Values: `platform`, `team`, `project`, `session`.
  - `revisions` (object, required). Structured revisions values for this management session configuration view.
    - `team` (integer, required, min 0). Specifies team for this revision.
    - `project` (integer, required, min 0). Specifies project for this revision.
    - `session` (integer, required, min 0). Identifier of the connected Polymorfa session.
  - `application` (object). Structured application values for this management session configuration view.
    - `desiredGeneration` (integer, required, min 0). Specifies desired generation for this application.
    - `appliedGeneration` (integer, required, min 0). Specifies applied generation for this application.
    - `status` (string, required). Current status of this resource or operation. Values: `pending`, `applied`.

Headers:

- `X-Request-Id` (string). Stable request correlation identifier.
- `X-Trace-Id` (string, pattern ^[0-9a-f]{32}$). W3C trace ID of this request. Your `traceparent` trace ID when you sent a valid one.
- `Polymorfa-Version` (string). API version applied to this response.

```json
{
  "data": {
    "requestedHistory": {
      "mode": "metadata_only",
      "requestFull": true
    },
    "effective": {
      "observation": {
        "presenceMode": "off",
        "typingMode": "off",
        "labelMode": "off",
        "quickReplyMode": "off"
      },
      "historySync": {
        "mode": "metadata_only",
        "requestFull": true
      },
      "hms": {
        "enabled": false
      }
    },
    "overrides": {
      "historySync": {
        "mode": "metadata_only",
        "requestFull": true,
        "delivery": "descriptor"
      },
      "hms": {
        "enabled": false
      },
      "observation": {
        "presenceMode": "off",
        "typingMode": "off",
        "labelMode": "off",
        "quickReplyMode": "off"
      }
    },
    "sources": {
      "observation.presenceMode": "platform",
      "observation.typingMode": "platform",
      "observation.labelMode": "platform",
      "observation.quickReplyMode": "platform",
      "historySync.mode": "platform",
      "historySync.requestFull": "platform",
      "hms": "platform"
    },
    "revisions": {
      "team": 0,
      "project": 0,
      "session": 0
    }
  }
}
```

#### 401

Missing/invalid credential for this audience.
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable failure code. Use this value for programmatic handling.
  - `message` (string, required). Safe explanation of the failure.
  - `param` (string, required, nullable). Invalid request field, or null when no field applies.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Documentation link to this failure code.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but lacks the required scope/role/audience.
Same fields as 401.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

#### 404

The requested resource was not found inside the authenticated team or project scope.
Same fields as 401.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_not_found",
    "message": "The resource is unavailable to this caller.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#resource-not-found"
}
```

## Update session configuration defaults

`PUT https://api.polymorfa.com/platform/session-configuration` (Platform API)

Required permission: `sessions:manage`

Updates explicit defaults using a revision check. Existing sessions inherit fields they have not overridden. Switching an existing Number to descriptor history delivery requires confirmed cleanup; otherwise the entire update returns 409 and nothing is saved. A reset can inherit descriptor delivery and has the same requirement. Runtime application is asynchronous.

Requires `sessions:manage`. Project tokens only access resources in their own project.

### Body

- `projectId` (string (uuid), format uuid). Identifier of the Polymorfa project that owns this resource.
- `revision` (integer, required, min 0). Specifies revision for this management session configuration update request.
- `configuration` (object, required). Structured configuration values for this management session configuration update request.
  - `set` (object). Structured set values for this configuration.
    - `historySync` (object). History synchronization behavior for newly connected sessions.
      - `mode` (string). Operating mode selected for this feature. Values: `metadata_only`, `deliver`.
      - `requestFull` (boolean). Whether request full.
      - `delivery` (string). Polymorfa-Version 2026-10-14 and later. `descriptor` makes history.sync carry the chunk descriptor or inline payload; Polymorfa never downloads the chunk. Reset it to inherit the project or team delivery setting. Without an inherited choice, delivery is archive. Existing Numbers require confirmed cleanup before switching to descriptor delivery. Values: `descriptor`.
    - `hms` (object). Specifies hms for this set.
      - One of:
        - `false` (object).
          - `enabled` (boolean, required). Whether this feature is enabled. Values: `false`.
        - `true` (object).
          - `enabled` (boolean, required). Whether this feature is enabled. Values: `true`.
          - `region` (string, required, pattern ^[a-z0-9][a-z0-9-]{0,31}$). Specifies region for this any of.
          - `policy` (string, required). Specifies policy for this any of. Values: `short`, `standard`, `extended`, `compliance`, `enterprise_archive`.
          - `retentionDays` (integer, range 1–2555). Specifies retention days for this any of.
          - `policyVersion` (string, length 1–128). Specifies policy version for this any of.
          - `legalHold` (boolean). Whether legal hold.
    - `observation` (object). Structured observation values for this set.
      - `presenceMode` (string). Behavior selected for presence. Values: `off`, `events`, `cache`.
      - `typingMode` (string). Behavior selected for typing. Values: `off`, `events`, `cache`.
      - `labelMode` (string). Behavior selected for label. Values: `off`, `events`, `cache`, `project`.
      - `quickReplyMode` (string). Behavior selected for quick reply. Values: `off`, `events`, `cache`.
  - `reset` (array of string, max items 1000). Reset associated with this configuration. Values: `historySync`, `historySync.mode`, `historySync.requestFull`, `historySync.delivery`, `hms`, `observation`, `observation.presenceMode`, `observation.typingMode`, `observation.labelMode`, `observation.quickReplyMode`.

### Request

```bash
curl -X PUT "https://api.polymorfa.com/platform/session-configuration" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22" \
  -H "Content-Type: application/json" \
  -d '{
  "revision": 0,
  "configuration": {
    "set": {
      "historySync": {
        "mode": "metadata_only",
        "requestFull": true,
        "delivery": "descriptor"
      },
      "hms": {
        "enabled": false
      },
      "observation": {
        "presenceMode": "off",
        "typingMode": "off",
        "labelMode": "off",
        "quickReplyMode": "off"
      }
    },
    "reset": [
      "historySync"
    ]
  }
}'
```

### Responses

#### 200

Success
- `data` (object, required). Structured data carried by this object.
  - `requestedHistory` (object, required). Structured requested history values for this management session configuration view.
    - `mode` (string, required). Operating mode selected for this feature. Values: `metadata_only`, `deliver`.
    - `requestFull` (boolean, required). Whether request full.
    - `delivery` (string). Polymorfa-Version 2026-10-14 and later; omitted for earlier versions. `descriptor` is direct history; `archive` is the earlier downloaded-archive delivery. Values: `archive`, `descriptor`.
  - `historyConsent` (string). Specifies history consent for this management session configuration view. Values: `pending`, `accepted`, `declined`.
  - `effective` (object, required). Structured effective values for this management session configuration view.
    - `observation` (object, required). Structured observation values for this effective.
      - `presenceMode` (string, required). Behavior selected for presence. Values: `off`, `events`, `cache`.
      - `typingMode` (string, required). Behavior selected for typing. Values: `off`, `events`, `cache`.
      - `labelMode` (string, required). Behavior selected for label. Values: `off`, `events`, `cache`, `project`.
      - `quickReplyMode` (string, required). Behavior selected for quick reply. Values: `off`, `events`, `cache`.
    - `historySync` (object, required). History synchronization behavior for newly connected sessions.
      - `mode` (string, required). Operating mode selected for this feature. Values: `metadata_only`, `deliver`.
      - `requestFull` (boolean, required). Whether request full.
      - `delivery` (string). Polymorfa-Version 2026-10-14 and later; omitted for earlier versions. `descriptor` is direct history; `archive` is the earlier downloaded-archive delivery. Values: `archive`, `descriptor`.
    - `hms` (object, required). Specifies hms for this effective.
      - One of:
        - `false` (object).
          - `enabled` (boolean, required). Whether this feature is enabled. Values: `false`.
        - `true` (object).
          - `enabled` (boolean, required). Whether this feature is enabled. Values: `true`.
          - `region` (string, required, pattern ^[a-z0-9][a-z0-9-]{0,31}$). Specifies region for this any of.
          - `policy` (string, required). Specifies policy for this any of. Values: `short`, `standard`, `extended`, `compliance`, `enterprise_archive`.
          - `retentionDays` (integer, range 1–2555). Specifies retention days for this any of.
          - `policyVersion` (string, length 1–128). Specifies policy version for this any of.
          - `legalHold` (boolean). Whether legal hold.
  - `overrides` (object, required). Structured overrides values for this management session configuration view.
    - `historySync` (object). History synchronization behavior for newly connected sessions.
      - `mode` (string). Operating mode selected for this feature. Values: `metadata_only`, `deliver`.
      - `requestFull` (boolean). Whether request full.
      - `delivery` (string). Polymorfa-Version 2026-10-14 and later. `descriptor` makes history.sync carry the chunk descriptor or inline payload; Polymorfa never downloads the chunk. Reset it to inherit the project or team delivery setting. Without an inherited choice, delivery is archive. Existing Numbers require confirmed cleanup before switching to descriptor delivery. Values: `descriptor`.
    - `hms` (object). Specifies hms for this override.
      - One of:
        - `false` (object).
          - `enabled` (boolean, required). Whether this feature is enabled. Values: `false`.
        - `true` (object).
          - `enabled` (boolean, required). Whether this feature is enabled. Values: `true`.
          - `region` (string, required, pattern ^[a-z0-9][a-z0-9-]{0,31}$). Specifies region for this any of.
          - `policy` (string, required). Specifies policy for this any of. Values: `short`, `standard`, `extended`, `compliance`, `enterprise_archive`.
          - `retentionDays` (integer, range 1–2555). Specifies retention days for this any of.
          - `policyVersion` (string, length 1–128). Specifies policy version for this any of.
          - `legalHold` (boolean). Whether legal hold.
    - `observation` (object). Structured observation values for this override.
      - `presenceMode` (string). Behavior selected for presence. Values: `off`, `events`, `cache`.
      - `typingMode` (string). Behavior selected for typing. Values: `off`, `events`, `cache`.
      - `labelMode` (string). Behavior selected for label. Values: `off`, `events`, `cache`, `project`.
      - `quickReplyMode` (string). Behavior selected for quick reply. Values: `off`, `events`, `cache`.
  - `sources` (object, required). Structured sources values for this management session configuration view.
    - `observation.presenceMode` (string, required). Behavior selected for observation.presence. Values: `platform`, `team`, `project`, `session`.
    - `observation.typingMode` (string, required). Behavior selected for observation.typing. Values: `platform`, `team`, `project`, `session`.
    - `observation.labelMode` (string, required). Behavior selected for observation.label. Values: `platform`, `team`, `project`, `session`.
    - `observation.quickReplyMode` (string, required). Behavior selected for observation.quick reply. Values: `platform`, `team`, `project`, `session`.
    - `historySync.mode` (string, required). Behavior selected for history sync.mode. Values: `platform`, `team`, `project`, `session`, `consent`.
    - `historySync.requestFull` (string, required). Specifies history sync.request full for this source. Values: `platform`, `team`, `project`, `session`, `consent`.
    - `historySync.delivery` (string). Specifies history sync.delivery for this source. Values: `platform`, `team`, `project`, `session`.
    - `hms` (string, required). Specifies hms for this source. Values: `platform`, `team`, `project`, `session`.
  - `revisions` (object, required). Structured revisions values for this management session configuration view.
    - `team` (integer, required, min 0). Specifies team for this revision.
    - `project` (integer, required, min 0). Specifies project for this revision.
    - `session` (integer, required, min 0). Identifier of the connected Polymorfa session.
  - `application` (object). Structured application values for this management session configuration view.
    - `desiredGeneration` (integer, required, min 0). Specifies desired generation for this application.
    - `appliedGeneration` (integer, required, min 0). Specifies applied generation for this application.
    - `status` (string, required). Current status of this resource or operation. Values: `pending`, `applied`.

Headers:

- `X-Request-Id` (string). Stable request correlation identifier.
- `X-Trace-Id` (string, pattern ^[0-9a-f]{32}$). W3C trace ID of this request. Your `traceparent` trace ID when you sent a valid one.
- `Polymorfa-Version` (string). API version applied to this response.

```json
{
  "data": {
    "requestedHistory": {
      "mode": "metadata_only",
      "requestFull": true
    },
    "effective": {
      "observation": {
        "presenceMode": "off",
        "typingMode": "off",
        "labelMode": "off",
        "quickReplyMode": "off"
      },
      "historySync": {
        "mode": "metadata_only",
        "requestFull": true
      },
      "hms": {
        "enabled": false
      }
    },
    "overrides": {
      "historySync": {
        "mode": "metadata_only",
        "requestFull": true,
        "delivery": "descriptor"
      },
      "hms": {
        "enabled": false
      },
      "observation": {
        "presenceMode": "off",
        "typingMode": "off",
        "labelMode": "off",
        "quickReplyMode": "off"
      }
    },
    "sources": {
      "observation.presenceMode": "platform",
      "observation.typingMode": "platform",
      "observation.labelMode": "platform",
      "observation.quickReplyMode": "platform",
      "historySync.mode": "platform",
      "historySync.requestFull": "platform",
      "hms": "platform"
    },
    "revisions": {
      "team": 0,
      "project": 0,
      "session": 0
    }
  }
}
```

#### 400

A path, query, or request-body value did not pass validation.
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable failure code. Use this value for programmatic handling.
  - `message` (string, required). Safe explanation of the failure.
  - `param` (string, required, nullable). Invalid request field, or null when no field applies.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Documentation link to this failure code.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

#### 401

Missing/invalid credential for this audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but lacks the required scope/role/audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

#### 404

The requested resource was not found inside the authenticated team or project scope.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_not_found",
    "message": "The resource is unavailable to this caller.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#resource-not-found"
}
```

#### 409

The request conflicts with the resource's current state.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "conflict_error",
    "code": "state_conflict",
    "message": "The request conflicts with the resource state.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#state-conflict"
}
```
