openapi.yaml

openapi: 3.1.0
info:
  title: Pluralscape API
  version: 0.1.0
  description: |
    REST API for Pluralscape, a cross-platform plurality management application.

    All sensitive data is end-to-end encrypted. The server is zero-knowledge —
    it cannot read user content.

    ## Encryption Model
    Pluralscape uses **libsodium** with the following algorithms:
    - **Symmetric encryption**: XChaCha20-Poly1305
    - **Key exchange**: X25519
    - **Key derivation**: Argon2id (for password-to-key derivation)

    ### Encryption Tiers
    Data is encrypted at one of three tiers:

    | Tier | Name | Key Source | Use Case |
    |------|------|-----------|----------|
    | **T1** | Master-key encrypted | User's master key (derived from password via Argon2id) | Private data: member profiles, system settings, notes, journals |
    | **T2** | Per-bucket encrypted | Symmetric key scoped to a Privacy Bucket | Shared data: content visible to specific friends via key grants |
    | **T3** | Plaintext | None | Non-sensitive metadata: IDs, timestamps, structural relationships |

    ### How `encryptedData` Fields Work
    Most resource endpoints accept and return an `encryptedData` field. This is a
    **base64-encoded ciphertext blob** produced client-side:

    1. The client serializes the resource's sensitive fields (name, description, etc.)
       into a JSON payload
    2. The client encrypts that JSON with either the master key (T1) or a bucket key (T2)
       using XChaCha20-Poly1305, producing `{ciphertext, nonce}`
    3. The client base64-encodes the result and sends it as `encryptedData`
    4. The server stores the blob **opaquely** — it never decrypts or inspects the contents
    5. On read, the client decrypts the blob using the same key

    The server enforces size limits on `encryptedData` but cannot validate its internal
    structure. All validation of the decrypted content happens client-side.

    ### Master Key and Recovery
    - The user's **master key** is derived from their password using Argon2id
    - The master key is stored encrypted on the server (encrypted with itself)
    - A **recovery key** (generated at registration) can decrypt the master key if
      the password is forgotten — this is the only recovery mechanism
    - Changing a password re-wraps the master key; the underlying encryption keys remain stable

    ### Privacy Buckets and Friend Sharing
    - Each Privacy Bucket has its own symmetric key (T2 encryption)
    - When a friend is granted access to a bucket, the bucket key is encrypted with the
      friend's public key (X25519) and stored as a **key grant**
    - Key rotation re-encrypts all items in a bucket with a new key (see Key Rotation endpoints)

    ### Device Transfer
    When adding a new device, the master key is securely transferred using an
    ephemeral X25519 key exchange session (5-minute TTL).

    ## Authentication
    Most endpoints require a Bearer token obtained from `/auth/login` or `/auth/register/commit`.
    Pass it in the `Authorization` header: `Authorization: Bearer <sessionToken>`.
    Session tokens are 32-byte hex-encoded values (64 characters).

    ## Pagination
    List endpoints use cursor-based pagination. Pass `cursor` (opaque string from a
    previous response) and `limit` (default 25, max 100) as query parameters.
    Responses include `nextCursor` (null when no more pages) and `hasMore`.

    ## Rate Limiting
    All endpoints are subject to per-IP rate limits. When exceeded, the API returns
    `429 Too Many Requests` with a `Retry-After` header.

    ## Error Envelope
    All errors follow a consistent JSON structure (see `ErrorResponse` schema).

    ## Client-Side Plaintext Schemas
    Since the server is zero-knowledge, it cannot validate the contents of `encryptedData`
    fields. The **Plaintext*** schemas in the components section document what the client
    should serialize into JSON, then encrypt, before sending as `encryptedData`. These are
    **client-enforced contracts** — the server stores the blob opaquely. See each resource
    endpoint's description for which plaintext schema applies.
  license:
    name: AGPL-3.0
    url: https://www.gnu.org/licenses/agpl-3.0.html
  contact:
    name: Pluralscape

servers:
  - url: http://localhost:3000/v1
    description: Local development

security:
  - bearerAuth: []

x-tagGroups:
  - name: Infrastructure
    tags: [Health, I18n]
  - name: Authentication & Account
    tags: [Auth, Account, Friends]
  - name: System Management
    tags: [Systems, System Settings]
  - name: Core Resources
    tags: [Members, Member Photos, Member Fields, Groups, Custom Fronts, Fields, Relationships]
  - name: System Structures
    tags: [Subsystems, Side Systems, Layers, Structure Links, Structure Memberships]
  - name: Lifecycle & Innerworld
    tags: [Lifecycle Events, Innerworld]
  - name: Fronting
    tags: [Fronting Sessions, Fronting Comments, Timer Configs, Check-In Records]
  - name: Analytics
    tags: [Analytics, Fronting Reports]
  - name: Privacy
    tags: [Privacy Buckets, Bucket Content Tags, Bucket Friend Assignments, Bucket Export]
  - name: Media & Crypto
    tags: [Blobs, Key Rotation]
  - name: Notifications
    tags: [Notification Configs, Notifications, Device Tokens]

tags:
  - name: Health
    description: Service health checks
  - name: Auth
    description: Authentication, sessions, and account recovery
  - name: Account
    description: Account management and audit log
  - name: Friends
    description: Friend network and friend-facing dashboard
  - name: Systems
    description: Plural system profiles
  - name: System Settings
    description: System settings, nomenclature, PIN, and setup
  - name: Members
    description: System members (headmates)
  - name: Member Photos
    description: Photos attached to members
  - name: Member Fields
    description: Custom field values on members
  - name: Groups
    description: Member groups and group memberships
  - name: Custom Fronts
    description: Abstract cognitive states logged like members
  - name: Device Tokens
    description: Push notification device token registration and management
  - name: Notification Configs
    description: Per-event notification preferences (enabled, push enabled)
  - name: Notifications
    description: Real-time notification delivery via Server-Sent Events
  - name: Fields
    description: Custom field definitions for a system
  - name: Relationships
    description: Relationships between members
  - name: Structure Entity Types
    description: User-defined structure entity types within a system
  - name: Structure Entities
    description: Structure entities (instances of user-defined entity types)
  - name: Structure Entity Links
    description: Hierarchical parent-child links between structure entities
  - name: Structure Entity Member Links
    description: Member assignments to structure entities
  - name: Structure Entity Associations
    description: Directed cross-references between structure entities
  - name: Lifecycle Events
    description: System lifecycle events (splits, fusions, etc.)
  - name: Innerworld
    description: Innerworld regions, entities, and canvas
  - name: Privacy Buckets
    description: Privacy buckets for scoping T2-encrypted content and friend sharing
  - name: Bucket Content Tags
    description: Tag entities to privacy buckets for friend visibility
  - name: Bucket Friend Assignments
    description: Grant and revoke friend access to privacy buckets
  - name: Bucket Export
    description: Export bucket contents for friend-facing data sync
  - name: Blobs
    description: Encrypted file upload and download
  - name: Key Rotation
    description: Privacy bucket key rotation
  - name: Fronting Sessions
    description: Fronting session tracking (who is fronting and when)
  - name: Fronting Comments
    description: Comments attached to fronting sessions
  - name: Analytics
    description: Fronting analytics (duration breakdowns, co-fronting statistics)
  - name: Fronting Reports
    description: Immutable encrypted report snapshots
  - name: Timer Configs
    description: Recurring check-in timer configurations
  - name: Check-In Records
    description: Scheduled check-in instances with respond/dismiss lifecycle
  - name: Import
    description: Data import jobs and source entity mappings.
  - name: I18n
    description: Translation manifest and namespace proxy for over-the-air locale updates.

components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Session token from login or registration

  parameters:
    SystemId:
      name: systemId
      in: path
      required: true
      schema:
        type: string
        pattern: ^sys_
      description: System ID (prefixed with `sys_`)
    MemberId:
      name: memberId
      in: path
      required: true
      schema:
        type: string
        pattern: ^mem_
      description: Member ID (prefixed with `mem_`)
    GroupId:
      name: groupId
      in: path
      required: true
      schema:
        type: string
        pattern: ^grp_
      description: Group ID (prefixed with `grp_`)
    Cursor:
      name: cursor
      in: query
      required: false
      schema:
        type: string
      description: Opaque pagination cursor from a previous response
    Limit:
      name: limit
      in: query
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 25
      description: Maximum number of items to return (default 25, max 100)

  schemas:
    # Common
    ErrorResponse:
      $ref: "./schemas/common.yaml#/ErrorResponse"
    PaginationMeta:
      $ref: "./schemas/common.yaml#/PaginationMeta"
    EncryptedEntity:
      $ref: "./schemas/common.yaml#/EncryptedEntity"
    # Auth
    LoginRequest:
      $ref: "./schemas/auth.yaml#/LoginRequest"
    LoginResponse:
      $ref: "./schemas/auth.yaml#/LoginResponse"
    SaltRequest:
      $ref: "./schemas/auth.yaml#/SaltRequest"
    SaltResponse:
      $ref: "./schemas/auth.yaml#/SaltResponse"
    RegistrationInitiateRequest:
      $ref: "./schemas/auth.yaml#/RegistrationInitiateRequest"
    RegistrationInitiateResponse:
      $ref: "./schemas/auth.yaml#/RegistrationInitiateResponse"
    RegistrationCommitRequest:
      $ref: "./schemas/auth.yaml#/RegistrationCommitRequest"
    RegistrationCommitResponse:
      $ref: "./schemas/auth.yaml#/RegistrationCommitResponse"
    RegenerateRecoveryKeyResponse:
      $ref: "./schemas/auth.yaml#/RegenerateRecoveryKeyResponse"
    PasswordResetViaRecoveryKeyRequest:
      $ref: "./schemas/auth.yaml#/PasswordResetViaRecoveryKeyRequest"
    PasswordResetResponse:
      $ref: "./schemas/auth.yaml#/PasswordResetResponse"
    BiometricTokenRequest:
      $ref: "./schemas/auth.yaml#/BiometricTokenRequest"
    BiometricEnrollResponse:
      $ref: "./schemas/auth.yaml#/BiometricEnrollResponse"
    BiometricVerifyResponse:
      $ref: "./schemas/auth.yaml#/BiometricVerifyResponse"
    SessionInfo:
      $ref: "./schemas/auth.yaml#/SessionInfo"
    SessionListResponse:
      $ref: "./schemas/auth.yaml#/SessionListResponse"
    RegenerateRecoveryKeyRequest:
      $ref: "./schemas/auth.yaml#/RegenerateRecoveryKeyRequest"
    RecoveryKeyStatusResponse:
      $ref: "./schemas/auth.yaml#/RecoveryKeyStatusResponse"
    RevokeAllResponse:
      $ref: "./schemas/auth.yaml#/RevokeAllResponse"
    # Account
    AccountInfo:
      $ref: "./schemas/account.yaml#/AccountInfo"
    ChangeEmailRequest:
      $ref: "./schemas/account.yaml#/ChangeEmailRequest"
    ChangePasswordRequest:
      $ref: "./schemas/account.yaml#/ChangePasswordRequest"
    AuditLogQuery:
      $ref: "./schemas/account.yaml#/AuditLogQuery"
    AuditLogEntry:
      $ref: "./schemas/account.yaml#/AuditLogEntry"
    AuditLogResponse:
      $ref: "./schemas/account.yaml#/AuditLogResponse"
    UpdateAccountSettingsRequest:
      $ref: "./schemas/account.yaml#/UpdateAccountSettingsRequest"
    UpdateAccountSettingsResponse:
      $ref: "./schemas/account.yaml#/UpdateAccountSettingsResponse"
    DeleteAccountRequest:
      $ref: "./schemas/account.yaml#/DeleteAccountRequest"
    VerifyPinResponse:
      $ref: "./schemas/account.yaml#/VerifyPinResponse"
    ActionResponse:
      $ref: "./schemas/account.yaml#/ActionResponse"
    InitiateTransferRequest:
      $ref: "./schemas/account.yaml#/InitiateTransferRequest"
    InitiateTransferResponse:
      $ref: "./schemas/account.yaml#/InitiateTransferResponse"
    CompleteTransferRequest:
      $ref: "./schemas/account.yaml#/CompleteTransferRequest"
    CompleteTransferResponse:
      $ref: "./schemas/account.yaml#/CompleteTransferResponse"
    # Systems
    SystemProfile:
      $ref: "./schemas/systems.yaml#/SystemProfile"
    UpdateSystemRequest:
      $ref: "./schemas/systems.yaml#/UpdateSystemRequest"
    CreateSnapshotRequest:
      $ref: "./schemas/systems.yaml#/CreateSnapshotRequest"
    SnapshotResponse:
      $ref: "./schemas/systems.yaml#/SnapshotResponse"
    DuplicateSystemRequest:
      $ref: "./schemas/systems.yaml#/DuplicateSystemRequest"
    DuplicateSystemResponse:
      $ref: "./schemas/systems.yaml#/DuplicateSystemResponse"
    PurgeSystemRequest:
      $ref: "./schemas/systems.yaml#/PurgeSystemRequest"
    # Members
    MemberResponse:
      $ref: "./schemas/members.yaml#/MemberResponse"
    CreateMemberRequest:
      $ref: "./schemas/members.yaml#/CreateMemberRequest"
    UpdateMemberRequest:
      $ref: "./schemas/members.yaml#/UpdateMemberRequest"
    DuplicateMemberRequest:
      $ref: "./schemas/members.yaml#/DuplicateMemberRequest"
    # Member Photos
    CreateMemberPhotoRequest:
      $ref: "./schemas/member-photos.yaml#/CreateMemberPhotoRequest"
    ReorderPhotosRequest:
      $ref: "./schemas/member-photos.yaml#/ReorderPhotosRequest"
    # Fields
    FieldType:
      $ref: "./schemas/fields.yaml#/FieldType"
    CreateFieldDefinitionRequest:
      $ref: "./schemas/fields.yaml#/CreateFieldDefinitionRequest"
    UpdateFieldDefinitionRequest:
      $ref: "./schemas/fields.yaml#/UpdateFieldDefinitionRequest"
    FieldDefinitionResponse:
      $ref: "./schemas/fields.yaml#/FieldDefinitionResponse"
    SetFieldValueRequest:
      $ref: "./schemas/fields.yaml#/SetFieldValueRequest"
    UpdateFieldValueRequest:
      $ref: "./schemas/fields.yaml#/UpdateFieldValueRequest"
    FieldValueResponse:
      $ref: "./schemas/fields.yaml#/FieldValueResponse"
    # Groups
    GroupTreeNode:
      $ref: "./schemas/groups.yaml#/GroupTreeNode"
    GroupResponse:
      $ref: "./schemas/groups.yaml#/GroupResponse"
    CreateGroupRequest:
      $ref: "./schemas/groups.yaml#/CreateGroupRequest"
    UpdateGroupRequest:
      $ref: "./schemas/groups.yaml#/UpdateGroupRequest"
    MoveGroupRequest:
      $ref: "./schemas/groups.yaml#/MoveGroupRequest"
    CopyGroupRequest:
      $ref: "./schemas/groups.yaml#/CopyGroupRequest"
    ReorderGroupsRequest:
      $ref: "./schemas/groups.yaml#/ReorderGroupsRequest"
    AddGroupMemberRequest:
      $ref: "./schemas/groups.yaml#/AddGroupMemberRequest"
    GroupMembership:
      $ref: "./schemas/groups.yaml#/GroupMembership"
    # Custom Fronts
    CustomFrontResponse:
      $ref: "./schemas/custom-fronts.yaml#/CustomFrontResponse"
    CreateCustomFrontRequest:
      $ref: "./schemas/custom-fronts.yaml#/CreateCustomFrontRequest"
    UpdateCustomFrontRequest:
      $ref: "./schemas/custom-fronts.yaml#/UpdateCustomFrontRequest"
    # Device Tokens
    DeviceTokenPlatform:
      $ref: "./schemas/device-tokens.yaml#/DeviceTokenPlatform"
    DeviceTokenResponse:
      $ref: "./schemas/device-tokens.yaml#/DeviceTokenResponse"
    RegisterDeviceTokenRequest:
      $ref: "./schemas/device-tokens.yaml#/RegisterDeviceTokenRequest"
    DeviceTokenListResponse:
      $ref: "./schemas/device-tokens.yaml#/DeviceTokenListResponse"
    UpdateDeviceTokenRequest:
      $ref: "./schemas/device-tokens.yaml#/UpdateDeviceTokenRequest"
    # Notification Configs
    NotificationEventType:
      $ref: "./schemas/notification-configs.yaml#/NotificationEventType"
    NotificationConfigResponse:
      $ref: "./schemas/notification-configs.yaml#/NotificationConfigResponse"
    UpdateNotificationConfigRequest:
      $ref: "./schemas/notification-configs.yaml#/UpdateNotificationConfigRequest"
    NotificationConfigListResponse:
      $ref: "./schemas/notification-configs.yaml#/NotificationConfigListResponse"
    SseStreamEvent:
      $ref: "./schemas/notification-configs.yaml#/SseStreamEvent"
    # Relationships
    RelationshipType:
      $ref: "./schemas/relationships.yaml#/RelationshipType"
    CreateRelationshipRequest:
      $ref: "./schemas/relationships.yaml#/CreateRelationshipRequest"
    UpdateRelationshipRequest:
      $ref: "./schemas/relationships.yaml#/UpdateRelationshipRequest"
    RelationshipResponse:
      $ref: "./schemas/relationships.yaml#/RelationshipResponse"
    # Structure Entity Types & Entities
    CreateStructureEntityTypeRequest:
      $ref: "./schemas/structures.yaml#/CreateStructureEntityTypeRequest"
    UpdateStructureEntityTypeRequest:
      $ref: "./schemas/structures.yaml#/UpdateStructureEntityTypeRequest"
    StructureEntityTypeResponse:
      $ref: "./schemas/structures.yaml#/StructureEntityTypeResponse"
    CreateStructureEntityRequest:
      $ref: "./schemas/structures.yaml#/CreateStructureEntityRequest"
    UpdateStructureEntityRequest:
      $ref: "./schemas/structures.yaml#/UpdateStructureEntityRequest"
    StructureEntityResponse:
      $ref: "./schemas/structures.yaml#/StructureEntityResponse"
    CreateStructureEntityLinkRequest:
      $ref: "./schemas/structures.yaml#/CreateStructureEntityLinkRequest"
    StructureEntityLinkResponse:
      $ref: "./schemas/structures.yaml#/StructureEntityLinkResponse"
    CreateStructureEntityMemberLinkRequest:
      $ref: "./schemas/structures.yaml#/CreateStructureEntityMemberLinkRequest"
    StructureEntityMemberLinkResponse:
      $ref: "./schemas/structures.yaml#/StructureEntityMemberLinkResponse"
    CreateStructureEntityAssociationRequest:
      $ref: "./schemas/structures.yaml#/CreateStructureEntityAssociationRequest"
    StructureEntityAssociationResponse:
      $ref: "./schemas/structures.yaml#/StructureEntityAssociationResponse"
    HierarchyNode:
      $ref: "./schemas/structures.yaml#/HierarchyNode"
    # Timer Configs & Check-In Records
    TimerConfigResponse:
      $ref: "./schemas/timers.yaml#/TimerConfigResponse"
    CreateTimerConfigRequest:
      $ref: "./schemas/timers.yaml#/CreateTimerConfigRequest"
    UpdateTimerConfigRequest:
      $ref: "./schemas/timers.yaml#/UpdateTimerConfigRequest"
    CheckInRecordResponse:
      $ref: "./schemas/timers.yaml#/CheckInRecordResponse"
    CreateCheckInRecordRequest:
      $ref: "./schemas/timers.yaml#/CreateCheckInRecordRequest"
    RespondCheckInRecordRequest:
      $ref: "./schemas/timers.yaml#/RespondCheckInRecordRequest"
    # Lifecycle Events
    LifecycleEventType:
      $ref: "./schemas/lifecycle-events.yaml#/LifecycleEventType"
    CreateLifecycleEventRequest:
      $ref: "./schemas/lifecycle-events.yaml#/CreateLifecycleEventRequest"
    UpdateLifecycleEventRequest:
      $ref: "./schemas/lifecycle-events.yaml#/UpdateLifecycleEventRequest"
    LifecycleEventResponse:
      $ref: "./schemas/lifecycle-events.yaml#/LifecycleEventResponse"
    # Innerworld
    CreateRegionRequest:
      $ref: "./schemas/innerworld.yaml#/CreateRegionRequest"
    UpdateRegionRequest:
      $ref: "./schemas/innerworld.yaml#/UpdateRegionRequest"
    RegionResponse:
      $ref: "./schemas/innerworld.yaml#/RegionResponse"
    CreateEntityRequest:
      $ref: "./schemas/innerworld.yaml#/CreateEntityRequest"
    UpdateEntityRequest:
      $ref: "./schemas/innerworld.yaml#/UpdateEntityRequest"
    EntityResponse:
      $ref: "./schemas/innerworld.yaml#/EntityResponse"
    UpdateCanvasRequest:
      $ref: "./schemas/innerworld.yaml#/UpdateCanvasRequest"
    CanvasResponse:
      $ref: "./schemas/innerworld.yaml#/CanvasResponse"
    # Privacy Buckets
    BucketResponse:
      $ref: "./schemas/buckets.yaml#/BucketResponse"
    CreateBucketRequest:
      $ref: "./schemas/buckets.yaml#/CreateBucketRequest"
    UpdateBucketRequest:
      $ref: "./schemas/buckets.yaml#/UpdateBucketRequest"
    BucketContentTagResponse:
      $ref: "./schemas/buckets.yaml#/BucketContentTagResponse"
    TagContentRequest:
      $ref: "./schemas/buckets.yaml#/TagContentRequest"
    AssignBucketFriendRequest:
      $ref: "./schemas/buckets.yaml#/AssignBucketFriendRequest"
    BucketFriendAssignmentResponse:
      $ref: "./schemas/buckets.yaml#/BucketFriendAssignmentResponse"
    UnassignBucketFriendResponse:
      $ref: "./schemas/buckets.yaml#/UnassignBucketFriendResponse"
    # Blobs
    BlobPurpose:
      $ref: "./schemas/blobs.yaml#/BlobPurpose"
    CreateUploadUrlRequest:
      $ref: "./schemas/blobs.yaml#/CreateUploadUrlRequest"
    UploadUrlResponse:
      $ref: "./schemas/blobs.yaml#/UploadUrlResponse"
    ConfirmUploadRequest:
      $ref: "./schemas/blobs.yaml#/ConfirmUploadRequest"
    BlobResponse:
      $ref: "./schemas/blobs.yaml#/BlobResponse"
    DownloadUrlResponse:
      $ref: "./schemas/blobs.yaml#/DownloadUrlResponse"
    # Key Rotation
    RotationState:
      $ref: "./schemas/key-rotation.yaml#/RotationState"
    InitiateRotationRequest:
      $ref: "./schemas/key-rotation.yaml#/InitiateRotationRequest"
    RotationResponse:
      $ref: "./schemas/key-rotation.yaml#/RotationResponse"
    ClaimChunkRequest:
      $ref: "./schemas/key-rotation.yaml#/ClaimChunkRequest"
    ClaimChunkResponse:
      $ref: "./schemas/key-rotation.yaml#/ClaimChunkResponse"
    CompleteChunkRequest:
      $ref: "./schemas/key-rotation.yaml#/CompleteChunkRequest"
    CompleteChunkResponse:
      $ref: "./schemas/key-rotation.yaml#/CompleteChunkResponse"
    # Fronting Sessions & Comments
    FrontingSessionResponse:
      $ref: "./schemas/fronting.yaml#/FrontingSessionResponse"
    CreateFrontingSessionRequest:
      $ref: "./schemas/fronting.yaml#/CreateFrontingSessionRequest"
    UpdateFrontingSessionRequest:
      $ref: "./schemas/fronting.yaml#/UpdateFrontingSessionRequest"
    EndFrontingSessionRequest:
      $ref: "./schemas/fronting.yaml#/EndFrontingSessionRequest"
    ActiveFrontingResponse:
      $ref: "./schemas/fronting.yaml#/ActiveFrontingResponse"
    FrontingCommentResponse:
      $ref: "./schemas/fronting.yaml#/FrontingCommentResponse"
    CreateFrontingCommentRequest:
      $ref: "./schemas/fronting.yaml#/CreateFrontingCommentRequest"
    UpdateFrontingCommentRequest:
      $ref: "./schemas/fronting.yaml#/UpdateFrontingCommentRequest"
    # Analytics & Reports
    SubjectFrontingBreakdown:
      $ref: "./schemas/analytics.yaml#/SubjectFrontingBreakdown"
    FrontingBreakdownResponse:
      $ref: "./schemas/analytics.yaml#/FrontingBreakdownResponse"
    CoFrontingPair:
      $ref: "./schemas/analytics.yaml#/CoFrontingPair"
    CoFrontingBreakdownResponse:
      $ref: "./schemas/analytics.yaml#/CoFrontingBreakdownResponse"
    FrontingReportResponse:
      $ref: "./schemas/analytics.yaml#/FrontingReportResponse"
    CreateFrontingReportRequest:
      $ref: "./schemas/analytics.yaml#/CreateFrontingReportRequest"
    # Settings
    UpdateSystemSettingsRequest:
      $ref: "./schemas/settings.yaml#/UpdateSystemSettingsRequest"
    UpdateNomenclatureRequest:
      $ref: "./schemas/settings.yaml#/UpdateNomenclatureRequest"
    PinRequest:
      $ref: "./schemas/settings.yaml#/PinRequest"
    PinVerifyResponse:
      $ref: "./schemas/settings.yaml#/PinVerifyResponse"
    SetupStatusResponse:
      $ref: "./schemas/settings.yaml#/SetupStatusResponse"
    SetupStepRequest:
      $ref: "./schemas/settings.yaml#/SetupStepRequest"
    SetupCompleteRequest:
      $ref: "./schemas/settings.yaml#/SetupCompleteRequest"
    # Friend Dashboard
    FriendDashboardResponse:
      $ref: "./schemas/friend-dashboard.yaml#/FriendDashboardResponse"
    FriendDashboardFrontingSession:
      $ref: "./schemas/friend-dashboard.yaml#/FriendDashboardFrontingSession"
    FriendDashboardMember:
      $ref: "./schemas/friend-dashboard.yaml#/FriendDashboardMember"
    FriendDashboardCustomFront:
      $ref: "./schemas/friend-dashboard.yaml#/FriendDashboardCustomFront"
    FriendDashboardStructureEntity:
      $ref: "./schemas/friend-dashboard.yaml#/FriendDashboardStructureEntity"
    FriendDashboardKeyGrant:
      $ref: "./schemas/friend-dashboard.yaml#/FriendDashboardKeyGrant"
    FriendDashboardSyncEntry:
      $ref: "./schemas/friend-dashboard.yaml#/FriendDashboardSyncEntry"
    FriendDashboardSyncResponse:
      $ref: "./schemas/friend-dashboard.yaml#/FriendDashboardSyncResponse"
    # Friends
    FriendConnectionResponse:
      $ref: "./schemas/friends.yaml#/FriendConnectionResponse"
    FriendConnectionWithRotations:
      $ref: "./schemas/friends.yaml#/FriendConnectionWithRotations"
    FriendConnectionStatus:
      $ref: "./schemas/friends.yaml#/FriendConnectionStatus"
    FriendConnectionListResponse:
      $ref: "./schemas/friends.yaml#/FriendConnectionListResponse"
    UpdateFriendVisibilityRequest:
      $ref: "./schemas/friends.yaml#/UpdateFriendVisibilityRequest"
    FriendCodeResponse:
      $ref: "./schemas/friends.yaml#/FriendCodeResponse"
    FriendCodeListResponse:
      $ref: "./schemas/friends.yaml#/FriendCodeListResponse"
    RedeemFriendCodeRequest:
      $ref: "./schemas/friends.yaml#/RedeemFriendCodeRequest"
    RedeemFriendCodeResponse:
      $ref: "./schemas/friends.yaml#/RedeemFriendCodeResponse"
    FriendNotificationPreferenceResponse:
      $ref: "./schemas/friends.yaml#/FriendNotificationPreferenceResponse"
    FriendNotificationEventType:
      $ref: "./schemas/friends.yaml#/FriendNotificationEventType"
    UpdateFriendNotificationPreferenceRequest:
      $ref: "./schemas/friends.yaml#/UpdateFriendNotificationPreferenceRequest"
    ReceivedKeyGrant:
      $ref: "./schemas/friends.yaml#/ReceivedKeyGrant"
    FriendExportEntityType:
      $ref: "./schemas/friends.yaml#/FriendExportEntityType"
    FriendExportManifestResponse:
      $ref: "./schemas/friends.yaml#/FriendExportManifestResponse"
    FriendExportManifestEntry:
      $ref: "./schemas/friends.yaml#/FriendExportManifestEntry"
    FriendExportEntity:
      $ref: "./schemas/friends.yaml#/FriendExportEntity"
    FriendExportPageResponse:
      $ref: "./schemas/friends.yaml#/FriendExportPageResponse"
    # Plaintext (client-side encryption contracts)
    PlaintextImageSource:
      $ref: "./schemas/plaintext.yaml#/PlaintextImageSource"
    PlaintextSaturationLevel:
      $ref: "./schemas/plaintext.yaml#/PlaintextSaturationLevel"
    PlaintextTag:
      $ref: "./schemas/plaintext.yaml#/PlaintextTag"
    PlaintextVisualProperties:
      $ref: "./schemas/plaintext.yaml#/PlaintextVisualProperties"
    PlaintextSystem:
      $ref: "./schemas/plaintext.yaml#/PlaintextSystem"
    PlaintextMember:
      $ref: "./schemas/plaintext.yaml#/PlaintextMember"
    PlaintextMemberPhoto:
      $ref: "./schemas/plaintext.yaml#/PlaintextMemberPhoto"
    PlaintextGroup:
      $ref: "./schemas/plaintext.yaml#/PlaintextGroup"
    PlaintextCustomFront:
      $ref: "./schemas/plaintext.yaml#/PlaintextCustomFront"
    PlaintextFieldDefinition:
      $ref: "./schemas/plaintext.yaml#/PlaintextFieldDefinition"
    PlaintextFieldValue:
      $ref: "./schemas/plaintext.yaml#/PlaintextFieldValue"
    PlaintextRelationship:
      $ref: "./schemas/plaintext.yaml#/PlaintextRelationship"
    PlaintextStructureEntityType:
      $ref: "./schemas/plaintext.yaml#/PlaintextStructureEntityType"
    PlaintextStructureEntity:
      $ref: "./schemas/plaintext.yaml#/PlaintextStructureEntity"
    PlaintextFrontingSession:
      $ref: "./schemas/plaintext.yaml#/PlaintextFrontingSession"
    PlaintextLifecycleEvent:
      $ref: "./schemas/plaintext.yaml#/PlaintextLifecycleEvent"
    PlaintextInnerworldRegion:
      $ref: "./schemas/plaintext.yaml#/PlaintextInnerworldRegion"
    PlaintextInnerworldEntity:
      $ref: "./schemas/plaintext.yaml#/PlaintextInnerworldEntity"
    PlaintextInnerworldCanvas:
      $ref: "./schemas/plaintext.yaml#/PlaintextInnerworldCanvas"
    PlaintextSystemSettings:
      $ref: "./schemas/plaintext.yaml#/PlaintextSystemSettings"
    PlaintextNomenclature:
      $ref: "./schemas/plaintext.yaml#/PlaintextNomenclature"
    PlaintextStructureEntityMemberLink:
      $ref: "./schemas/plaintext.yaml#/PlaintextStructureEntityMemberLink"
    PlaintextStructureEntityAssociation:
      $ref: "./schemas/plaintext.yaml#/PlaintextStructureEntityAssociation"

  responses:
    NoContent:
      description: Success with no response body
    Unauthenticated:
      description: Missing or invalid session token
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/ErrorResponse"
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/ErrorResponse"
    ValidationError:
      description: Request validation failed
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/ErrorResponse"
    Conflict:
      description: Resource conflict (duplicate, version mismatch, or has dependents)
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/ErrorResponse"
    RateLimited:
      description: Rate limit exceeded
      headers:
        Retry-After:
          schema:
            type: integer
          description: Seconds until the rate limit resets
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/ErrorResponse"

paths:
  # Auth
  /auth/register/initiate:
    $ref: "./paths/auth.yaml#/~1auth~1register~1initiate"
  /auth/register/commit:
    $ref: "./paths/auth.yaml#/~1auth~1register~1commit"
  /auth/salt:
    $ref: "./paths/auth.yaml#/~1auth~1salt"
  /auth/login:
    $ref: "./paths/auth.yaml#/~1auth~1login"
  /auth/password-reset/recovery-key:
    $ref: "./paths/auth.yaml#/~1auth~1password-reset~1recovery-key"
  /auth/biometric/enroll:
    $ref: "./paths/auth.yaml#/~1auth~1biometric~1enroll"
  /auth/biometric/verify:
    $ref: "./paths/auth.yaml#/~1auth~1biometric~1verify"
  /auth/sessions:
    $ref: "./paths/auth.yaml#/~1auth~1sessions"
  /auth/sessions/{id}:
    $ref: "./paths/auth.yaml#/~1auth~1sessions~1%7Bid%7D"
  /auth/logout:
    $ref: "./paths/auth.yaml#/~1auth~1logout"
  /auth/sessions/revoke-all:
    $ref: "./paths/auth.yaml#/~1auth~1sessions~1revoke-all"
  /auth/recovery-key/status:
    $ref: "./paths/auth.yaml#/~1auth~1recovery-key~1status"
  /auth/recovery-key/regenerate:
    $ref: "./paths/auth.yaml#/~1auth~1recovery-key~1regenerate"
  # Account
  /account:
    $ref: "./paths/account.yaml#/~1account"
  /account/email:
    $ref: "./paths/account.yaml#/~1account~1email"
  /account/password:
    $ref: "./paths/account.yaml#/~1account~1password"
  /account/audit-log:
    $ref: "./paths/account.yaml#/~1account~1audit-log"
  /account/settings:
    $ref: "./paths/account.yaml#/~1account~1settings"
  /account/pin:
    $ref: "./paths/account.yaml#/~1account~1pin"
  /account/pin/verify:
    $ref: "./paths/account.yaml#/~1account~1pin~1verify"
  /account/device-transfer:
    $ref: "./paths/account.yaml#/~1account~1device-transfer"
  /account/device-transfer/{transferId}/approve:
    $ref: "./paths/account.yaml#/~1account~1device-transfer~1%7BtransferId%7D~1approve"
  /account/device-transfer/{transferId}/complete:
    $ref: "./paths/account.yaml#/~1account~1device-transfer~1%7BtransferId%7D~1complete"
  # Friends
  /account/friends:
    $ref: "./paths/friends.yaml#/~1account~1friends"
  /account/friends/key-grants:
    $ref: "./paths/friends.yaml#/~1account~1friends~1key-grants"
  /account/friends/{connectionId}:
    $ref: "./paths/friends.yaml#/~1account~1friends~1%7BconnectionId%7D"
  /account/friends/{connectionId}/block:
    $ref: "./paths/friends.yaml#/~1account~1friends~1%7BconnectionId%7D~1block"
  /account/friends/{connectionId}/remove:
    $ref: "./paths/friends.yaml#/~1account~1friends~1%7BconnectionId%7D~1remove"
  /account/friends/{connectionId}/archive:
    $ref: "./paths/friends.yaml#/~1account~1friends~1%7BconnectionId%7D~1archive"
  /account/friends/{connectionId}/restore:
    $ref: "./paths/friends.yaml#/~1account~1friends~1%7BconnectionId%7D~1restore"
  /account/friends/{connectionId}/visibility:
    $ref: "./paths/friends.yaml#/~1account~1friends~1%7BconnectionId%7D~1visibility"
  /account/friends/{connectionId}/notifications:
    $ref: "./paths/friend-notifications.yaml#/~1account~1friends~1%7BconnectionId%7D~1notifications"
  /account/friends/{connectionId}/export/manifest:
    $ref: "./paths/friend-export.yaml#/~1account~1friends~1%7BconnectionId%7D~1export~1manifest"
  /account/friends/{connectionId}/export:
    $ref: "./paths/friend-export.yaml#/~1account~1friends~1%7BconnectionId%7D~1export"
  /account/friends/{connectionId}/dashboard:
    $ref: "./paths/friend-dashboard.yaml#/~1account~1friends~1%7BconnectionId%7D~1dashboard"
  /account/friends/{connectionId}/dashboard/sync:
    $ref: "./paths/friend-dashboard.yaml#/~1account~1friends~1%7BconnectionId%7D~1dashboard~1sync"
  # Friend Codes
  /account/friend-codes:
    $ref: "./paths/friend-codes.yaml#/~1account~1friend-codes"
  /account/friend-codes/redeem:
    $ref: "./paths/friend-codes.yaml#/~1account~1friend-codes~1redeem"
  /account/friend-codes/{codeId}/archive:
    $ref: "./paths/friend-codes.yaml#/~1account~1friend-codes~1%7BcodeId%7D~1archive"
  # Systems
  /systems:
    $ref: "./paths/systems.yaml#/~1systems"
  /systems/{systemId}:
    $ref: "./paths/systems.yaml#/~1systems~1%7BsystemId%7D"
  /systems/{systemId}/duplicate:
    $ref: "./paths/systems.yaml#/~1systems~1%7BsystemId%7D~1duplicate"
  /systems/{systemId}/purge:
    $ref: "./paths/systems.yaml#/~1systems~1%7BsystemId%7D~1purge"
  /systems/{systemId}/snapshots:
    $ref: "./paths/systems.yaml#/~1systems~1%7BsystemId%7D~1snapshots"
  /systems/{systemId}/snapshots/{snapshotId}:
    $ref: "./paths/systems.yaml#/~1systems~1%7BsystemId%7D~1snapshots~1%7BsnapshotId%7D"
  # Settings
  /systems/{systemId}/settings:
    $ref: "./paths/settings.yaml#/~1systems~1%7BsystemId%7D~1settings"
  /systems/{systemId}/settings/pin:
    $ref: "./paths/settings.yaml#/~1systems~1%7BsystemId%7D~1settings~1pin"
  /systems/{systemId}/settings/pin/verify:
    $ref: "./paths/settings.yaml#/~1systems~1%7BsystemId%7D~1settings~1pin~1verify"
  /systems/{systemId}/nomenclature:
    $ref: "./paths/settings.yaml#/~1systems~1%7BsystemId%7D~1nomenclature"
  /systems/{systemId}/setup/status:
    $ref: "./paths/settings.yaml#/~1systems~1%7BsystemId%7D~1setup~1status"
  /systems/{systemId}/setup/nomenclature:
    $ref: "./paths/settings.yaml#/~1systems~1%7BsystemId%7D~1setup~1nomenclature"
  /systems/{systemId}/setup/profile:
    $ref: "./paths/settings.yaml#/~1systems~1%7BsystemId%7D~1setup~1profile"
  /systems/{systemId}/setup/complete:
    $ref: "./paths/settings.yaml#/~1systems~1%7BsystemId%7D~1setup~1complete"
  # Members
  /systems/{systemId}/members:
    $ref: "./paths/members.yaml#/~1systems~1%7BsystemId%7D~1members"
  /systems/{systemId}/members/{memberId}:
    $ref: "./paths/members.yaml#/~1systems~1%7BsystemId%7D~1members~1%7BmemberId%7D"
  /systems/{systemId}/members/{memberId}/duplicate:
    $ref: "./paths/members.yaml#/~1systems~1%7BsystemId%7D~1members~1%7BmemberId%7D~1duplicate"
  /systems/{systemId}/members/{memberId}/archive:
    $ref: "./paths/members.yaml#/~1systems~1%7BsystemId%7D~1members~1%7BmemberId%7D~1archive"
  /systems/{systemId}/members/{memberId}/restore:
    $ref: "./paths/members.yaml#/~1systems~1%7BsystemId%7D~1members~1%7BmemberId%7D~1restore"
  /systems/{systemId}/members/{memberId}/memberships:
    $ref: "./paths/members.yaml#/~1systems~1%7BsystemId%7D~1members~1%7BmemberId%7D~1memberships"
  # Member Photos
  /systems/{systemId}/members/{memberId}/photos:
    $ref: "./paths/member-photos.yaml#/~1systems~1%7BsystemId%7D~1members~1%7BmemberId%7D~1photos"
  /systems/{systemId}/members/{memberId}/photos/reorder:
    $ref: "./paths/member-photos.yaml#/~1systems~1%7BsystemId%7D~1members~1%7BmemberId%7D~1photos~1reorder"
  /systems/{systemId}/members/{memberId}/photos/{photoId}/archive:
    $ref: "./paths/member-photos.yaml#/~1systems~1%7BsystemId%7D~1members~1%7BmemberId%7D~1photos~1%7BphotoId%7D~1archive"
  /systems/{systemId}/members/{memberId}/photos/{photoId}/restore:
    $ref: "./paths/member-photos.yaml#/~1systems~1%7BsystemId%7D~1members~1%7BmemberId%7D~1photos~1%7BphotoId%7D~1restore"
  /systems/{systemId}/members/{memberId}/photos/{photoId}:
    $ref: "./paths/member-photos.yaml#/~1systems~1%7BsystemId%7D~1members~1%7BmemberId%7D~1photos~1%7BphotoId%7D"
  # Groups
  /systems/{systemId}/groups:
    $ref: "./paths/groups.yaml#/~1systems~1%7BsystemId%7D~1groups"
  /systems/{systemId}/groups/tree:
    $ref: "./paths/groups.yaml#/~1systems~1%7BsystemId%7D~1groups~1tree"
  /systems/{systemId}/groups/reorder:
    $ref: "./paths/groups.yaml#/~1systems~1%7BsystemId%7D~1groups~1reorder"
  /systems/{systemId}/groups/{groupId}:
    $ref: "./paths/groups.yaml#/~1systems~1%7BsystemId%7D~1groups~1%7BgroupId%7D"
  /systems/{systemId}/groups/{groupId}/move:
    $ref: "./paths/groups.yaml#/~1systems~1%7BsystemId%7D~1groups~1%7BgroupId%7D~1move"
  /systems/{systemId}/groups/{groupId}/copy:
    $ref: "./paths/groups.yaml#/~1systems~1%7BsystemId%7D~1groups~1%7BgroupId%7D~1copy"
  /systems/{systemId}/groups/{groupId}/archive:
    $ref: "./paths/groups.yaml#/~1systems~1%7BsystemId%7D~1groups~1%7BgroupId%7D~1archive"
  /systems/{systemId}/groups/{groupId}/restore:
    $ref: "./paths/groups.yaml#/~1systems~1%7BsystemId%7D~1groups~1%7BgroupId%7D~1restore"
  /systems/{systemId}/groups/{groupId}/members:
    $ref: "./paths/groups.yaml#/~1systems~1%7BsystemId%7D~1groups~1%7BgroupId%7D~1members"
  /systems/{systemId}/groups/{groupId}/members/{memberId}:
    $ref: "./paths/groups.yaml#/~1systems~1%7BsystemId%7D~1groups~1%7BgroupId%7D~1members~1%7BmemberId%7D"
  # Custom Fronts
  /systems/{systemId}/custom-fronts:
    $ref: "./paths/custom-fronts.yaml#/~1systems~1%7BsystemId%7D~1custom-fronts"
  /systems/{systemId}/custom-fronts/{customFrontId}:
    $ref: "./paths/custom-fronts.yaml#/~1systems~1%7BsystemId%7D~1custom-fronts~1%7BcustomFrontId%7D"
  /systems/{systemId}/custom-fronts/{customFrontId}/archive:
    $ref: "./paths/custom-fronts.yaml#/~1systems~1%7BsystemId%7D~1custom-fronts~1%7BcustomFrontId%7D~1archive"
  /systems/{systemId}/custom-fronts/{customFrontId}/restore:
    $ref: "./paths/custom-fronts.yaml#/~1systems~1%7BsystemId%7D~1custom-fronts~1%7BcustomFrontId%7D~1restore"
  # Device Tokens
  /systems/{systemId}/device-tokens:
    $ref: "./paths/device-tokens.yaml#/~1systems~1%7BsystemId%7D~1device-tokens"
  /systems/{systemId}/device-tokens/{tokenId}:
    $ref: "./paths/device-tokens.yaml#/~1systems~1%7BsystemId%7D~1device-tokens~1%7BtokenId%7D"
  /systems/{systemId}/device-tokens/{tokenId}/revoke:
    $ref: "./paths/device-tokens.yaml#/~1systems~1%7BsystemId%7D~1device-tokens~1%7BtokenId%7D~1revoke"
  # Notification Configs
  /systems/{systemId}/notification-configs:
    $ref: "./paths/notification-configs.yaml#/~1systems~1%7BsystemId%7D~1notification-configs"
  /systems/{systemId}/notification-configs/{eventType}:
    $ref: "./paths/notification-configs.yaml#/~1systems~1%7BsystemId%7D~1notification-configs~1%7BeventType%7D"
  # Field Definitions
  /systems/{systemId}/fields:
    $ref: "./paths/fields.yaml#/~1systems~1%7BsystemId%7D~1fields"
  /systems/{systemId}/fields/{fieldId}:
    $ref: "./paths/fields.yaml#/~1systems~1%7BsystemId%7D~1fields~1%7BfieldId%7D"
  /systems/{systemId}/fields/{fieldId}/archive:
    $ref: "./paths/fields.yaml#/~1systems~1%7BsystemId%7D~1fields~1%7BfieldId%7D~1archive"
  /systems/{systemId}/fields/{fieldId}/restore:
    $ref: "./paths/fields.yaml#/~1systems~1%7BsystemId%7D~1fields~1%7BfieldId%7D~1restore"
  # Field Bucket Visibility
  /systems/{systemId}/fields/{fieldDefinitionId}/bucket-visibility:
    $ref: "./paths/fields.yaml#/~1systems~1%7BsystemId%7D~1fields~1%7BfieldDefinitionId%7D~1bucket-visibility"
  /systems/{systemId}/fields/{fieldDefinitionId}/bucket-visibility/{bucketId}:
    $ref: "./paths/fields.yaml#/~1systems~1%7BsystemId%7D~1fields~1%7BfieldDefinitionId%7D~1bucket-visibility~1%7BbucketId%7D"
  # Relationships
  /systems/{systemId}/relationships:
    $ref: "./paths/relationships.yaml#/~1systems~1%7BsystemId%7D~1relationships"
  /systems/{systemId}/relationships/{relationshipId}:
    $ref: "./paths/relationships.yaml#/~1systems~1%7BsystemId%7D~1relationships~1%7BrelationshipId%7D"
  /systems/{systemId}/relationships/{relationshipId}/archive:
    $ref: "./paths/relationships.yaml#/~1systems~1%7BsystemId%7D~1relationships~1%7BrelationshipId%7D~1archive"
  /systems/{systemId}/relationships/{relationshipId}/restore:
    $ref: "./paths/relationships.yaml#/~1systems~1%7BsystemId%7D~1relationships~1%7BrelationshipId%7D~1restore"
  # Structure Entity Types
  /systems/{systemId}/structure/entity-types:
    $ref: "./paths/structure-entity-types.yaml#/~1systems~1%7BsystemId%7D~1structure~1entity-types"
  /systems/{systemId}/structure/entity-types/{entityTypeId}:
    $ref: "./paths/structure-entity-types.yaml#/~1systems~1%7BsystemId%7D~1structure~1entity-types~1%7BentityTypeId%7D"
  /systems/{systemId}/structure/entity-types/{entityTypeId}/archive:
    $ref: "./paths/structure-entity-types.yaml#/~1systems~1%7BsystemId%7D~1structure~1entity-types~1%7BentityTypeId%7D~1archive"
  /systems/{systemId}/structure/entity-types/{entityTypeId}/restore:
    $ref: "./paths/structure-entity-types.yaml#/~1systems~1%7BsystemId%7D~1structure~1entity-types~1%7BentityTypeId%7D~1restore"
  # Structure Entities
  /systems/{systemId}/structure/entities:
    $ref: "./paths/structure-entities.yaml#/~1systems~1%7BsystemId%7D~1structure~1entities"
  /systems/{systemId}/structure/entities/{entityId}:
    $ref: "./paths/structure-entities.yaml#/~1systems~1%7BsystemId%7D~1structure~1entities~1%7BentityId%7D"
  /systems/{systemId}/structure/entities/{entityId}/archive:
    $ref: "./paths/structure-entities.yaml#/~1systems~1%7BsystemId%7D~1structure~1entities~1%7BentityId%7D~1archive"
  /systems/{systemId}/structure/entities/{entityId}/restore:
    $ref: "./paths/structure-entities.yaml#/~1systems~1%7BsystemId%7D~1structure~1entities~1%7BentityId%7D~1restore"
  # Structure Entity Links
  /systems/{systemId}/structure/entity-links:
    $ref: "./paths/structure-entities.yaml#/~1systems~1%7BsystemId%7D~1structure~1entity-links"
  /systems/{systemId}/structure/entity-links/{linkId}:
    $ref: "./paths/structure-entities.yaml#/~1systems~1%7BsystemId%7D~1structure~1entity-links~1%7BlinkId%7D"
  # Structure Entity Member Links
  /systems/{systemId}/structure/entity-member-links:
    $ref: "./paths/structure-entities.yaml#/~1systems~1%7BsystemId%7D~1structure~1entity-member-links"
  /systems/{systemId}/structure/entity-member-links/{linkId}:
    $ref: "./paths/structure-entities.yaml#/~1systems~1%7BsystemId%7D~1structure~1entity-member-links~1%7BlinkId%7D"
  # Structure Entity Associations
  /systems/{systemId}/structure/entity-associations:
    $ref: "./paths/structure-entities.yaml#/~1systems~1%7BsystemId%7D~1structure~1entity-associations"
  /systems/{systemId}/structure/entity-associations/{associationId}:
    $ref: "./paths/structure-entities.yaml#/~1systems~1%7BsystemId%7D~1structure~1entity-associations~1%7BassociationId%7D"
  # Lifecycle Events
  /systems/{systemId}/lifecycle-events:
    $ref: "./paths/lifecycle-events.yaml#/~1systems~1%7BsystemId%7D~1lifecycle-events"
  /systems/{systemId}/lifecycle-events/{eventId}:
    $ref: "./paths/lifecycle-events.yaml#/~1systems~1%7BsystemId%7D~1lifecycle-events~1%7BeventId%7D"
  # Innerworld
  /systems/{systemId}/innerworld/regions:
    $ref: "./paths/innerworld.yaml#/~1systems~1%7BsystemId%7D~1innerworld~1regions"
  /systems/{systemId}/innerworld/regions/{regionId}:
    $ref: "./paths/innerworld.yaml#/~1systems~1%7BsystemId%7D~1innerworld~1regions~1%7BregionId%7D"
  /systems/{systemId}/innerworld/regions/{regionId}/archive:
    $ref: "./paths/innerworld.yaml#/~1systems~1%7BsystemId%7D~1innerworld~1regions~1%7BregionId%7D~1archive"
  /systems/{systemId}/innerworld/regions/{regionId}/restore:
    $ref: "./paths/innerworld.yaml#/~1systems~1%7BsystemId%7D~1innerworld~1regions~1%7BregionId%7D~1restore"
  /systems/{systemId}/innerworld/entities:
    $ref: "./paths/innerworld.yaml#/~1systems~1%7BsystemId%7D~1innerworld~1entities"
  /systems/{systemId}/innerworld/entities/{entityId}:
    $ref: "./paths/innerworld.yaml#/~1systems~1%7BsystemId%7D~1innerworld~1entities~1%7BentityId%7D"
  /systems/{systemId}/innerworld/entities/{entityId}/archive:
    $ref: "./paths/innerworld.yaml#/~1systems~1%7BsystemId%7D~1innerworld~1entities~1%7BentityId%7D~1archive"
  /systems/{systemId}/innerworld/entities/{entityId}/restore:
    $ref: "./paths/innerworld.yaml#/~1systems~1%7BsystemId%7D~1innerworld~1entities~1%7BentityId%7D~1restore"
  /systems/{systemId}/innerworld/canvas:
    $ref: "./paths/innerworld.yaml#/~1systems~1%7BsystemId%7D~1innerworld~1canvas"
  # Blobs
  /systems/{systemId}/blobs:
    $ref: "./paths/blobs.yaml#/~1systems~1%7BsystemId%7D~1blobs"
  /systems/{systemId}/blobs/upload-url:
    $ref: "./paths/blobs.yaml#/~1systems~1%7BsystemId%7D~1blobs~1upload-url"
  /systems/{systemId}/blobs/{blobId}/confirm:
    $ref: "./paths/blobs.yaml#/~1systems~1%7BsystemId%7D~1blobs~1%7BblobId%7D~1confirm"
  /systems/{systemId}/blobs/{blobId}/download-url:
    $ref: "./paths/blobs.yaml#/~1systems~1%7BsystemId%7D~1blobs~1%7BblobId%7D~1download-url"
  /systems/{systemId}/blobs/{blobId}:
    $ref: "./paths/blobs.yaml#/~1systems~1%7BsystemId%7D~1blobs~1%7BblobId%7D"
  # Buckets
  /systems/{systemId}/buckets:
    $ref: "./paths/buckets.yaml#/~1systems~1%7BsystemId%7D~1buckets"
  /systems/{systemId}/buckets/{bucketId}:
    $ref: "./paths/buckets.yaml#/~1systems~1%7BsystemId%7D~1buckets~1%7BbucketId%7D"
  /systems/{systemId}/buckets/{bucketId}/archive:
    $ref: "./paths/buckets.yaml#/~1systems~1%7BsystemId%7D~1buckets~1%7BbucketId%7D~1archive"
  /systems/{systemId}/buckets/{bucketId}/restore:
    $ref: "./paths/buckets.yaml#/~1systems~1%7BsystemId%7D~1buckets~1%7BbucketId%7D~1restore"
  /systems/{systemId}/buckets/{bucketId}/tags:
    $ref: "./paths/buckets.yaml#/~1systems~1%7BsystemId%7D~1buckets~1%7BbucketId%7D~1tags"
  /systems/{systemId}/buckets/{bucketId}/tags/{entityType}/{entityId}:
    $ref: "./paths/buckets.yaml#/~1systems~1%7BsystemId%7D~1buckets~1%7BbucketId%7D~1tags~1%7BentityType%7D~1%7BentityId%7D"
  /systems/{systemId}/buckets/{bucketId}/friends:
    $ref: "./paths/buckets.yaml#/~1systems~1%7BsystemId%7D~1buckets~1%7BbucketId%7D~1friends"
  /systems/{systemId}/buckets/{bucketId}/friends/{connectionId}:
    $ref: "./paths/buckets.yaml#/~1systems~1%7BsystemId%7D~1buckets~1%7BbucketId%7D~1friends~1%7BconnectionId%7D"
  # Bucket Export
  /systems/{systemId}/buckets/{bucketId}/export/manifest:
    $ref: "./paths/bucket-export.yaml#/~1systems~1%7BsystemId%7D~1buckets~1%7BbucketId%7D~1export~1manifest"
  /systems/{systemId}/buckets/{bucketId}/export:
    $ref: "./paths/bucket-export.yaml#/~1systems~1%7BsystemId%7D~1buckets~1%7BbucketId%7D~1export"
  # Key Rotation
  /systems/{systemId}/buckets/{bucketId}/rotations:
    $ref: "./paths/key-rotation.yaml#/~1systems~1%7BsystemId%7D~1buckets~1%7BbucketId%7D~1rotations"
  /systems/{systemId}/buckets/{bucketId}/rotations/{rotationId}:
    $ref: "./paths/key-rotation.yaml#/~1systems~1%7BsystemId%7D~1buckets~1%7BbucketId%7D~1rotations~1%7BrotationId%7D"
  /systems/{systemId}/buckets/{bucketId}/rotations/{rotationId}/claim:
    $ref: "./paths/key-rotation.yaml#/~1systems~1%7BsystemId%7D~1buckets~1%7BbucketId%7D~1rotations~1%7BrotationId%7D~1claim"
  /systems/{systemId}/buckets/{bucketId}/rotations/{rotationId}/complete:
    $ref: "./paths/key-rotation.yaml#/~1systems~1%7BsystemId%7D~1buckets~1%7BbucketId%7D~1rotations~1%7BrotationId%7D~1complete"
  # Fronting Sessions
  /systems/{systemId}/fronting-sessions:
    $ref: "./paths/fronting-sessions.yaml#/~1systems~1%7BsystemId%7D~1fronting-sessions"
  /systems/{systemId}/fronting-sessions/{sessionId}:
    $ref: "./paths/fronting-sessions.yaml#/~1systems~1%7BsystemId%7D~1fronting-sessions~1%7BsessionId%7D"
  /systems/{systemId}/fronting-sessions/{sessionId}/end:
    $ref: "./paths/fronting-sessions.yaml#/~1systems~1%7BsystemId%7D~1fronting-sessions~1%7BsessionId%7D~1end"
  /systems/{systemId}/fronting-sessions/{sessionId}/archive:
    $ref: "./paths/fronting-sessions.yaml#/~1systems~1%7BsystemId%7D~1fronting-sessions~1%7BsessionId%7D~1archive"
  /systems/{systemId}/fronting-sessions/{sessionId}/restore:
    $ref: "./paths/fronting-sessions.yaml#/~1systems~1%7BsystemId%7D~1fronting-sessions~1%7BsessionId%7D~1restore"
  /systems/{systemId}/fronting/active:
    $ref: "./paths/fronting-sessions.yaml#/~1systems~1%7BsystemId%7D~1fronting~1active"
  /systems/{systemId}/fronting-sessions/{sessionId}/comments:
    $ref: "./paths/fronting-sessions.yaml#/~1systems~1%7BsystemId%7D~1fronting-sessions~1%7BsessionId%7D~1comments"
  /systems/{systemId}/fronting-sessions/{sessionId}/comments/{commentId}:
    $ref: "./paths/fronting-sessions.yaml#/~1systems~1%7BsystemId%7D~1fronting-sessions~1%7BsessionId%7D~1comments~1%7BcommentId%7D"
  /systems/{systemId}/fronting-sessions/{sessionId}/comments/{commentId}/archive:
    $ref: "./paths/fronting-sessions.yaml#/~1systems~1%7BsystemId%7D~1fronting-sessions~1%7BsessionId%7D~1comments~1%7BcommentId%7D~1archive"
  /systems/{systemId}/fronting-sessions/{sessionId}/comments/{commentId}/restore:
    $ref: "./paths/fronting-sessions.yaml#/~1systems~1%7BsystemId%7D~1fronting-sessions~1%7BsessionId%7D~1comments~1%7BcommentId%7D~1restore"
  # Analytics
  /systems/{systemId}/analytics/fronting:
    $ref: "./paths/analytics.yaml#/~1systems~1%7BsystemId%7D~1analytics~1fronting"
  /systems/{systemId}/analytics/co-fronting:
    $ref: "./paths/analytics.yaml#/~1systems~1%7BsystemId%7D~1analytics~1co-fronting"
  # Fronting Reports
  /systems/{systemId}/fronting-reports:
    $ref: "./paths/fronting-reports.yaml#/~1systems~1%7BsystemId%7D~1fronting-reports"
  /systems/{systemId}/fronting-reports/{reportId}:
    $ref: "./paths/fronting-reports.yaml#/~1systems~1%7BsystemId%7D~1fronting-reports~1%7BreportId%7D"
  /systems/{systemId}/fronting-reports/{reportId}/archive:
    $ref: "./paths/fronting-reports.yaml#/~1systems~1%7BsystemId%7D~1fronting-reports~1%7BreportId%7D~1archive"
  /systems/{systemId}/fronting-reports/{reportId}/restore:
    $ref: "./paths/fronting-reports.yaml#/~1systems~1%7BsystemId%7D~1fronting-reports~1%7BreportId%7D~1restore"
  # Webhook Configs
  /systems/{systemId}/webhook-configs:
    $ref: "./paths/webhook-configs.yaml#/~1systems~1%7BsystemId%7D~1webhook-configs"
  /systems/{systemId}/webhook-configs/{webhookId}:
    $ref: "./paths/webhook-configs.yaml#/~1systems~1%7BsystemId%7D~1webhook-configs~1%7BwebhookId%7D"
  /systems/{systemId}/webhook-configs/{webhookId}/archive:
    $ref: "./paths/webhook-configs.yaml#/~1systems~1%7BsystemId%7D~1webhook-configs~1%7BwebhookId%7D~1archive"
  /systems/{systemId}/webhook-configs/{webhookId}/rotate-secret:
    $ref: "./paths/webhook-configs.yaml#/~1systems~1%7BsystemId%7D~1webhook-configs~1%7BwebhookId%7D~1rotate-secret"
  /systems/{systemId}/webhook-configs/{webhookId}/test:
    $ref: "./paths/webhook-configs.yaml#/~1systems~1%7BsystemId%7D~1webhook-configs~1%7BwebhookId%7D~1test"
  /systems/{systemId}/webhook-configs/{webhookId}/restore:
    $ref: "./paths/webhook-configs.yaml#/~1systems~1%7BsystemId%7D~1webhook-configs~1%7BwebhookId%7D~1restore"
  # Webhook Deliveries
  /systems/{systemId}/webhook-deliveries:
    $ref: "./paths/webhook-deliveries.yaml#/~1systems~1%7BsystemId%7D~1webhook-deliveries"
  /systems/{systemId}/webhook-deliveries/{deliveryId}:
    $ref: "./paths/webhook-deliveries.yaml#/~1systems~1%7BsystemId%7D~1webhook-deliveries~1%7BdeliveryId%7D"
  # API Keys
  /systems/{systemId}/api-keys:
    $ref: "./paths/api-keys.yaml#/~1systems~1%7BsystemId%7D~1api-keys"
  /systems/{systemId}/api-keys/{apiKeyId}:
    $ref: "./paths/api-keys.yaml#/~1systems~1%7BsystemId%7D~1api-keys~1%7BapiKeyId%7D"
  /systems/{systemId}/api-keys/{apiKeyId}/revoke:
    $ref: "./paths/api-keys.yaml#/~1systems~1%7BsystemId%7D~1api-keys~1%7BapiKeyId%7D~1revoke"
  # Channels
  /systems/{systemId}/channels:
    $ref: "./paths/channels.yaml#/~1systems~1%7BsystemId%7D~1channels"
  /systems/{systemId}/channels/{channelId}:
    $ref: "./paths/channels.yaml#/~1systems~1%7BsystemId%7D~1channels~1%7BchannelId%7D"
  /systems/{systemId}/channels/{channelId}/archive:
    $ref: "./paths/channels.yaml#/~1systems~1%7BsystemId%7D~1channels~1%7BchannelId%7D~1archive"
  /systems/{systemId}/channels/{channelId}/restore:
    $ref: "./paths/channels.yaml#/~1systems~1%7BsystemId%7D~1channels~1%7BchannelId%7D~1restore"
  # Messages
  /systems/{systemId}/channels/{channelId}/messages:
    $ref: "./paths/messages.yaml#/~1systems~1%7BsystemId%7D~1channels~1%7BchannelId%7D~1messages"
  /systems/{systemId}/channels/{channelId}/messages/{messageId}:
    $ref: "./paths/messages.yaml#/~1systems~1%7BsystemId%7D~1channels~1%7BchannelId%7D~1messages~1%7BmessageId%7D"
  /systems/{systemId}/channels/{channelId}/messages/{messageId}/archive:
    $ref: "./paths/messages.yaml#/~1systems~1%7BsystemId%7D~1channels~1%7BchannelId%7D~1messages~1%7BmessageId%7D~1archive"
  /systems/{systemId}/channels/{channelId}/messages/{messageId}/restore:
    $ref: "./paths/messages.yaml#/~1systems~1%7BsystemId%7D~1channels~1%7BchannelId%7D~1messages~1%7BmessageId%7D~1restore"
  # Board Messages
  /systems/{systemId}/board-messages:
    $ref: "./paths/board-messages.yaml#/~1systems~1%7BsystemId%7D~1board-messages"
  /systems/{systemId}/board-messages/reorder:
    $ref: "./paths/board-messages.yaml#/~1systems~1%7BsystemId%7D~1board-messages~1reorder"
  /systems/{systemId}/board-messages/{boardMessageId}:
    $ref: "./paths/board-messages.yaml#/~1systems~1%7BsystemId%7D~1board-messages~1%7BboardMessageId%7D"
  /systems/{systemId}/board-messages/{boardMessageId}/pin:
    $ref: "./paths/board-messages.yaml#/~1systems~1%7BsystemId%7D~1board-messages~1%7BboardMessageId%7D~1pin"
  /systems/{systemId}/board-messages/{boardMessageId}/unpin:
    $ref: "./paths/board-messages.yaml#/~1systems~1%7BsystemId%7D~1board-messages~1%7BboardMessageId%7D~1unpin"
  /systems/{systemId}/board-messages/{boardMessageId}/archive:
    $ref: "./paths/board-messages.yaml#/~1systems~1%7BsystemId%7D~1board-messages~1%7BboardMessageId%7D~1archive"
  /systems/{systemId}/board-messages/{boardMessageId}/restore:
    $ref: "./paths/board-messages.yaml#/~1systems~1%7BsystemId%7D~1board-messages~1%7BboardMessageId%7D~1restore"
  # Notes
  /systems/{systemId}/notes:
    $ref: "./paths/notes.yaml#/~1systems~1%7BsystemId%7D~1notes"
  /systems/{systemId}/notes/{noteId}:
    $ref: "./paths/notes.yaml#/~1systems~1%7BsystemId%7D~1notes~1%7BnoteId%7D"
  /systems/{systemId}/notes/{noteId}/archive:
    $ref: "./paths/notes.yaml#/~1systems~1%7BsystemId%7D~1notes~1%7BnoteId%7D~1archive"
  /systems/{systemId}/notes/{noteId}/restore:
    $ref: "./paths/notes.yaml#/~1systems~1%7BsystemId%7D~1notes~1%7BnoteId%7D~1restore"
  # Polls
  /systems/{systemId}/polls:
    $ref: "./paths/polls.yaml#/~1systems~1%7BsystemId%7D~1polls"
  /systems/{systemId}/polls/{pollId}:
    $ref: "./paths/polls.yaml#/~1systems~1%7BsystemId%7D~1polls~1%7BpollId%7D"
  /systems/{systemId}/polls/{pollId}/close:
    $ref: "./paths/polls.yaml#/~1systems~1%7BsystemId%7D~1polls~1%7BpollId%7D~1close"
  /systems/{systemId}/polls/{pollId}/votes:
    $ref: "./paths/polls.yaml#/~1systems~1%7BsystemId%7D~1polls~1%7BpollId%7D~1votes"
  /systems/{systemId}/polls/{pollId}/votes/{voteId}:
    $ref: "./paths/polls.yaml#/~1systems~1%7BsystemId%7D~1polls~1%7BpollId%7D~1votes~1%7BvoteId%7D"
  /systems/{systemId}/polls/{pollId}/results:
    $ref: "./paths/polls.yaml#/~1systems~1%7BsystemId%7D~1polls~1%7BpollId%7D~1results"
  /systems/{systemId}/polls/{pollId}/archive:
    $ref: "./paths/polls.yaml#/~1systems~1%7BsystemId%7D~1polls~1%7BpollId%7D~1archive"
  /systems/{systemId}/polls/{pollId}/restore:
    $ref: "./paths/polls.yaml#/~1systems~1%7BsystemId%7D~1polls~1%7BpollId%7D~1restore"
  # Acknowledgements
  /systems/{systemId}/acknowledgements:
    $ref: "./paths/acknowledgements.yaml#/~1systems~1%7BsystemId%7D~1acknowledgements"
  /systems/{systemId}/acknowledgements/{acknowledgementId}:
    $ref: "./paths/acknowledgements.yaml#/~1systems~1%7BsystemId%7D~1acknowledgements~1%7BacknowledgementId%7D"
  /systems/{systemId}/acknowledgements/{acknowledgementId}/confirm:
    $ref: "./paths/acknowledgements.yaml#/~1systems~1%7BsystemId%7D~1acknowledgements~1%7BacknowledgementId%7D~1confirm"
  /systems/{systemId}/acknowledgements/{acknowledgementId}/archive:
    $ref: "./paths/acknowledgements.yaml#/~1systems~1%7BsystemId%7D~1acknowledgements~1%7BacknowledgementId%7D~1archive"
  /systems/{systemId}/acknowledgements/{acknowledgementId}/restore:
    $ref: "./paths/acknowledgements.yaml#/~1systems~1%7BsystemId%7D~1acknowledgements~1%7BacknowledgementId%7D~1restore"
  # Timer Configs
  /systems/{systemId}/timer-configs:
    $ref: "./paths/timer-configs.yaml#/~1systems~1%7BsystemId%7D~1timer-configs"
  /systems/{systemId}/timer-configs/{timerId}:
    $ref: "./paths/timer-configs.yaml#/~1systems~1%7BsystemId%7D~1timer-configs~1%7BtimerId%7D"
  /systems/{systemId}/timer-configs/{timerId}/archive:
    $ref: "./paths/timer-configs.yaml#/~1systems~1%7BsystemId%7D~1timer-configs~1%7BtimerId%7D~1archive"
  /systems/{systemId}/timer-configs/{timerId}/restore:
    $ref: "./paths/timer-configs.yaml#/~1systems~1%7BsystemId%7D~1timer-configs~1%7BtimerId%7D~1restore"
  # Check-In Records
  /systems/{systemId}/check-in-records:
    $ref: "./paths/check-in-records.yaml#/~1systems~1%7BsystemId%7D~1check-in-records"
  /systems/{systemId}/check-in-records/{recordId}:
    $ref: "./paths/check-in-records.yaml#/~1systems~1%7BsystemId%7D~1check-in-records~1%7BrecordId%7D"
  /systems/{systemId}/check-in-records/{recordId}/respond:
    $ref: "./paths/check-in-records.yaml#/~1systems~1%7BsystemId%7D~1check-in-records~1%7BrecordId%7D~1respond"
  /systems/{systemId}/check-in-records/{recordId}/dismiss:
    $ref: "./paths/check-in-records.yaml#/~1systems~1%7BsystemId%7D~1check-in-records~1%7BrecordId%7D~1dismiss"
  /systems/{systemId}/check-in-records/{recordId}/restore:
    $ref: "./paths/check-in-records.yaml#/~1systems~1%7BsystemId%7D~1check-in-records~1%7BrecordId%7D~1restore"
  /systems/{systemId}/check-in-records/{recordId}/archive:
    $ref: "./paths/check-in-records.yaml#/~1systems~1%7BsystemId%7D~1check-in-records~1%7BrecordId%7D~1archive"
  # Lifecycle Events (archive/restore)
  /systems/{systemId}/lifecycle-events/{eventId}/archive:
    $ref: "./paths/lifecycle-events.yaml#/~1systems~1%7BsystemId%7D~1lifecycle-events~1%7BeventId%7D~1archive"
  /systems/{systemId}/lifecycle-events/{eventId}/restore:
    $ref: "./paths/lifecycle-events.yaml#/~1systems~1%7BsystemId%7D~1lifecycle-events~1%7BeventId%7D~1restore"
  # Key Rotation (retry)
  /systems/{systemId}/buckets/{bucketId}/rotations/{rotationId}/retry:
    $ref: "./paths/key-rotation.yaml#/~1systems~1%7BsystemId%7D~1buckets~1%7BbucketId%7D~1rotations~1%7BrotationId%7D~1retry"
  # Structure Entity Hierarchy
  /systems/{systemId}/structure/entities/{entityId}/hierarchy:
    $ref: "./paths/structure-entities.yaml#/~1systems~1%7BsystemId%7D~1structure~1entities~1%7BentityId%7D~1hierarchy"
  # Import
  /systems/{systemId}/import-jobs:
    $ref: "./paths/import-jobs.yaml#/~1systems~1%7BsystemId%7D~1import-jobs"
  /systems/{systemId}/import-jobs/{importJobId}:
    $ref: "./paths/import-jobs.yaml#/~1systems~1%7BsystemId%7D~1import-jobs~1%7BimportJobId%7D"
  /systems/{systemId}/import-entity-refs:
    $ref: "./paths/import-entity-refs.yaml#/~1systems~1%7BsystemId%7D~1import-entity-refs"
  /systems/{systemId}/import-entity-refs/lookup:
    $ref: "./paths/import-entity-refs.yaml#/~1systems~1%7BsystemId%7D~1import-entity-refs~1lookup"
  /systems/{systemId}/import-entity-refs/lookup-batch:
    $ref: "./paths/import-entity-refs.yaml#/~1systems~1%7BsystemId%7D~1import-entity-refs~1lookup-batch"
  /systems/{systemId}/import-entity-refs/upsert-batch:
    $ref: "./paths/import-entity-refs.yaml#/~1systems~1%7BsystemId%7D~1import-entity-refs~1upsert-batch"
  # I18n OTA proxy
  /i18n/manifest:
    $ref: "./paths/i18n.yaml#/~1i18n~1manifest"
  /i18n/{locale}/{namespace}:
    $ref: "./paths/i18n.yaml#/~1i18n~1%7Blocale%7D~1%7Bnamespace%7D"