Docusign

Docusign AccountWatermarks API

The AccountWatermarks resource provides methods that allow you to obtain, preview and update watermark information.

Documentation GitHub OpenAPI

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v2/accounts/{accountId}/watermark Get the account watermark settings · Docusign Get watermark information #

Ask an LLM

“What watermark is applied to our documents right now?”

“Is a watermark currently enabled on my account?”

Tell an agent

Get the watermark settings for account {account}.

Show the current document watermark on account {account}.

PUT /v2/accounts/{accountId}/watermark Change the account watermark · Docusign Update watermark information #

Ask an LLM

“How do I change the watermark text or font on our documents?”

“Can I turn the account watermark on or off?”

Tell an agent

Set the watermark text on account {account} to {text_value}.

Change the watermark on account {account} to font size {size} at transparency {transparency}.

PUT /v2/accounts/{accountId}/watermark/preview Preview a watermark before saving it · Docusign Get watermark preview #

Ask an LLM

“Can I see what a watermark looks like before applying it?”

“Is there a way to test watermark angle and color without saving?”

Tell an agent

Preview watermark text {text_value} for account {account}.

Show a preview of a watermark at angle {angle} in color {color} without saving.

GET /v2.1/accounts/{accountId}/watermark Get watermark information #

PUT /v2.1/accounts/{accountId}/watermark Update watermark information #

PUT /v2.1/accounts/{accountId}/watermark/preview Get watermark preview #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/docusign:docusign-accountwatermarks-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Docusign Account Watermarks API
  termsOfService: https://www.docusign.com/company/terms-and-conditions/web
  version: '1.0'
  description: 'Operations tagged AccountWatermarks across 2 of this provider''s published API definitions: docusign-openapi-original.yml, docusign-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.docusign.net/restapi
tags:
- name: AccountWatermarks
  description: The AccountWatermarks resource provides methods that allow you to obtain, preview and update watermark information.
paths:
  /v2/accounts/{accountId}/watermark:
    get:
      tags:
      - AccountWatermarks
      summary: Docusign Get watermark information
      operationId: Watermark_GetWatermark
      parameters:
      - name: accountId
        in: path
        description: The external account number (int) or account id GUID.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response.
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/watermark'
        '400':
          description: Error encountered.
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/errorDetails'
      deprecated: false
      x-ds-methodname: getWatermark
      x-ds-method: get
      x-ds-service: Accounts
      x-ds-in-sdk: true
    put:
      tags:
      - AccountWatermarks
      summary: Docusign Update watermark information
      operationId: Watermark_PutWatermark
      parameters:
      - name: accountId
        in: path
        description: The external account number (int) or account id GUID.
        required: true
        schema:
          type: string
      requestBody:
        description: 'When set to **true**, the account has the watermark feature enabled, and the envelope is not complete, the watermark for the account is added to the PDF documents. This option can remove the watermark. '
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/watermark'
          application/xml:
            schema:
              $ref: '#/components/schemas/watermark'
        required: false
      responses:
        '200':
          description: Successful response.
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/watermark'
        '400':
          description: Error encountered.
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/errorDetails'
      deprecated: false
      x-ds-methodname: updateWatermark
      x-ds-method: update
      x-ds-service: Accounts
      x-ds-in-sdk: true
      x-codegen-request-body-name: watermark
    servers:
    - url: https://www.docusign.net/restapi
  /v2/accounts/{accountId}/watermark/preview:
    put:
      tags:
      - AccountWatermarks
      summary: Docusign Get watermark preview
      operationId: WatermarkPreview_PutWatermarkPreview
      parameters:
      - name: accountId
        in: path
        description: The external account number (int) or account id GUID.
        required: true
        schema:
          type: string
      requestBody:
        description: 'When set to **true**, the account has the watermark feature enabled, and the envelope is not complete, the watermark for the account is added to the PDF documents. This option can remove the watermark. '
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/watermark'
          application/xml:
            schema:
              $ref: '#/components/schemas/watermark'
        required: false
      responses:
        '200':
          description: Successful response.
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/watermark'
        '400':
          description: Error encountered.
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/errorDetails'
      deprecated: false
      x-ds-methodname: getWatermarkPreview
      x-ds-method: preview
      x-ds-service: Accounts
      x-ds-in-sdk: true
      x-codegen-request-body-name: watermark
    servers:
    - url: https://www.docusign.net/restapi
  /v2.1/accounts/{accountId}/watermark:
    parameters: []
    get:
      tags:
      - AccountWatermarks
      summary: Get watermark information
      operationId: getV21AccountsByAccountIdWatermark
      parameters:
      - name: accountId
        in: path
        description: The external account number (int) or account ID GUID.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/watermark_2'
        '400':
          description: Error encountered.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorDetails_2'
      deprecated: false
      x-ds-methodname: getWatermark
      description: Enables you to preview a watermark specified by the request.
      x-ds-method: get
      x-ds-service: Accounts
      x-ds-in-sdk: true
      x-operation-id-source: normalized
      x-operation-id-original: Watermark_GetWatermark
    put:
      tags:
      - AccountWatermarks
      summary: Update watermark information
      operationId: putV21AccountsByAccountIdWatermark
      parameters:
      - name: accountId
        in: path
        description: The external account number (int) or account ID GUID.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/watermark_2'
        '400':
          description: Error encountered.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorDetails_2'
      deprecated: false
      x-ds-methodname: updateWatermark
      description: Returns information about the watermark for the account.
      x-ds-method: update
      x-ds-service: Accounts
      x-ds-in-sdk: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/watermark_2'
          application/xml:
            schema:
              $ref: '#/components/schemas/watermark_2'
        description: 'When **true,** the account has the watermark feature enabled, and the envelope is not complete, then the watermark for the account is added to the PDF documents. This option can remove the watermark. '
      x-operation-id-source: normalized
      x-operation-id-original: Watermark_PutWatermark
    servers:
    - url: https://www.docusign.net/restapi
  /v2.1/accounts/{accountId}/watermark/preview:
    parameters: []
    put:
      tags:
      - AccountWatermarks
      summary: Get watermark preview
      operationId: putV21AccountsByAccountIdWatermarkPreview
      parameters:
      - name: accountId
        in: path
        description: The external account number (int) or account ID GUID.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/watermark_2'
        '400':
          description: Error encountered.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorDetails_2'
      deprecated: false
      x-ds-methodname: getWatermarkPreview
      description: 'Update the watermark for the account.


        **Note:** Many of the request fields must be set to specific values. If you use an invalid value for one of these fields, the endpoint may return 200 OK but set the field to a default value. See the request body for more information.'
      x-ds-method: preview
      x-ds-service: Accounts
      x-ds-in-sdk: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/watermark_2'
          application/xml:
            schema:
              $ref: '#/components/schemas/watermark_2'
        description: 'When **true,** the account has the watermark feature enabled, and the envelope is not complete, then the watermark for the account is added to the PDF documents. This option can remove the watermark. '
      x-operation-id-source: normalized
      x-operation-id-original: WatermarkPreview_PutWatermarkPreview
    servers:
    - url: https://www.docusign.net/restapi
components:
  schemas:
    watermark:
      type: object
      properties:
        displayAngle:
          type: string
          description: ''
        enabled:
          type: string
          description: ''
        font:
          type: string
          description: 'The font to be used for the tab value. Supported Fonts include:


            - Default

            - Arial

            - ArialNarrow

            - Calibri

            - CourierNew

            - Garamond

            - Georgia

            - Helvetica

            - LucidaConsole

            - MSGothic

            - MSMincho

            - OCR-A

            - Tahoma

            - TimesNewRoman

            - Trebuchet

            - Verdana

            '
        fontColor:
          type: string
          description: "The font color used for the information in the tab. Possible values are: \n\n- Black\n- BrightBlue\n- BrightRed\n- DarkGreen\n- DarkRed\n- Gold\n- Green\n- NavyBlue\n- Purple\n- White\n"
        fontSize:
          type: string
          description: 'The font size used for the information in the tab. Possible values are:


            - Size7

            - Size8

            - Size9

            - Size10

            - Size11

            - Size12

            - Size14

            - Size16

            - Size18

            - Size20

            - Size22

            - Size24

            - Size26

            - Size28

            - Size36

            - Size48

            - Size72'
        id:
          type: string
          description: ''
        imageBase64:
          type: string
          description: ''
        transparency:
          type: string
          description: ''
        watermarkText:
          type: string
          description: ''
      description: ''
      x-ds-definition-name: watermark
      x-ms-summary: ''
    errorDetails:
      type: object
      properties:
        errorCode:
          type: string
          description: An error code associated with the error.
        message:
          type: string
          description: A short error message.
      description: This object describes errors that occur. It is only valid for responses, and ignored in requests.
      x-ds-definition-name: errorDetails
      x-ms-summary: This object describes errors that occur. It is only valid for responses, and ignored in requests.
    watermark_2:
      type: object
      properties:
        displayAngle:
          description: 'The display angle of the watermark. Valid values:


            * 0 (horizontal)

            * 45 (diagonal)

            * 90 (vertical)'
          type: string
        enabled:
          description: When **true,** the watermark will be applied to documents that are still in progress. When **false,** the watermark will not be applied.
          type: string
        font:
          description: 'The watermark''s font. Valid values:


            - `courier`

            - `helvetica`

            - `timesnewroman`

            '
          type: string
        fontColor:
          description: 'The watermark''s font color. Valid values:


            * `black`

            * `blue`

            * `red`

            * `gray`

            * `yellow`'
          type: string
        fontSize:
          description: 'The watermark''s font size. Valid values:


            * `30`

            * `40`

            * `50`

            * `60`

            * `70`

            * `80`

            * `90`'
          type: string
        id:
          description: The ID of the watermark.
          type: string
        imageBase64:
          description: 'The Base64 representation of the watermark image.


            This property is read-only.'
          type: string
        transparency:
          description: 'The transparency percentage of the watermark image. Valid values:


            * `5`

            * `10`

            * `15`

            * `20`

            * `25`

            * `30`

            * `35`

            * `40`

            * `45`'
          type: string
        watermarkText:
          description: The text for the watermark.
          type: string
      x-ds-definition-name: watermark
      description: ''
      x-ms-summary: ''
    errorDetails_2:
      description: This object describes errors that occur. It is only valid for responses and ignored in requests.
      type: object
      properties:
        errorCode:
          description: The code associated with the error condition.
          type: string
        message:
          description: A brief message describing the error condition.
          type: string
      x-ds-definition-name: errorDetails
      x-ms-summary: This object describes errors that occur. It is only valid for responses and ignored in requests.
x-refined-from:
- docusign-openapi-original.yml
- docusign-openapi.json
x-ds-categories:
- name: UserManagement
  summary: Methods to manage users in an account.
  description: Methods to manage users in an account.
- name: BulkOperations
  summary: Methods to import and export users and accounts.
  description: Methods to import and export users and accounts.
- name: IdentityProviders
  summary: Methods to get a list of identity providers.
  description: Methods to get a list of identity providers.
- name: ReservedDomains
  summary: Methods to get a list of reserved domains.
  description: Methods to get a list of reserved domains.
- name: Organization
  summary: Methods for working with organizations.
  description: Methods for working with organizations.
x-original-swagger-version: '2.0'

Docusign AccountWatermarks API

Operations 6

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification