naftiko: 1.0.0-alpha2
info:
  label: DocuSign eSignature REST API — Recipients
  description: 'DocuSign eSignature REST API — Recipients. 4 operations. Lead operation: Docusign List Envelope Recipients.
    Self-contained Naftiko capability covering one Docusign business surface.'
  tags:
  - Docusign
  - Recipients
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    DOCUSIGN_API_KEY: DOCUSIGN_API_KEY
capability:
  consumes:
  - type: http
    namespace: esignature-recipients
    baseUri: https://demo.docusign.net/restapi/v2.1
    description: DocuSign eSignature REST API — Recipients business capability. Self-contained, no shared references.
    resources:
    - name: accounts-accountId-envelopes-envelopeId-recipients
      path: /accounts/{accountId}/envelopes/{envelopeId}/recipients
      operations:
      - name: recipientslistrecipients
        method: GET
        description: Docusign List Envelope Recipients
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: include_tabs
          in: query
          type: string
          description: When true, includes the tabs associated with each recipient.
        - name: include_extended
          in: query
          type: string
          description: When true, includes extended recipient information.
      - name: recipientsupdaterecipients
        method: PUT
        description: Docusign Update Envelope Recipients
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: resend_envelope
          in: query
          type: string
          description: When true, resends the envelope to updated recipients.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: recipientscreaterecipients
        method: POST
        description: Docusign Add Recipients to an Envelope
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: resend_envelope
          in: query
          type: string
          description: When true, resends the envelope after adding recipients.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: recipientsdeleterecipients
        method: DELETE
        description: Docusign Delete Recipients From an Envelope
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: bearer
      token: '{{env.DOCUSIGN_API_KEY}}'
  exposes:
  - type: rest
    namespace: esignature-recipients-rest
    port: 8080
    description: REST adapter for DocuSign eSignature REST API — Recipients. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/accounts/{accountid}/envelopes/{envelopeid}/recipients
      name: accounts-accountid-envelopes-envelopeid-recipients
      description: REST surface for accounts-accountId-envelopes-envelopeId-recipients.
      operations:
      - method: GET
        name: recipientslistrecipients
        description: Docusign List Envelope Recipients
        call: esignature-recipients.recipientslistrecipients
        with:
          include_tabs: rest.include_tabs
          include_extended: rest.include_extended
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: recipientsupdaterecipients
        description: Docusign Update Envelope Recipients
        call: esignature-recipients.recipientsupdaterecipients
        with:
          resend_envelope: rest.resend_envelope
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: recipientscreaterecipients
        description: Docusign Add Recipients to an Envelope
        call: esignature-recipients.recipientscreaterecipients
        with:
          resend_envelope: rest.resend_envelope
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: recipientsdeleterecipients
        description: Docusign Delete Recipients From an Envelope
        call: esignature-recipients.recipientsdeleterecipients
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: esignature-recipients-mcp
    port: 9090
    transport: http
    description: MCP adapter for DocuSign eSignature REST API — Recipients. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: docusign-list-envelope-recipients
      description: Docusign List Envelope Recipients
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: esignature-recipients.recipientslistrecipients
      with:
        include_tabs: tools.include_tabs
        include_extended: tools.include_extended
      outputParameters:
      - type: object
        mapping: $.
    - name: docusign-update-envelope-recipients
      description: Docusign Update Envelope Recipients
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: esignature-recipients.recipientsupdaterecipients
      with:
        resend_envelope: tools.resend_envelope
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: docusign-add-recipients-envelope
      description: Docusign Add Recipients to an Envelope
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: esignature-recipients.recipientscreaterecipients
      with:
        resend_envelope: tools.resend_envelope
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: docusign-delete-recipients-envelope
      description: Docusign Delete Recipients From an Envelope
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: esignature-recipients.recipientsdeleterecipients
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.