> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meetingkit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The settings assignment object

> Where settings apply: a settings object and the conditions that must all hold.

An assignment applies one [settings object](/api-reference/settings/object) where every condition of its
`scope` holds. See [Settings](/meetingkit/settings).

## Attributes

<ResponseField name="id" type="string">
  Beginning with `asg_`.
</ResponseField>

<ResponseField name="object" type="string">
  Always `settings_assignment`.
</ResponseField>

<ResponseField name="settings_id" type="string">
  The settings it applies, beginning with `set_`.
</ResponseField>

<ResponseField name="scope" type="string[]">
  The conditions that must all hold, each `<kind>:<name>`.

  * `workspace:wks_…`: The workspace's members and meetings. A scope names exactly one `workspace:` or `member:`.
  * `member:mem_…`: One member's meetings.
  * `meeting:mtg_…`: One meeting, this occurrence only. It implies its workspace; a scope with it names no member.
  * `meetings:organized`: Meetings the member organizes.
  * `meetings:internal`: Meetings where every participant is a workspace member.
  * `meetings:domain`: Meetings where every participant is on the member's email domain.
  * `meetings:external`: Meetings with at least one participant outside the workspace.

  One category per scope for now; to record external *or* organized meetings, make two assignments.
</ResponseField>

<ResponseField name="created_at" type="string">
  When the assignment was made, in ISO 8601.
</ResponseField>

<ResponseExample>
  ```json The settings assignment object theme={null}
  {
    "id": "asg_01k6a3ext00000000000000000",
    "object": "settings_assignment",
    "settings_id": "set_01k6rec00000000000000000000",
    "scope": ["workspace:wks_01k6a2r9s8x7c2dvq3m5n6p4ab", "meetings:external"],
    "created_at": "2026-09-30T09:12:41Z"
  }
  ```
</ResponseExample>