Sign in
metadata

Create a partner-purpose association

Creates a new association between a partner and purpose, optionally scoped to an organization

post/metadata/partners-purposes

Request body

metadata_partner_idstring required

Foreign key reference to metadata-partners(id)

metadata_purpose_idstring required

Foreign key reference to metadata-purposes(id)

organization_idstring nullable

Optional organization ID for org-specific overrides. Null indicates a global association

processing_rulesstring[] required

Processing rules for this partner-purpose combination. essential carries no user choice: the purpose is disclosed but cannot be consented to or objected to, so it cannot be combined with opt-in or opt-out

is_flexibleboolean

Whether the declared processing rule may be overridden by a publisher restriction. Defaults to false. Cannot be set on an essential association

Response

idstring required

Unique identifier for the partner-purpose association

metadata_partner_idstring required

Foreign key reference to metadata-partners(id)

metadata_purpose_idstring required

Foreign key reference to metadata-purposes(id)

organization_idstring nullable

Optional organization ID for org-specific overrides. Null indicates a global association

processing_rulesstring[] required

Processing rules for this partner-purpose combination. essential carries no user choice: the purpose is disclosed but cannot be consented to or objected to, so it cannot be combined with opt-in or opt-out

is_org_overrideboolean

Read-only flag indicating if this is an organization override of a global association

is_flexibleboolean

Whether the declared processing rule may be overridden by a publisher restriction. The declared rule stays authoritative until a publisher restricts the purpose. Cannot be set on an essential association, which declares no legal basis to override

default_purposes_idstring nullable

Legacy foreign key reference to metadata-partners-default-purposes(id)

legitimate_interest_purposes_idstring nullable

Legacy foreign key reference to metadata-partners-legitimate-interest-purposes(id)

created_atstring date-time

Timestamp of record creation

updated_atstring date-time

Timestamp of last update

versioninteger

Version number for concurrency control

Changes

Changed in 1 of the 4 revisions of this API.13

  • 70997bf7efc913See the full diff
    • ●

      added the new essential enum value to the processing_rules/items/ response property for the response status 201

      response-property-enum-value-added

    • ○

      added the new optional request property is_flexible

      new-optional-request-property

    • ○

      added the new essential enum value to the request property processing_rules/items/

      request-property-enum-value-added

    • ○

      added the optional property is_flexible to the response with the 201 status

      response-optional-property-added