Dropbox Sign/apiAppUpdate

Preview only · details below

Dropbox SignDropbox Sign eSignature API

PUT/api_app/{client_id}

Update API App

Updates an existing API App. Can only be invoked for apps you own. Only the fields you provide will be updated. If you wish to clear an existing optional field, provide an empty string.

Manage accounts, signature requests, templates, teams, bulk sends, file downloads, fax, and event callbacks through the complete Dropbox Sign v3 API; the Hub provides documentation and a local SDK/CLI only.

Request

operationId
apiAppUpdate
Server
https://api.hellosign.com/v3
Authentication
api_key, oauth2

Request parameters

client_id

pathstringrequired

The client id of the API App to update.

0dd3b823a682527788c4e40cb7b6f7e9

Request body

ApiAppUpdateRequestrequired

Content-Type: application/json, multipart/form-data

Properties: callback_urlcustom_logo_filedomainsnameoauthoptionswhite_labeling_options

{
  "callback_url": "https://example.com/resource",
  "domains": [
    {}
  ],
  "name": "Example Name",
  "oauth": {
    "callback_url": "https://example.com/resource",
    "scopes": [
      "request_signature"
    ]
  },
  "options": {
    "can_insert_everywhere": false
  },
  "white_labeling_options": {
    "header_background_color": "#1a1a1a",
    "legal_version": "terms1",
    "link_color": "#0061FE",
    "page_background_color": "#f7f8f9",
    "primary_button_color": "#0061FE",
    "primary_button_color_hover": "#0061FE",
    "primary_button_text_color": "#ffffff",
    "primary_button_text_color_hover": "#ffffff"
  }
}

Responses

200

ApiAppGetResponseapplication/json

successful operation

Properties: api_appwarnings

4XX

ErrorResponseapplication/json

failed_operation

Properties: error

{
  "api_app": {
    "callback_url": "https://example.com/resource",
    "client_id": "example-client-id",
    "created_at": 0,
    "domains": [
      {}
    ],
    "name": "Example Name",
    "is_approved": false,
    "oauth": {
      "callback_url": "https://example.com/resource",
      "scopes": [
        {}
      ],
      "charges_users": false
    },
    "options": {
      "can_insert_everywhere": false
    }
  },
  "warnings": [
    {
      "warning_name": "Example Name"
    }
  ]
}