{"openapi":"3.1.0","info":{"title":"Dropbox Sign Apps (BYOK) API","version":"0.1.0","description":"Dropbox Sign Apps (BYOK) lets an AI assistant read your own Dropbox Sign Apps data through the Dropbox Sign Apps API with a key you supply (Dropbox Sign API key). Read-only: 6 tools (list_api_apps, get_api_app, list_sub_teams, list_fax_lines, get_fax_line, list_fax_line_area_codes). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-dropboxsign-apps.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-dropboxsign-apps/docs"},"termsOfService":"https://connectorbay.com/byok-dropboxsign-apps/terms"},"servers":[{"url":"https://byok-dropboxsign-apps.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-dropboxsign-apps/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_api_apps":{"post":{"operationId":"list_api_apps","summary":"List API apps you can access (including teammates' apps for admins and developers) with name, client id, domains, approv","description":"List API apps you can access (including teammates' apps for admins and developers) with name, client id, domains, approval state and OAuth scopes; secrets are not returned. Use for \"Which Dropbox Sign API apps are registered and are they approved\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Results per page (1 to 100; the API default is 20).","title":"Page Size"}},"title":"list_api_appsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_api_app":{"post":{"operationId":"get_api_app","summary":"Get one API app by client id: name, domains, approval state, options, OAuth scopes and owner account id (the OAuth secre","description":"Get one API app by client id: name, domains, approval state, options, OAuth scopes and owner account id (the OAuth secret is not returned). Use for \"Show the Dropbox Sign API app with client id 0dd3b823a682527788c4e40cb7b6f7e9\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"client_id":{"description":"Client id of the API app, as returned by list_api_apps.","maxLength":200,"title":"Client Id","type":"string"}},"required":["client_id"],"title":"get_api_appArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_sub_teams":{"post":{"operationId":"list_sub_teams","summary":"List the sub teams of a team with team id and name. Use for \"What sub teams does my Dropbox Sign team have\".","description":"List the sub teams of a team with team id and name. Use for \"What sub teams does my Dropbox Sign team have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"team_id":{"description":"Id of the parent team (the team_id from your account).","maxLength":200,"title":"Team Id","type":"string"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Results per page (1 to 100; the API default is 20).","title":"Page Size"}},"required":["team_id"],"title":"list_sub_teamsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_fax_lines":{"post":{"operationId":"list_fax_lines","summary":"List fax lines with number and creation/update times (the accounts using each line are not returned). Use for \"Which Dro","description":"List fax lines with number and creation/update times (the accounts using each line are not returned). Use for \"Which Dropbox Fax lines do I have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only lines of this account id.","title":"Account Id"},"show_team_lines":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to include lines of team members.","title":"Show Team Lines"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Results per page (1 to 100; the API default is 20).","title":"Page Size"}},"title":"list_fax_linesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_fax_line":{"post":{"operationId":"get_fax_line","summary":"Get one fax line's number and creation/update times (the accounts using the line are not returned). Use for \"When was my","description":"Get one fax line's number and creation/update times (the accounts using the line are not returned). Use for \"When was my Dropbox Fax line +14155550100 created\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"number":{"description":"The fax line number, for example +14155550100.","maxLength":30,"title":"Number","type":"string"}},"required":["number"],"title":"get_fax_lineArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_fax_line_area_codes":{"post":{"operationId":"list_fax_line_area_codes","summary":"List the area codes available for new fax lines in a country, optionally narrowed by state or province and city. Use for","description":"List the area codes available for new fax lines in a country, optionally narrowed by state or province and city. Use for \"Which fax line area codes are available in San Francisco, California\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"Country: CA, US or UK.","enum":["CA","US","UK"],"title":"Country","type":"string"},"state":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter US state code, for example CA.","title":"State"},"province":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter Canadian province code, for example ON.","title":"Province"},"city":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"City name to narrow the area codes.","title":"City"}},"required":["country"],"title":"list_fax_line_area_codesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}