@iblai/iblai-api 4.261.1-core → 4.262.0-core

package/sdk_schema.yml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ibl-data-manager
-  version: 4.261.1-core
+  version: 4.262.0-core
   description: API for iblai
 paths:
   /access-check/{item_type}/{item_id}/:
@@ -24791,6 +24791,679 @@ paths:
               schema:
                 $ref: '#/components/schemas/Assertion'
           description: ''
+  /api/crm/organizations/:
+    get:
+      operationId: crm_organizations_list
+      description: |-
+        Returns a paginated list of organizations in your Platform. Supports filtering by `owner` and by `name` (case-insensitive substring match).
+
+        **Required permission:** `Ibl.CRM/Organizations/list`.
+      summary: List organizations
+      parameters:
+      - in: query
+        name: name
+        schema:
+          type: string
+      - in: query
+        name: owner
+        schema:
+          type: number
+      - name: page
+        required: false
+        in: query
+        description: A page number within the paginated result set.
+        schema:
+          type: integer
+      - name: page_size
+        required: false
+        in: query
+        description: Number of results to return per page.
+        schema:
+          type: integer
+      tags:
+      - crm
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PaginatedOrganizationList'
+          description: ''
+        '401':
+          description: Authentication required.
+        '403':
+          description: Missing required permission `Ibl.CRM/Organizations/list`.
+    post:
+      operationId: crm_organizations_create
+      description: |-
+        Creates a new organization in your Platform. The Platform is inferred from your credentials. `name` must be unique within your Platform.
+
+        **Required permission:** `Ibl.CRM/Organizations/write`.
+      summary: Create an organization
+      tags:
+      - crm
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/Organization'
+        required: true
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '201':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Organization'
+          description: ''
+        '400':
+          description: Validation error (for example, duplicate name).
+        '403':
+          description: Missing required permission `Ibl.CRM/Organizations/write`.
+  /api/crm/organizations/{id}/:
+    get:
+      operationId: crm_organizations_retrieve
+      description: |-
+        Returns a single organization by id.
+
+        **Required permission:** `Ibl.CRM/Organizations/read`.
+      summary: Retrieve an organization
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - crm
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Organization'
+          description: ''
+        '403':
+          description: Missing required permission `Ibl.CRM/Organizations/read`.
+        '404':
+          description: Organization not found.
+    put:
+      operationId: crm_organizations_update
+      description: |-
+        Replaces all editable fields on the organization.
+
+        **Required permission:** `Ibl.CRM/Organizations/write`.
+      summary: Replace an organization
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - crm
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/Organization'
+        required: true
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Organization'
+          description: ''
+        '400':
+          description: Validation error.
+        '403':
+          description: Missing required permission `Ibl.CRM/Organizations/write`.
+        '404':
+          description: Organization not found.
+    patch:
+      operationId: crm_organizations_partial_update
+      description: |-
+        Updates only the supplied fields on the organization.
+
+        **Required permission:** `Ibl.CRM/Organizations/write`.
+      summary: Update an organization
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - crm
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PatchedOrganization'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/PatchedOrganization'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/PatchedOrganization'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/PatchedOrganization'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/PatchedOrganization'
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Organization'
+          description: ''
+        '400':
+          description: Validation error.
+        '403':
+          description: Missing required permission `Ibl.CRM/Organizations/write`.
+        '404':
+          description: Organization not found.
+    delete:
+      operationId: crm_organizations_destroy
+      description: |-
+        Deletes the organization. Any persons linked to it are kept; their organization reference is cleared.
+
+        **Required permission:** `Ibl.CRM/Organizations/delete`.
+      summary: Delete an organization
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - crm
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '204':
+          description: Deleted.
+        '403':
+          description: Missing required permission `Ibl.CRM/Organizations/delete`.
+        '404':
+          description: Organization not found.
+  /api/crm/persons/:
+    get:
+      operationId: crm_persons_list
+      description: |-
+        Returns a paginated list of persons in your Platform. Supports filtering by `lifecycle_stage`, `owner`, `organization`, `created_at__gte`/`created_at__lte`, and `metadata__has_key`.
+
+        **Required permission:** `Ibl.CRM/Persons/list`.
+      summary: List persons
+      parameters:
+      - in: query
+        name: created_at__gte
+        schema:
+          type: string
+          format: date-time
+      - in: query
+        name: created_at__lte
+        schema:
+          type: string
+          format: date-time
+      - in: query
+        name: lifecycle_stage
+        schema:
+          type: string
+          enum:
+          - churned
+          - customer
+          - lead
+          - opportunity
+          - qualified
+        description: |-
+          Funnel position. Free-form transitions in v0.
+
+          * `lead` - Lead
+          * `qualified` - Qualified
+          * `opportunity` - Opportunity
+          * `customer` - Customer
+          * `churned` - Churned
+      - in: query
+        name: metadata__has_key
+        schema:
+          type: string
+      - in: query
+        name: organization
+        schema:
+          type: string
+          format: uuid
+      - in: query
+        name: owner
+        schema:
+          type: number
+      - name: page
+        required: false
+        in: query
+        description: A page number within the paginated result set.
+        schema:
+          type: integer
+      - name: page_size
+        required: false
+        in: query
+        description: Number of results to return per page.
+        schema:
+          type: integer
+      tags:
+      - crm
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PaginatedPersonList'
+          description: ''
+        '401':
+          description: Authentication required.
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/list`.
+    post:
+      operationId: crm_persons_create
+      description: |-
+        Creates a new person in your Platform. The Platform is inferred from your credentials. If `organization` is supplied, it must reference an organization in your Platform.
+
+        **Required permission:** `Ibl.CRM/Persons/write`.
+      summary: Create a person
+      tags:
+      - crm
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Person'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/Person'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/Person'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/Person'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/Person'
+        required: true
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '201':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Person'
+          description: ''
+        '400':
+          description: Validation error.
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/write`.
+  /api/crm/persons/{id}/:
+    get:
+      operationId: crm_persons_retrieve
+      description: |-
+        Returns a single person by id.
+
+        **Required permission:** `Ibl.CRM/Persons/read`.
+      summary: Retrieve a person
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - crm
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Person'
+          description: ''
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/read`.
+        '404':
+          description: Person not found.
+    put:
+      operationId: crm_persons_update
+      description: |-
+        Replaces all editable fields on the person.
+
+        **Required permission:** `Ibl.CRM/Persons/write`.
+      summary: Replace a person
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - crm
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Person'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/Person'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/Person'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/Person'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/Person'
+        required: true
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Person'
+          description: ''
+        '400':
+          description: Validation error.
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/write`.
+        '404':
+          description: Person not found.
+    patch:
+      operationId: crm_persons_partial_update
+      description: |-
+        Updates only the supplied fields on the person.
+
+        **Required permission:** `Ibl.CRM/Persons/write`.
+      summary: Update a person
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - crm
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PatchedPerson'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/PatchedPerson'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/PatchedPerson'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/PatchedPerson'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/PatchedPerson'
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Person'
+          description: ''
+        '400':
+          description: Validation error.
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/write`.
+        '404':
+          description: Person not found.
+    delete:
+      operationId: crm_persons_destroy
+      description: |-
+        Deletes the person.
+
+        **Required permission:** `Ibl.CRM/Persons/delete`.
+      summary: Delete a person
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - crm
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '204':
+          description: Deleted.
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/delete`.
+        '404':
+          description: Person not found.
+  /api/crm/persons/{id}/invite/:
+    post:
+      operationId: crm_persons_invite_create
+      description: |-
+        Sends a platform invitation to the person's `primary_email`. On acceptance, the invitee joins your Platform with the privileges configured in the request body.
+
+        Returns `409 Conflict` if an active invitation already exists for this email in your Platform, and `422 Unprocessable Entity` if the person is already linked to a platform user.
+
+        **Required permission:** `Ibl.CRM/Invite/action`.
+      summary: Invite a person to the platform
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - crm
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PersonInviteRequest'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/PersonInviteRequest'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/PersonInviteRequest'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/PersonInviteRequest'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/PersonInviteRequest'
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '201':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PersonInviteResponse'
+          description: ''
+        '400':
+          description: Person has no `primary_email`; cannot invite.
+        '403':
+          description: Missing required permission `Ibl.CRM/Invite/action`.
+        '404':
+          description: Person not found.
+        '409':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PersonInviteConflict'
+          description: ''
+        '422':
+          description: Person is already linked to a platform user.
+  /api/crm/persons/{id}/link-user/:
+    post:
+      operationId: crm_persons_link_user_create
+      description: |-
+        Links this person to an existing platform user. The target user must already be a member of your Platform — if they are not, send them an invitation via `POST /persons/{id}/invite/` instead.
+
+        This call is idempotent: linking a person that is already bound to the same user is a no-op. Re-linking a person that is already bound to a *different* user is refused; the existing binding is preserved and the unchanged person is returned.
+
+        **Required permission:** `Ibl.CRM/Persons/write`.
+      summary: Bind a person to an existing platform user
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - crm
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PersonLinkUserRequest'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/PersonLinkUserRequest'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/PersonLinkUserRequest'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/PersonLinkUserRequest'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/PersonLinkUserRequest'
+        required: true
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Person'
+          description: ''
+        '400':
+          description: Validation error.
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/write`, or the
+            target user is not a member of your Platform.
+        '404':
+          description: Person or user not found.
+  /api/crm/persons/merge/:
+    post:
+      operationId: crm_persons_merge_create
+      description: |-
+        Marks each person in `duplicate_ids` as inactive and reports how many related records (deals, activities, tags) were re-parented onto `primary_id`.
+
+        All ids — both the primary and every duplicate — must belong to your Platform. `primary_id` may not appear in `duplicate_ids`.
+
+        **Required permission:** `Ibl.CRM/Persons/write`.
+      summary: Merge duplicate persons into a primary
+      tags:
+      - crm
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PersonMergeRequest'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/PersonMergeRequest'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/PersonMergeRequest'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/PersonMergeRequest'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/PersonMergeRequest'
+        required: true
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PersonMergeResponse'
+          description: ''
+        '400':
+          description: 'Validation error: the primary appears in duplicates, or one
+            or more ids belong to another Platform.'
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/write`.
+        '404':
+          description: Primary person not found.
   /api/custom-domains/:
     get:
       operationId: custom_domains_retrieve
@@ -36355,6 +37028,679 @@ paths:
               schema:
                 $ref: '#/components/schemas/PublicItemPricing'
           description: ''
+  /organizations/:
+    get:
+      operationId: organizations_list
+      description: |-
+        Returns a paginated list of organizations in your Platform. Supports filtering by `owner` and by `name` (case-insensitive substring match).
+
+        **Required permission:** `Ibl.CRM/Organizations/list`.
+      summary: List organizations
+      parameters:
+      - in: query
+        name: name
+        schema:
+          type: string
+      - in: query
+        name: owner
+        schema:
+          type: number
+      - name: page
+        required: false
+        in: query
+        description: A page number within the paginated result set.
+        schema:
+          type: integer
+      - name: page_size
+        required: false
+        in: query
+        description: Number of results to return per page.
+        schema:
+          type: integer
+      tags:
+      - organizations
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PaginatedOrganizationList'
+          description: ''
+        '401':
+          description: Authentication required.
+        '403':
+          description: Missing required permission `Ibl.CRM/Organizations/list`.
+    post:
+      operationId: organizations_create
+      description: |-
+        Creates a new organization in your Platform. The Platform is inferred from your credentials. `name` must be unique within your Platform.
+
+        **Required permission:** `Ibl.CRM/Organizations/write`.
+      summary: Create an organization
+      tags:
+      - organizations
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/Organization'
+        required: true
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '201':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Organization'
+          description: ''
+        '400':
+          description: Validation error (for example, duplicate name).
+        '403':
+          description: Missing required permission `Ibl.CRM/Organizations/write`.
+  /organizations/{id}/:
+    get:
+      operationId: organizations_retrieve
+      description: |-
+        Returns a single organization by id.
+
+        **Required permission:** `Ibl.CRM/Organizations/read`.
+      summary: Retrieve an organization
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - organizations
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Organization'
+          description: ''
+        '403':
+          description: Missing required permission `Ibl.CRM/Organizations/read`.
+        '404':
+          description: Organization not found.
+    put:
+      operationId: organizations_update
+      description: |-
+        Replaces all editable fields on the organization.
+
+        **Required permission:** `Ibl.CRM/Organizations/write`.
+      summary: Replace an organization
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - organizations
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/Organization'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/Organization'
+        required: true
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Organization'
+          description: ''
+        '400':
+          description: Validation error.
+        '403':
+          description: Missing required permission `Ibl.CRM/Organizations/write`.
+        '404':
+          description: Organization not found.
+    patch:
+      operationId: organizations_partial_update
+      description: |-
+        Updates only the supplied fields on the organization.
+
+        **Required permission:** `Ibl.CRM/Organizations/write`.
+      summary: Update an organization
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - organizations
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PatchedOrganization'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/PatchedOrganization'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/PatchedOrganization'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/PatchedOrganization'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/PatchedOrganization'
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Organization'
+          description: ''
+        '400':
+          description: Validation error.
+        '403':
+          description: Missing required permission `Ibl.CRM/Organizations/write`.
+        '404':
+          description: Organization not found.
+    delete:
+      operationId: organizations_destroy
+      description: |-
+        Deletes the organization. Any persons linked to it are kept; their organization reference is cleared.
+
+        **Required permission:** `Ibl.CRM/Organizations/delete`.
+      summary: Delete an organization
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - organizations
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '204':
+          description: Deleted.
+        '403':
+          description: Missing required permission `Ibl.CRM/Organizations/delete`.
+        '404':
+          description: Organization not found.
+  /persons/:
+    get:
+      operationId: persons_list
+      description: |-
+        Returns a paginated list of persons in your Platform. Supports filtering by `lifecycle_stage`, `owner`, `organization`, `created_at__gte`/`created_at__lte`, and `metadata__has_key`.
+
+        **Required permission:** `Ibl.CRM/Persons/list`.
+      summary: List persons
+      parameters:
+      - in: query
+        name: created_at__gte
+        schema:
+          type: string
+          format: date-time
+      - in: query
+        name: created_at__lte
+        schema:
+          type: string
+          format: date-time
+      - in: query
+        name: lifecycle_stage
+        schema:
+          type: string
+          enum:
+          - churned
+          - customer
+          - lead
+          - opportunity
+          - qualified
+        description: |-
+          Funnel position. Free-form transitions in v0.
+
+          * `lead` - Lead
+          * `qualified` - Qualified
+          * `opportunity` - Opportunity
+          * `customer` - Customer
+          * `churned` - Churned
+      - in: query
+        name: metadata__has_key
+        schema:
+          type: string
+      - in: query
+        name: organization
+        schema:
+          type: string
+          format: uuid
+      - in: query
+        name: owner
+        schema:
+          type: number
+      - name: page
+        required: false
+        in: query
+        description: A page number within the paginated result set.
+        schema:
+          type: integer
+      - name: page_size
+        required: false
+        in: query
+        description: Number of results to return per page.
+        schema:
+          type: integer
+      tags:
+      - persons
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PaginatedPersonList'
+          description: ''
+        '401':
+          description: Authentication required.
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/list`.
+    post:
+      operationId: persons_create
+      description: |-
+        Creates a new person in your Platform. The Platform is inferred from your credentials. If `organization` is supplied, it must reference an organization in your Platform.
+
+        **Required permission:** `Ibl.CRM/Persons/write`.
+      summary: Create a person
+      tags:
+      - persons
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Person'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/Person'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/Person'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/Person'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/Person'
+        required: true
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '201':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Person'
+          description: ''
+        '400':
+          description: Validation error.
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/write`.
+  /persons/{id}/:
+    get:
+      operationId: persons_retrieve
+      description: |-
+        Returns a single person by id.
+
+        **Required permission:** `Ibl.CRM/Persons/read`.
+      summary: Retrieve a person
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - persons
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Person'
+          description: ''
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/read`.
+        '404':
+          description: Person not found.
+    put:
+      operationId: persons_update
+      description: |-
+        Replaces all editable fields on the person.
+
+        **Required permission:** `Ibl.CRM/Persons/write`.
+      summary: Replace a person
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - persons
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Person'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/Person'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/Person'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/Person'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/Person'
+        required: true
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Person'
+          description: ''
+        '400':
+          description: Validation error.
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/write`.
+        '404':
+          description: Person not found.
+    patch:
+      operationId: persons_partial_update
+      description: |-
+        Updates only the supplied fields on the person.
+
+        **Required permission:** `Ibl.CRM/Persons/write`.
+      summary: Update a person
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - persons
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PatchedPerson'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/PatchedPerson'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/PatchedPerson'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/PatchedPerson'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/PatchedPerson'
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Person'
+          description: ''
+        '400':
+          description: Validation error.
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/write`.
+        '404':
+          description: Person not found.
+    delete:
+      operationId: persons_destroy
+      description: |-
+        Deletes the person.
+
+        **Required permission:** `Ibl.CRM/Persons/delete`.
+      summary: Delete a person
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - persons
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '204':
+          description: Deleted.
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/delete`.
+        '404':
+          description: Person not found.
+  /persons/{id}/invite/:
+    post:
+      operationId: persons_invite_create
+      description: |-
+        Sends a platform invitation to the person's `primary_email`. On acceptance, the invitee joins your Platform with the privileges configured in the request body.
+
+        Returns `409 Conflict` if an active invitation already exists for this email in your Platform, and `422 Unprocessable Entity` if the person is already linked to a platform user.
+
+        **Required permission:** `Ibl.CRM/Invite/action`.
+      summary: Invite a person to the platform
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - persons
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PersonInviteRequest'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/PersonInviteRequest'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/PersonInviteRequest'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/PersonInviteRequest'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/PersonInviteRequest'
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '201':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PersonInviteResponse'
+          description: ''
+        '400':
+          description: Person has no `primary_email`; cannot invite.
+        '403':
+          description: Missing required permission `Ibl.CRM/Invite/action`.
+        '404':
+          description: Person not found.
+        '409':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PersonInviteConflict'
+          description: ''
+        '422':
+          description: Person is already linked to a platform user.
+  /persons/{id}/link-user/:
+    post:
+      operationId: persons_link_user_create
+      description: |-
+        Links this person to an existing platform user. The target user must already be a member of your Platform — if they are not, send them an invitation via `POST /persons/{id}/invite/` instead.
+
+        This call is idempotent: linking a person that is already bound to the same user is a no-op. Re-linking a person that is already bound to a *different* user is refused; the existing binding is preserved and the unchanged person is returned.
+
+        **Required permission:** `Ibl.CRM/Persons/write`.
+      summary: Bind a person to an existing platform user
+      parameters:
+      - in: path
+        name: id
+        schema:
+          type: string
+          format: uuid
+          description: Opaque UUID — used in API URLs and external references.
+        required: true
+      tags:
+      - persons
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PersonLinkUserRequest'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/PersonLinkUserRequest'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/PersonLinkUserRequest'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/PersonLinkUserRequest'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/PersonLinkUserRequest'
+        required: true
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Person'
+          description: ''
+        '400':
+          description: Validation error.
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/write`, or the
+            target user is not a member of your Platform.
+        '404':
+          description: Person or user not found.
+  /persons/merge/:
+    post:
+      operationId: persons_merge_create
+      description: |-
+        Marks each person in `duplicate_ids` as inactive and reports how many related records (deals, activities, tags) were re-parented onto `primary_id`.
+
+        All ids — both the primary and every duplicate — must belong to your Platform. `primary_id` may not appear in `duplicate_ids`.
+
+        **Required permission:** `Ibl.CRM/Persons/write`.
+      summary: Merge duplicate persons into a primary
+      tags:
+      - persons
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PersonMergeRequest'
+          application/scim+json:
+            schema:
+              $ref: '#/components/schemas/PersonMergeRequest'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/PersonMergeRequest'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/PersonMergeRequest'
+          '*/*':
+            schema:
+              $ref: '#/components/schemas/PersonMergeRequest'
+        required: true
+      security:
+      - PlatformApiKeyAuthentication: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PersonMergeResponse'
+          description: ''
+        '400':
+          description: 'Validation error: the primary appears in duplicates, or one
+            or more ids belong to another Platform.'
+        '403':
+          description: Missing required permission `Ibl.CRM/Persons/write`.
+        '404':
+          description: Primary person not found.
   /platforms/{platform_key}/items/{item_type}/{item_id}/access-check/:
     get:
       operationId: platforms_items_access_check_retrieve
@@ -42358,6 +43704,20 @@ components:
           description: Total time spent across all platforms
       required:
       - total_time_spent_seconds
+    LifecycleStageEnum:
+      enum:
+      - lead
+      - qualified
+      - opportunity
+      - customer
+      - churned
+      type: string
+      description: |-
+        * `lead` - Lead
+        * `qualified` - Qualified
+        * `opportunity` - Opportunity
+        * `customer` - Customer
+        * `churned` - Churned
     LtiKey:
       type: object
       properties:
@@ -43605,6 +44965,48 @@ components:
       required:
       - app
       - onboarding_completed
+    Organization:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+          readOnly: true
+          description: Server-assigned UUID.
+        platform:
+          type: integer
+          readOnly: true
+          description: Platform the Organization belongs to. Set server-side from
+            the auth token.
+        name:
+          type: string
+          description: Display name. Unique per platform (case-sensitive).
+          maxLength: 255
+        address:
+          description: Free-form JSON address (street, city, country, etc.).
+        owner:
+          type: integer
+          description: platform `core.User` id of the internal owner / account manager.
+            Optional.
+          nullable: true
+        metadata:
+          description: Free-form JSON for Platform-defined attributes.
+        created_at:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Creation timestamp.
+        updated_at:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Last-modified timestamp.
+      required:
+      - created_at
+      - id
+      - name
+      - platform
+      - updated_at
     OverTime:
       type: object
       properties:
@@ -44004,6 +45406,29 @@ components:
           type: array
           items:
             $ref: '#/components/schemas/ItemSubscriptionList'
+    PaginatedOrganizationList:
+      type: object
+      required:
+      - count
+      - results
+      properties:
+        count:
+          type: integer
+          example: 123
+        next:
+          type: string
+          nullable: true
+          format: uri
+          example: http://api.example.org/accounts/?page=4
+        previous:
+          type: string
+          nullable: true
+          format: uri
+          example: http://api.example.org/accounts/?page=2
+        results:
+          type: array
+          items:
+            $ref: '#/components/schemas/Organization'
     PaginatedPathwayGroupSuggestion:
       type: object
       description: Response serializer for paginated pathway group suggestion list
@@ -44058,6 +45483,29 @@ components:
       - next_page
       - previous_page
       - results
+    PaginatedPersonList:
+      type: object
+      required:
+      - count
+      - results
+      properties:
+        count:
+          type: integer
+          example: 123
+        next:
+          type: string
+          nullable: true
+          format: uri
+          example: http://api.example.org/accounts/?page=4
+        previous:
+          type: string
+          nullable: true
+          format: uri
+          example: http://api.example.org/accounts/?page=2
+        results:
+          type: array
+          items:
+            $ref: '#/components/schemas/Person'
     PaginatedPlatformInvitation:
       type: object
       description: Response serializer for paginated platform invitation list
@@ -45191,6 +46639,128 @@ components:
           type: boolean
           default: true
           description: Whether this notification type is enabled
+    PatchedOrganization:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+          readOnly: true
+          description: Server-assigned UUID.
+        platform:
+          type: integer
+          readOnly: true
+          description: Platform the Organization belongs to. Set server-side from
+            the auth token.
+        name:
+          type: string
+          description: Display name. Unique per platform (case-sensitive).
+          maxLength: 255
+        address:
+          description: Free-form JSON address (street, city, country, etc.).
+        owner:
+          type: integer
+          description: platform `core.User` id of the internal owner / account manager.
+            Optional.
+          nullable: true
+        metadata:
+          description: Free-form JSON for Platform-defined attributes.
+        created_at:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Creation timestamp.
+        updated_at:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Last-modified timestamp.
+    PatchedPerson:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+          readOnly: true
+          description: Server-assigned UUID. Stable across renames and merges.
+        platform:
+          type: integer
+          readOnly: true
+          description: Platform the person belongs to. Set automatically from your
+            credentials; you cannot pass another Platform's id.
+        name:
+          type: string
+          description: Display name (e.g. 'Alice Chen').
+          maxLength: 255
+        primary_email:
+          type: string
+          format: email
+          description: Canonical email address. When a platform user is created with
+            a matching email in your Platform, this person is automatically linked
+            to them (case-insensitive).
+          maxLength: 254
+        emails:
+          description: Additional email addresses associated with this person.
+        contact_numbers:
+          description: Phone/contact numbers in any free-form shape.
+        job_title:
+          type: string
+          default: ''
+          description: Role / job title — display only, not validated.
+          maxLength: 255
+        organization:
+          type: string
+          format: uuid
+          description: UUID of an organization in your Platform. References to organizations
+            in other Platforms are rejected.
+          nullable: true
+        owner:
+          type: integer
+          description: Id of the platform user who owns / manages this person (internal
+            account manager). Optional.
+          nullable: true
+        platform_user:
+          type: integer
+          description: Read-only. Populated once this person is bound to a platform
+            user — either automatically on user creation when emails match, or explicitly
+            via `POST /persons/{id}/link-user/`.
+          readOnly: true
+          nullable: true
+        lifecycle_stage:
+          allOf:
+          - $ref: '#/components/schemas/LifecycleStageEnum'
+          default: lead
+          description: |-
+            Sales pipeline stage. One of: `lead`, `qualified`, `opportunity`, `customer`, `churned`.
+
+            * `lead` - Lead
+            * `qualified` - Qualified
+            * `opportunity` - Opportunity
+            * `customer` - Customer
+            * `churned` - Churned
+        unique_id:
+          type: string
+          default: ''
+          description: Optional external system id (e.g. import key from another CRM).
+            When non-blank, must be unique within your Platform.
+          maxLength: 128
+        active:
+          type: boolean
+          readOnly: true
+          description: Read-only. Set to `false` when the person is linked to a platform
+            user or merged into another person.
+        metadata:
+          description: Free-form JSON for Platform-defined attributes.
+        created_at:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Creation timestamp.
+        updated_at:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Last-modified timestamp.
     PatchedPlatformPublicImageAsset:
       type: object
       properties:
@@ -46418,6 +47988,238 @@ components:
       required:
       - platform_key
       - resources
+    Person:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+          readOnly: true
+          description: Server-assigned UUID. Stable across renames and merges.
+        platform:
+          type: integer
+          readOnly: true
+          description: Platform the person belongs to. Set automatically from your
+            credentials; you cannot pass another Platform's id.
+        name:
+          type: string
+          description: Display name (e.g. 'Alice Chen').
+          maxLength: 255
+        primary_email:
+          type: string
+          format: email
+          description: Canonical email address. When a platform user is created with
+            a matching email in your Platform, this person is automatically linked
+            to them (case-insensitive).
+          maxLength: 254
+        emails:
+          description: Additional email addresses associated with this person.
+        contact_numbers:
+          description: Phone/contact numbers in any free-form shape.
+        job_title:
+          type: string
+          default: ''
+          description: Role / job title — display only, not validated.
+          maxLength: 255
+        organization:
+          type: string
+          format: uuid
+          description: UUID of an organization in your Platform. References to organizations
+            in other Platforms are rejected.
+          nullable: true
+        owner:
+          type: integer
+          description: Id of the platform user who owns / manages this person (internal
+            account manager). Optional.
+          nullable: true
+        platform_user:
+          type: integer
+          description: Read-only. Populated once this person is bound to a platform
+            user — either automatically on user creation when emails match, or explicitly
+            via `POST /persons/{id}/link-user/`.
+          readOnly: true
+          nullable: true
+        lifecycle_stage:
+          allOf:
+          - $ref: '#/components/schemas/LifecycleStageEnum'
+          default: lead
+          description: |-
+            Sales pipeline stage. One of: `lead`, `qualified`, `opportunity`, `customer`, `churned`.
+
+            * `lead` - Lead
+            * `qualified` - Qualified
+            * `opportunity` - Opportunity
+            * `customer` - Customer
+            * `churned` - Churned
+        unique_id:
+          type: string
+          default: ''
+          description: Optional external system id (e.g. import key from another CRM).
+            When non-blank, must be unique within your Platform.
+          maxLength: 128
+        active:
+          type: boolean
+          readOnly: true
+          description: Read-only. Set to `false` when the person is linked to a platform
+            user or merged into another person.
+        metadata:
+          description: Free-form JSON for Platform-defined attributes.
+        created_at:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Creation timestamp.
+        updated_at:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Last-modified timestamp.
+      required:
+      - active
+      - created_at
+      - id
+      - name
+      - platform
+      - platform_user
+      - updated_at
+    PersonInviteConflict:
+      type: object
+      description: Shape returned when an active invitation already exists for this
+        email.
+      properties:
+        detail:
+          type: string
+        invitation_id:
+          type: integer
+          description: Id of the pre-existing active invitation.
+        person_id:
+          type: string
+          format: uuid
+        platform_key:
+          type: string
+      required:
+      - detail
+      - invitation_id
+      - person_id
+      - platform_key
+    PersonInviteRequest:
+      type: object
+      properties:
+        is_admin:
+          type: boolean
+          description: Grant Platform-admin privileges on acceptance. Defaults to
+            `false`.
+        is_staff:
+          type: boolean
+          description: Grant staff privileges on acceptance. Defaults to `false`.
+        enrollment_config:
+          type: object
+          additionalProperties: {}
+          description: Optional enrollment payload. Forwarded to the platform invitation
+            to auto-enroll the invitee in the listed courses, programs, or pathways
+            on acceptance.
+        redirect_to:
+          type: string
+          description: URL to send the invitee to after they accept the invitation
+            (e.g. a custom landing page, an enrollment screen). Passed straight through
+            to the platform invitation row. Leave blank to use the platform default.
+          maxLength: 255
+    PersonInviteResponse:
+      type: object
+      description: Shape returned by `POST /persons/{id}/invite/`.
+      properties:
+        person_id:
+          type: string
+          format: uuid
+          description: UUID of the person that was invited.
+        invitation_id:
+          type: integer
+          description: Id of the newly created invitation.
+        invitation_email:
+          type: string
+          format: email
+          description: Email address the invitation was sent to.
+        platform_key:
+          type: string
+          description: Key of the Platform the invitation targets.
+        auto_accept:
+          type: boolean
+          description: Whether the invitation is auto-accepted when the invitee first
+            signs in.
+        active:
+          type: boolean
+          description: Whether the invitation is currently active.
+        redirect_to:
+          type: string
+          nullable: true
+          description: URL the invitee will be sent to after accepting. Null/blank
+            means the platform default destination.
+        created:
+          type: string
+          format: date-time
+          nullable: true
+          description: When the invitation was created.
+      required:
+      - active
+      - auto_accept
+      - created
+      - invitation_email
+      - invitation_id
+      - person_id
+      - platform_key
+      - redirect_to
+    PersonLinkUserRequest:
+      type: object
+      properties:
+        user_id:
+          type: integer
+          description: Id of the platform user to bind to this person. The user must
+            already be a member of your Platform — invite them first if they are not.
+      required:
+      - user_id
+    PersonMergeRequest:
+      type: object
+      properties:
+        primary_id:
+          type: string
+          format: uuid
+          description: UUID of the person to keep (the surviving record). Must belong
+            to your Platform.
+        duplicate_ids:
+          type: array
+          items:
+            type: string
+            format: uuid
+          description: UUIDs of the persons to merge into `primary_id`. Each must
+            belong to your Platform. `primary_id` may not appear in this list. The
+            duplicates are marked inactive; their related records (deals, activities,
+            tags) are re-parented onto the primary.
+      required:
+      - duplicate_ids
+      - primary_id
+    PersonMergeResponse:
+      type: object
+      description: Shape returned by `POST /persons/merge/`.
+      properties:
+        primary_id:
+          type: string
+          format: uuid
+          description: UUID of the surviving (primary) person.
+        merged_ids:
+          type: array
+          items:
+            type: string
+            format: uuid
+          description: UUIDs of the persons marked inactive by this merge.
+        reparented:
+          type: object
+          additionalProperties: {}
+          description: Per-relation counts of related records (deals, activities,
+            tags) re-parented onto the primary.
+      required:
+      - merged_ids
+      - primary_id
+      - reparented
     Platform:
       type: object
       description: 'Note: Create and update operations deprecated.'