Dropbox Sign Developer Documentation

Retrieves an embedded object containing a template url that can be opened in an iFrame. Note that only templates created via the embedded template process are available to be edited with this endpoint.

Authentication

AuthorizationBasic

Basic authentication of the form Basic <username:password>.

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

template_idstringRequired

The id of the template to edit.

Request

This endpoint expects an object.

allow_edit_ccsbooleanOptionalDefaults to false

This allows the requester to enable/disable to add or change CC roles when editing the template.

cc_roleslist of stringsOptional

The CC roles that must be assigned when using the template to send a signature request. To remove all CC roles, pass in a single role with no name. For use in a POST request.

editor_optionsobjectOptional

This allows the requester to specify editor options when a preparing a document

force_signer_rolesbooleanOptionalDefaults to false

Provide users the ability to review/edit the template signer roles.

force_subject_messagebooleanOptionalDefaults to false

Provide users the ability to review/edit the template subject and message.

merge_fieldslist of objectsOptional

Add additional merge fields to the template, which can be used used to pre-fill data by passing values into signature requests made with that template.

Remove all merge fields on the template by passing an empty array [].

preview_onlybooleanOptionalDefaults to false

This allows the requester to enable the preview experience (i.e. does not allow the requester’s end user to add any additional fields via the editor).

NOTE: This parameter overwrites show_preview=true (if set).

show_previewbooleanOptionalDefaults to false

This allows the requester to enable the editor/preview experience.

show_progress_stepperbooleanOptionalDefaults to true

When only one step remains in the signature request process and this parameter is set to false then the progress stepper will be hidden.

test_modebooleanOptionalDefaults to false

Whether this is a test, locked templates will only be available for editing if this is set to true. Defaults to false.

Response headers

X-RateLimit-Limitinteger

The maximum number of requests per hour that you can make.

X-RateLimit-Remaininginteger

The number of requests remaining in the current rate limit window.

X-Ratelimit-Resetinteger

The Unix time at which the rate limit will reset to its maximum.

Response

successful operation

embeddedobject

An embedded template object.

warningslist of objects or null

A list of warnings.

1	using System;
2	using System.Collections.Generic;
3	using System.IO;
4	using System.Text.Json;
5
6	using Dropbox.Sign.Api;
7	using Dropbox.Sign.Client;
8	using Dropbox.Sign.Model;
9
10	namespace Dropbox.SignSandbox;
11
12	public class EmbeddedEditUrlExample
13	{
14	public static void Run()
15	{
16	var config = new Configuration();
17	config.Username = "YOUR_API_KEY";
18	// config.AccessToken = "YOUR_ACCESS_TOKEN";
19
20	var mergeFields = new List<SubMergeField>();
21
22	var embeddedEditUrlRequest = new EmbeddedEditUrlRequest(
23	ccRoles: [
24	"",
25	],
26	mergeFields: mergeFields
27	);
28
29	try
30	{
31	var response = new EmbeddedApi(config).EmbeddedEditUrl(
32	templateId: "f57db65d3f933b5316d398057a36176831451a35",
33	embeddedEditUrlRequest: embeddedEditUrlRequest
34	);
35
36	Console.WriteLine(response);
37	}
38	catch (ApiException e)
39	{
40	Console.WriteLine("Exception when calling EmbeddedApi#EmbeddedEditUrl: " + e.Message);
41	Console.WriteLine("Status Code: " + e.ErrorCode);
42	Console.WriteLine(e.StackTrace);
43	}
44	}
45	}

Get Embedded Template Edit URL

Authentication

Path parameters

Request

Response headers

Response

Errors

1	{
2	"embedded": {
3	"edit_url": "https://app.hellosign.com/editor/embeddedTemplate?token=70ca8e5779c9a931125db09f3170efc1&root_snapshot_guids[]=a97ce534aec6cbe09e70cdd55112e31bd320ed00&edited_template_guid=61a832ff0d8423f91d503e76bfbcc750f7417c78&guid=56ecaf0659aa29215d2ee489c0c88ff8c9496099&force_signer_input=1",
4	"expires_at": 1634313821
5	}
6	}