---
title: Compliance Settings
url: https://platform.claude.com/docs/en/api/python/organization/compliance_settings
---

# Compliance Settings

## Get Compliance Settings

`organization.compliance_settings.retrieve()  -> OrganizationComplianceSettings`

**GET** `/v1/organizations/compliance_settings`

Retrieve your organization's Compliance Settings.

Compliance Settings is a singleton resource: there is exactly one per
organization, addressed without an identifier. The `state` field reflects
whether the Compliance API is enabled. An organization with a parent
organization reads the state inherited from the parent's configuration.

### Returns

- `class OrganizationComplianceSettings`

  - `type: Literal["compliance_settings"]`

    default: compliance_settings

  - `state: ComplianceSettingsState`

    Whether the Compliance API is enabled for this organization.

    - `class ComplianceSettingsStateEnabled`

      - `type: Literal["enabled"]`

        default: enabled

    - `class ComplianceSettingsStateDisabled`

      - `type: Literal["disabled"]`

        default: disabled

### Example

```python
import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ.get(
        "ANTHROPIC_API_KEY"
    ),  # This is the default and can be omitted
)
organization_compliance_settings = client.organization.compliance_settings.retrieve()
print(organization_compliance_settings.state)
```

#### Response (200)

```json
{
  "state": {
    "type": "enabled"
  },
  "type": "compliance_settings"
}
```

## Update Compliance Settings

`organization.compliance_settings.update(**kwargs)  -> OrganizationComplianceSettings`

**POST** `/v1/organizations/compliance_settings`

Update your organization's Compliance Settings.

Setting `state` to `enabled` turns on the Compliance API and begins
capturing organization activity events. Setting it to `disabled` turns
both off. `state` reflects whether the Compliance API is enabled.

A request that sets `state` to its current value succeeds and leaves the
resource unchanged. A `disabled` request stays in effect until a later
`enabled` request or the organization's next provisioning action that
enables Access Transparency: enabling Access Transparency also enables
the Compliance API, which serves its activity events, so such
provisioning (including re-runs) re-enables the Compliance API even
after a `disabled` request. Automated provisioning never disables
compliance settings.

### Parameters

- `state: ComplianceSettingsStateParam`

  Desired state. Accepts the string shorthand "enabled" or "disabled" in place of the object form; the response always returns the canonical object form.

  - `class ComplianceSettingsStateEnabledParam`

    - `type: Literal["enabled"]`

  - `class ComplianceSettingsStateDisabledParam`

    - `type: Literal["disabled"]`

### Returns

- `class OrganizationComplianceSettings`

  - `type: Literal["compliance_settings"]`

    default: compliance_settings

  - `state: ComplianceSettingsState`

    Whether the Compliance API is enabled for this organization.

    - `class ComplianceSettingsStateEnabled`

      - `type: Literal["enabled"]`

        default: enabled

    - `class ComplianceSettingsStateDisabled`

      - `type: Literal["disabled"]`

        default: disabled

### Example

```python
import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ.get(
        "ANTHROPIC_API_KEY"
    ),  # This is the default and can be omitted
)
organization_compliance_settings = client.organization.compliance_settings.update(
    state={"type": "enabled"},
)
print(organization_compliance_settings.state)
```

#### Response (200)

```json
{
  "state": {
    "type": "enabled"
  },
  "type": "compliance_settings"
}
```

## Domain types

### Compliance Settings State

- `type ComplianceSettingsState = ...`

  - `class ComplianceSettingsStateEnabled`

    - `type: Literal["enabled"]`

      default: enabled

  - `class ComplianceSettingsStateDisabled`

    - `type: Literal["disabled"]`

      default: disabled

### Compliance Settings State Disabled

- `class ComplianceSettingsStateDisabled`

  - `type: Literal["disabled"]`

    default: disabled

### Compliance Settings State Disabled Param

- `class ComplianceSettingsStateDisabledParam`

  - `type: Literal["disabled"]`

### Compliance Settings State Enabled

- `class ComplianceSettingsStateEnabled`

  - `type: Literal["enabled"]`

    default: enabled

### Compliance Settings State Enabled Param

- `class ComplianceSettingsStateEnabledParam`

  - `type: Literal["enabled"]`

### Compliance Settings State Param

- `type ComplianceSettingsStateParam = ...`

  - `class ComplianceSettingsStateEnabledParam`

    - `type: Literal["enabled"]`

  - `class ComplianceSettingsStateDisabledParam`

    - `type: Literal["disabled"]`

### Organization Compliance Settings

- `class OrganizationComplianceSettings`

  - `type: Literal["compliance_settings"]`

    default: compliance_settings

  - `state: ComplianceSettingsState`

    Whether the Compliance API is enabled for this organization.

    - `class ComplianceSettingsStateEnabled`

      - `type: Literal["enabled"]`

        default: enabled

    - `class ComplianceSettingsStateDisabled`

      - `type: Literal["disabled"]`

        default: disabled