Didomi Platform API — Data Manager Vendors & Taxonomies

naftiko: 1.0.0-alpha2
info:
  label: Didomi Platform API — Data Manager Vendors & Taxonomies
  description: Didomi Platform API — Data Manager Vendors & Taxonomies. 61 operations. Self-contained Naftiko capability over the Didomi Platform REST API.
  tags:
  - Didomi
  - Consent Management
  - Privacy
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    DIDOMI_BEARER_TOKEN: DIDOMI_BEARER_TOKEN
capability:
  consumes:
  - type: http
    namespace: data-manager-vendors
    baseUri: https://api.didomi.io/v1
    description: Didomi Platform API — Data Manager Vendors & Taxonomies business capability against the Didomi Platform REST API (https://api.didomi.io/v1).
    resources:
    - name: vendors
      path: /vendors
      operations:
      - name: get-vendors
        method: GET
        description: Retrieve a list of vendors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: query
          in: query
          type: object
          required: false
          description: Optional query filters / pagination.
      - name: post-vendors
        method: POST
        description: Create a vendor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
    - name: vendors-id
      path: /vendors/{id}
      operations:
      - name: get-vendors-id
        method: GET
        description: Retrieve a vendor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
      - name: put-vendors-id
        method: PUT
        description: Update a vendor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: patch-vendors-id
        method: PATCH
        description: Patch a vendor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: delete-vendors-id
        method: DELETE
        description: Delete a vendor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
    - name: metadata-partners-deprecate
      path: /metadata/partners/deprecate
      operations:
      - name: post-metadata-partners-deprecate
        method: POST
        description: Creates a new resource with data.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
    - name: metadata-partners
      path: /metadata/partners
      operations:
      - name: get-metadata-partners
        method: GET
        description: Retrieve a list of partners
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: query
          in: query
          type: object
          required: false
          description: Optional query filters / pagination.
      - name: post-metadata-partners
        method: POST
        description: Create a partner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
    - name: metadata-partners-id
      path: /metadata/partners/{id}
      operations:
      - name: get-metadata-partners-id
        method: GET
        description: Retrieve a partner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
      - name: put-metadata-partners-id
        method: PUT
        description: Update a partner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: patch-metadata-partners-id
        method: PATCH
        description: Patch a partner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: delete-metadata-partners-id
        method: DELETE
        description: Delete a partner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
    - name: taxonomies-vendors
      path: /taxonomies/vendors
      operations:
      - name: get-taxonomies-vendors
        method: GET
        description: Retrieve a list of taxonomy items for vendors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: query
          in: query
          type: object
          required: false
          description: Optional query filters / pagination.
      - name: post-taxonomies-vendors
        method: POST
        description: Create a taxonomy item for vendors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
    - name: taxonomies-vendors-id
      path: /taxonomies/vendors/{id}
      operations:
      - name: get-taxonomies-vendors-id
        method: GET
        description: Retrieve a taxonomy item for vendors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
      - name: put-taxonomies-vendors-id
        method: PUT
        description: Update a taxonomy item for vendors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: patch-taxonomies-vendors-id
        method: PATCH
        description: Patch a taxonomy item for vendors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: delete-taxonomies-vendors-id
        method: DELETE
        description: Delete a taxonomy item for vendors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
    - name: metadata-vendors
      path: /metadata/vendors
      operations:
      - name: get-metadata-vendors
        method: GET
        description: Retrieve a list of vendors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: query
          in: query
          type: object
          required: false
          description: Optional query filters / pagination.
      - name: post-metadata-vendors
        method: POST
        description: Create a vendor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
    - name: metadata-vendors-id
      path: /metadata/vendors/{id}
      operations:
      - name: get-metadata-vendors-id
        method: GET
        description: Retrieve  a vendor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
      - name: put-metadata-vendors-id
        method: PUT
        description: Update a vendor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: patch-metadata-vendors-id
        method: PATCH
        description: Patch a vendor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: delete-metadata-vendors-id
        method: DELETE
        description: Delete a vendor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
    - name: metadata-partners-categories
      path: /metadata/partners-categories
      operations:
      - name: get-metadata-partners-categories
        method: GET
        description: Retrieve a list of partners categories
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: query
          in: query
          type: object
          required: false
          description: Optional query filters / pagination.
      - name: post-metadata-partners-categories
        method: POST
        description: Create a partners category
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
    - name: metadata-partners-categories-id
      path: /metadata/partners-categories/{id}
      operations:
      - name: get-metadata-partners-categories-id
        method: GET
        description: Retrieve a partners category
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
      - name: put-metadata-partners-categories-id
        method: PUT
        description: Update a partners category
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: patch-metadata-partners-categories-id
        method: PATCH
        description: Patch a partners category
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: delete-metadata-partners-categories-id
        method: DELETE
        description: Delete a partners category
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
    - name: metadata-partners-purposes
      path: /metadata/partners-purposes
      operations:
      - name: get-metadata-partners-purposes
        method: GET
        description: List partner-purpose associations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: query
          in: query
          type: object
          required: false
          description: Optional query filters / pagination.
      - name: post-metadata-partners-purposes
        method: POST
        description: Create a partner-purpose association
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
    - name: metadata-partners-purposes-id
      path: /metadata/partners-purposes/{id}
      operations:
      - name: get-metadata-partners-purposes-id
        method: GET
        description: Get a partner-purpose association
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
      - name: put-metadata-partners-purposes-id
        method: PUT
        description: Updates the resource identified by id using data.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: patch-metadata-partners-purposes-id
        method: PATCH
        description: Update processing rules
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: delete-metadata-partners-purposes-id
        method: DELETE
        description: Delete a partner-purpose association
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
    - name: metadata-partners-default-purposes
      path: /metadata/partners-default-purposes
      operations:
      - name: get-metadata-partners-default-purposes
        method: GET
        description: Retrieve a list of partners-default-purposes objects
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: query
          in: query
          type: object
          required: false
          description: Optional query filters / pagination.
      - name: post-metadata-partners-default-purposes
        method: POST
        description: Create a new association between a partner and purpose
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
    - name: metadata-partners-legitimate-interest-purposes
      path: /metadata/partners-legitimate-interest-purposes
      operations:
      - name: get-metadata-partners-legitimate-interest-purposes
        method: GET
        description: Retrieve a list of partners-legitimate-interest-purposes objects
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: query
          in: query
          type: object
          required: false
          description: Optional query filters / pagination.
      - name: post-metadata-partners-legitimate-interest-purposes
        method: POST
        description: Create a new association between a partner and purpose
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
    - name: metadata-partners-spi-purposes
      path: /metadata/partners-spi-purposes
      operations:
      - name: get-metadata-partners-spi-purposes
        method: GET
        description: Retrieve a list of partners-spi-purposes objects
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: query
          in: query
          type: object
          required: false
          description: Optional query filters / pagination.
      - name: post-metadata-partners-spi-purposes
        method: POST
        description: Create a new association between a partner and purpose
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
    - name: metadata-partners-storages
      path: /metadata/partners-storages
      operations:
      - name: get-metadata-partners-storages
        method: GET
        description: Retrieve a list of storages
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: query
          in: query
          type: object
          required: false
          description: Optional query filters / pagination.
      - name: post-metadata-partners-storages
        method: POST
        description: Create a storage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
    - name: metadata-partners-storages-id
      path: /metadata/partners-storages/{id}
      operations:
      - name: get-metadata-partners-storages-id
        method: GET
        description: Retrieve a storage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
      - name: put-metadata-partners-storages-id
        method: PUT
        description: Update a storage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: patch-metadata-partners-storages-id
        method: PATCH
        description: Patch a storage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: delete-metadata-partners-storages-id
        method: DELETE
        description: Delete a storage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
    - name: metadata-partners-purposes-templates-overrides
      path: /metadata/partners-purposes-templates-overrides
      operations:
      - name: get-metadata-partners-purposes-templates-overrides
        method: GET
        description: List template overrides
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: query
          in: query
          type: object
          required: false
          description: Optional query filters / pagination.
      - name: post-metadata-partners-purposes-templates-overrides
        method: POST
        description: Create a template override
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
    - name: metadata-partners-purposes-templates-overrides-id
      path: /metadata/partners-purposes-templates-overrides/{id}
      operations:
      - name: get-metadata-partners-purposes-templates-overrides-id
        method: GET
        description: Get a template override
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
      - name: put-metadata-partners-purposes-templates-overrides-id
        method: PUT
        description: Updates the resource identified by id using data.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: patch-metadata-partners-purposes-templates-overrides-id
        method: PATCH
        description: Update a template override
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: delete-metadata-partners-purposes-templates-overrides-id
        method: DELETE
        description: Delete a template override
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
    - name: metadata-partners-purposes-notices-regulations-overrides
      path: /metadata/partners-purposes-notices-regulations-overrides
      operations:
      - name: get-metadata-partners-purposes-notices-regulations-overrides
        method: GET
        description: List notice-regulation overrides
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: query
          in: query
          type: object
          required: false
          description: Optional query filters / pagination.
      - name: post-metadata-partners-purposes-notices-regulations-overrides
        method: POST
        description: Create a notice-regulation override
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
    - name: metadata-partners-purposes-notices-regulations-overrides-id
      path: /metadata/partners-purposes-notices-regulations-overrides/{id}
      operations:
      - name: get-metadata-partners-purposes-notices-regulations-overrides-id
        method: GET
        description: Get a notice-regulation override
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
      - name: put-metadata-partners-purposes-notices-regulations-overrides-id
        method: PUT
        description: Updates the resource identified by id using data.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: patch-metadata-partners-purposes-notices-regulations-overrides-id
        method: PATCH
        description: Update a notice-regulation override
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: Request body (JSON).
      - name: delete-metadata-partners-purposes-notices-regulations-overrides-id
        method: DELETE
        description: Delete a notice-regulation override
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
    authentication:
      type: bearer
      value: '{{env.DIDOMI_BEARER_TOKEN}}'
      placement: header
      note: Obtain by POSTing api-key + secret to /v1/sessions and reusing access_token for up to one hour.
  exposes:
  - type: rest
    namespace: data-manager-vendors-rest
    port: 8080
    description: REST adapter for Didomi Platform API — Data Manager Vendors & Taxonomies. One resource per consumed operation.
    resources:
    - path: /v1/vendors
      name: vendors
      description: REST surface for vendors.
      operations:
      - method: GET
        name: get-vendors
        description: Retrieve a list of vendors
        call: data-manager-vendors.get-vendors
      - method: POST
        name: post-vendors
        description: Create a vendor
        call: data-manager-vendors.post-vendors
    - path: /v1/vendors/{id}
      name: vendors-id
      description: REST surface for vendors-id.
      operations:
      - method: GET
        name: get-vendors-id
        description: Retrieve a vendor
        call: data-manager-vendors.get-vendors-id
      - method: PUT
        name: put-vendors-id
        description: Update a vendor
        call: data-manager-vendors.put-vendors-id
      - method: PATCH
        name: patch-vendors-id
        description: Patch a vendor
        call: data-manager-vendors.patch-vendors-id
      - method: DELETE
        name: delete-vendors-id
        description: Delete a vendor
        call: data-manager-vendors.delete-vendors-id
    - path: /v1/metadata/partners/deprecate
      name: metadata-partners-deprecate
      description: REST surface for metadata-partners-deprecate.
      operations:
      - method: POST
        name: post-metadata-partners-deprecate
        description: Creates a new resource with data.
        call: data-manager-vendors.post-metadata-partners-deprecate
    - path: /v1/metadata/partners
      name: metadata-partners
      description: REST surface for metadata-partners.
      operations:
      - method: GET
        name: get-metadata-partners
        description: Retrieve a list of partners
        call: data-manager-vendors.get-metadata-partners
      - method: POST
        name: post-metadata-partners
        description: Create a partner
        call: data-manager-vendors.post-metadata-partners
    - path: /v1/metadata/partners/{id}
      name: metadata-partners-id
      description: REST surface for metadata-partners-id.
      operations:
      - method: GET
        name: get-metadata-partners-id
        description: Retrieve a partner
        call: data-manager-vendors.get-metadata-partners-id
      - method: PUT
        name: put-metadata-partners-id
        description: Update a partner
        call: data-manager-vendors.put-metadata-partners-id
      - method: PATCH
        name: patch-metadata-partners-id
        description: Patch a partner
        call: data-manager-vendors.patch-metadata-partners-id
      - method: DELETE
        name: delete-metadata-partners-id
        description: Delete a partner
        call: data-manager-vendors.delete-metadata-partners-id
    - path: /v1/taxonomies/vendors
      name: taxonomies-vendors
      description: REST surface for taxonomies-vendors.
      operations:
      - method: GET
        name: get-taxonomies-vendors
        description: Retrieve a list of taxonomy items for vendors
        call: data-manager-vendors.get-taxonomies-vendors
      - method: POST
        name: post-taxonomies-vendors
        description: Create a taxonomy item for vendors
        call: data-manager-vendors.post-taxonomies-vendors
    - path: /v1/taxonomies/vendors/{id}
      name: taxonomies-vendors-id
      description: REST surface for taxonomies-vendors-id.
      operations:
      - method: GET
        name: get-taxonomies-vendors-id
        description: Retrieve a taxonomy item for vendors
        call: data-manager-vendors.get-taxonomies-vendors-id
      - method: PUT
        name: put-taxonomies-vendors-id
        description: Update a taxonomy item for vendors
        call: data-manager-vendors.put-taxonomies-vendors-id
      - method: PATCH
        name: patch-taxonomies-vendors-id
        description: Patch a taxonomy item for vendors
        call: data-manager-vendors.patch-taxonomies-vendors-id
      - method: DELETE
        name: delete-taxonomies-vendors-id
        description: Delete a ta

# --- truncated at 32 KB (59 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/didomi/refs/heads/main/capabilities/data-manager-vendors.yaml