naftiko: 1.0.0-alpha2
info:
  label: DocuSign Admin API — MultiProductUserManagement
  description: 'DocuSign Admin API — MultiProductUserManagement. 11 operations. Lead operation: Docusign Returns a list of
    DSGroups.. Self-contained Naftiko capability covering one Docusign business surface.'
  tags:
  - Docusign
  - MultiProductUserManagement
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    DOCUSIGN_API_KEY: DOCUSIGN_API_KEY
capability:
  consumes:
  - type: http
    namespace: admin-multiproductusermanagement
    baseUri: https://api.docusign.net/Management
    description: DocuSign Admin API — MultiProductUserManagement business capability. Self-contained, no shared references.
    resources:
    - name: v2.1-organizations-organizationId-accounts-accountId-dsgroups
      path: /v2.1/organizations/{organizationId}/accounts/{accountId}/dsgroups
      operations:
      - name: docusigngroupsv21getdsgroupsv21
        method: GET
        description: Docusign Returns a list of DSGroups.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: path
          type: string
          description: The organization's GUID.
          required: true
        - name: accountId
          in: path
          type: string
          description: The account ID GUID.
          required: true
        - name: page
          in: query
          type: integer
          description: Start page of DSGroups.
        - name: page_size
          in: query
          type: integer
          description: Page size of DSGroups.
      - name: docusigngroupsv21adddsgroupv21
        method: POST
        description: Docusign Creates a new DSGroup.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: path
          type: string
          description: The organization's GUID.
          required: true
        - name: accountId
          in: path
          type: string
          description: The account ID GUID.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2.1-organizations-organizationId-accounts-accountId-dsgroups-dsGroupId
      path: /v2.1/organizations/{organizationId}/accounts/{accountId}/dsgroups/{dsGroupId}
      operations:
      - name: docusigngroupsv21getdsgroupv21
        method: GET
        description: Docusign Returns details about a single DSGroup.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: path
          type: string
          description: The organization's GUID.
          required: true
        - name: accountId
          in: path
          type: string
          description: The account ID GUID.
          required: true
        - name: dsGroupId
          in: path
          type: string
          description: The DSGroup's ID GUID
          required: true
      - name: docusigngroupsv21deletedsgroupv21
        method: DELETE
        description: Docusign Deletes a DSGroup.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: path
          type: string
          description: The organization's GUID.
          required: true
        - name: accountId
          in: path
          type: string
          description: The account ID GUID.
          required: true
        - name: dsGroupId
          in: path
          type: string
          description: The DSGroup's GUID.
          required: true
    - name: v2.1-organizations-organizationId-accounts-accountId-dsgroups-dsGroupId-users
      path: /v2.1/organizations/{organizationId}/accounts/{accountId}/dsgroups/{dsGroupId}/users
      operations:
      - name: docusigngroupsv21getdsgroupusersv21
        method: GET
        description: Docusign Gets a list of users in a DSGroup.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: path
          type: string
          description: The organization's GUID.
          required: true
        - name: accountId
          in: path
          type: string
          description: The account ID GUID.
          required: true
        - name: dsGroupId
          in: path
          type: string
          description: The DSGroup's GUID.
          required: true
        - name: page
          in: query
          type: integer
          description: Start page of DSGroups.
        - name: page_size
          in: query
          type: integer
          description: Page size of DSGroups.
      - name: docusigngroupsv21adddsgroupusersv21
        method: POST
        description: Docusign Adds a list of users to a DSGroup.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: path
          type: string
          description: The organization's GUID.
          required: true
        - name: accountId
          in: path
          type: string
          description: The account ID GUID.
          required: true
        - name: dsGroupId
          in: path
          type: string
          description: The DSGroup's GUID.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: docusigngroupsv21removedsgroupusersv21
        method: DELETE
        description: Docusign Removes a list of users from a DSGroup.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: path
          type: string
          description: The organization's GUID.
          required: true
        - name: accountId
          in: path
          type: string
          description: The account ID GUID.
          required: true
        - name: dsGroupId
          in: path
          type: string
          description: The DSGroup's GUID.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2.1-organizations-organizationId-accounts-accountId-products-permission_profile
      path: /v2.1/organizations/{organizationId}/accounts/{accountId}/products/permission_profiles
      operations:
      - name: organizationproductpermissionprofilegetproductpermissionprofiles
        method: GET
        description: Docusign Gets products associated with the account and the available permission profiles.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: path
          type: string
          description: The organization's GUID.
          required: true
        - name: accountId
          in: path
          type: string
          description: The account ID GUID.
          required: true
    - name: v2.1-organizations-organizationId-accounts-accountId-products-users-userId-permi
      path: /v2.1/organizations/{organizationId}/accounts/{accountId}/products/users/{userId}/permission_profiles
      operations:
      - name: organizationproductpermissionprofilegetuserproductpermissionprofiles
        method: GET
        description: Docusign Retrieves a list of user's permission profiles for each account's product.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: path
          type: string
          description: The organization's GUID.
          required: true
        - name: accountId
          in: path
          type: string
          description: The account ID GUID.
          required: true
        - name: userId
          in: path
          type: string
          description: The user ID GUID.
          required: true
      - name: organizationproductpermissionprofilepostuserproductpermissionprofiles
        method: POST
        description: Docusign Assigns user to permission profiles for one or more products.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: path
          type: string
          description: The organization's GUID.
          required: true
        - name: accountId
          in: path
          type: string
          description: The account ID GUID.
          required: true
        - name: userId
          in: path
          type: string
          description: The user ID GUID.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2.1-organizations-organizationId-accounts-accountId-users
      path: /v2.1/organizations/{organizationId}/accounts/{accountId}/users
      operations:
      - name: organizationuserorganizationuserspostaccountusersv21
        method: POST
        description: Docusign Creates and updates a multi-product user.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: path
          type: string
          description: The organization's GUID.
          required: true
        - name: accountId
          in: path
          type: string
          description: The account ID GUID.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: bearer
      token: '{{env.DOCUSIGN_API_KEY}}'
  exposes:
  - type: rest
    namespace: admin-multiproductusermanagement-rest
    port: 8080
    description: REST adapter for DocuSign Admin API — MultiProductUserManagement. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/v2-1/organizations/{organizationid}/accounts/{accountid}/dsgroups
      name: v2-1-organizations-organizationid-accounts-accountid-dsgroups
      description: REST surface for v2.1-organizations-organizationId-accounts-accountId-dsgroups.
      operations:
      - method: GET
        name: docusigngroupsv21getdsgroupsv21
        description: Docusign Returns a list of DSGroups.
        call: admin-multiproductusermanagement.docusigngroupsv21getdsgroupsv21
        with:
          organizationId: rest.organizationId
          accountId: rest.accountId
          page: rest.page
          page_size: rest.page_size
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: docusigngroupsv21adddsgroupv21
        description: Docusign Creates a new DSGroup.
        call: admin-multiproductusermanagement.docusigngroupsv21adddsgroupv21
        with:
          organizationId: rest.organizationId
          accountId: rest.accountId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2-1/organizations/{organizationid}/accounts/{accountid}/dsgroups/{dsgroupid}
      name: v2-1-organizations-organizationid-accounts-accountid-dsgroups-dsgroupid
      description: REST surface for v2.1-organizations-organizationId-accounts-accountId-dsgroups-dsGroupId.
      operations:
      - method: GET
        name: docusigngroupsv21getdsgroupv21
        description: Docusign Returns details about a single DSGroup.
        call: admin-multiproductusermanagement.docusigngroupsv21getdsgroupv21
        with:
          organizationId: rest.organizationId
          accountId: rest.accountId
          dsGroupId: rest.dsGroupId
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: docusigngroupsv21deletedsgroupv21
        description: Docusign Deletes a DSGroup.
        call: admin-multiproductusermanagement.docusigngroupsv21deletedsgroupv21
        with:
          organizationId: rest.organizationId
          accountId: rest.accountId
          dsGroupId: rest.dsGroupId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2-1/organizations/{organizationid}/accounts/{accountid}/dsgroups/{dsgroupid}/users
      name: v2-1-organizations-organizationid-accounts-accountid-dsgroups-dsgroupid-users
      description: REST surface for v2.1-organizations-organizationId-accounts-accountId-dsgroups-dsGroupId-users.
      operations:
      - method: GET
        name: docusigngroupsv21getdsgroupusersv21
        description: Docusign Gets a list of users in a DSGroup.
        call: admin-multiproductusermanagement.docusigngroupsv21getdsgroupusersv21
        with:
          organizationId: rest.organizationId
          accountId: rest.accountId
          dsGroupId: rest.dsGroupId
          page: rest.page
          page_size: rest.page_size
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: docusigngroupsv21adddsgroupusersv21
        description: Docusign Adds a list of users to a DSGroup.
        call: admin-multiproductusermanagement.docusigngroupsv21adddsgroupusersv21
        with:
          organizationId: rest.organizationId
          accountId: rest.accountId
          dsGroupId: rest.dsGroupId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: docusigngroupsv21removedsgroupusersv21
        description: Docusign Removes a list of users from a DSGroup.
        call: admin-multiproductusermanagement.docusigngroupsv21removedsgroupusersv21
        with:
          organizationId: rest.organizationId
          accountId: rest.accountId
          dsGroupId: rest.dsGroupId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2-1/organizations/{organizationid}/accounts/{accountid}/products/permission-profiles
      name: v2-1-organizations-organizationid-accounts-accountid-products-permission-profile
      description: REST surface for v2.1-organizations-organizationId-accounts-accountId-products-permission_profile.
      operations:
      - method: GET
        name: organizationproductpermissionprofilegetproductpermissionprofiles
        description: Docusign Gets products associated with the account and the available permission profiles.
        call: admin-multiproductusermanagement.organizationproductpermissionprofilegetproductpermissionprofiles
        with:
          organizationId: rest.organizationId
          accountId: rest.accountId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2-1/organizations/{organizationid}/accounts/{accountid}/products/users/{userid}/permission-profiles
      name: v2-1-organizations-organizationid-accounts-accountid-products-users-userid-permi
      description: REST surface for v2.1-organizations-organizationId-accounts-accountId-products-users-userId-permi.
      operations:
      - method: GET
        name: organizationproductpermissionprofilegetuserproductpermissionprofiles
        description: Docusign Retrieves a list of user's permission profiles for each account's product.
        call: admin-multiproductusermanagement.organizationproductpermissionprofilegetuserproductpermissionprofiles
        with:
          organizationId: rest.organizationId
          accountId: rest.accountId
          userId: rest.userId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: organizationproductpermissionprofilepostuserproductpermissionprofiles
        description: Docusign Assigns user to permission profiles for one or more products.
        call: admin-multiproductusermanagement.organizationproductpermissionprofilepostuserproductpermissionprofiles
        with:
          organizationId: rest.organizationId
          accountId: rest.accountId
          userId: rest.userId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2-1/organizations/{organizationid}/accounts/{accountid}/users
      name: v2-1-organizations-organizationid-accounts-accountid-users
      description: REST surface for v2.1-organizations-organizationId-accounts-accountId-users.
      operations:
      - method: POST
        name: organizationuserorganizationuserspostaccountusersv21
        description: Docusign Creates and updates a multi-product user.
        call: admin-multiproductusermanagement.organizationuserorganizationuserspostaccountusersv21
        with:
          organizationId: rest.organizationId
          accountId: rest.accountId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: admin-multiproductusermanagement-mcp
    port: 9090
    transport: http
    description: MCP adapter for DocuSign Admin API — MultiProductUserManagement. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: docusign-returns-list-dsgroups
      description: Docusign Returns a list of DSGroups.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: admin-multiproductusermanagement.docusigngroupsv21getdsgroupsv21
      with:
        organizationId: tools.organizationId
        accountId: tools.accountId
        page: tools.page
        page_size: tools.page_size
      outputParameters:
      - type: object
        mapping: $.
    - name: docusign-creates-new-dsgroup
      description: Docusign Creates a new DSGroup.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: admin-multiproductusermanagement.docusigngroupsv21adddsgroupv21
      with:
        organizationId: tools.organizationId
        accountId: tools.accountId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: docusign-returns-details-about-single
      description: Docusign Returns details about a single DSGroup.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: admin-multiproductusermanagement.docusigngroupsv21getdsgroupv21
      with:
        organizationId: tools.organizationId
        accountId: tools.accountId
        dsGroupId: tools.dsGroupId
      outputParameters:
      - type: object
        mapping: $.
    - name: docusign-deletes-dsgroup
      description: Docusign Deletes a DSGroup.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: admin-multiproductusermanagement.docusigngroupsv21deletedsgroupv21
      with:
        organizationId: tools.organizationId
        accountId: tools.accountId
        dsGroupId: tools.dsGroupId
      outputParameters:
      - type: object
        mapping: $.
    - name: docusign-gets-list-users-dsgroup
      description: Docusign Gets a list of users in a DSGroup.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: admin-multiproductusermanagement.docusigngroupsv21getdsgroupusersv21
      with:
        organizationId: tools.organizationId
        accountId: tools.accountId
        dsGroupId: tools.dsGroupId
        page: tools.page
        page_size: tools.page_size
      outputParameters:
      - type: object
        mapping: $.
    - name: docusign-adds-list-users-dsgroup
      description: Docusign Adds a list of users to a DSGroup.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: admin-multiproductusermanagement.docusigngroupsv21adddsgroupusersv21
      with:
        organizationId: tools.organizationId
        accountId: tools.accountId
        dsGroupId: tools.dsGroupId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: docusign-removes-list-users-dsgroup
      description: Docusign Removes a list of users from a DSGroup.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: admin-multiproductusermanagement.docusigngroupsv21removedsgroupusersv21
      with:
        organizationId: tools.organizationId
        accountId: tools.accountId
        dsGroupId: tools.dsGroupId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: docusign-gets-products-associated-account
      description: Docusign Gets products associated with the account and the available permission profiles.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: admin-multiproductusermanagement.organizationproductpermissionprofilegetproductpermissionprofiles
      with:
        organizationId: tools.organizationId
        accountId: tools.accountId
      outputParameters:
      - type: object
        mapping: $.
    - name: docusign-retrieves-list-user-s-permission
      description: Docusign Retrieves a list of user's permission profiles for each account's product.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: admin-multiproductusermanagement.organizationproductpermissionprofilegetuserproductpermissionprofiles
      with:
        organizationId: tools.organizationId
        accountId: tools.accountId
        userId: tools.userId
      outputParameters:
      - type: object
        mapping: $.
    - name: docusign-assigns-user-permission-profiles
      description: Docusign Assigns user to permission profiles for one or more products.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: admin-multiproductusermanagement.organizationproductpermissionprofilepostuserproductpermissionprofiles
      with:
        organizationId: tools.organizationId
        accountId: tools.accountId
        userId: tools.userId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: docusign-creates-and-updates-multi
      description: Docusign Creates and updates a multi-product user.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: admin-multiproductusermanagement.organizationuserorganizationuserspostaccountusersv21
      with:
        organizationId: tools.organizationId
        accountId: tools.accountId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.