Schemas

`BulkRowIn`

Member	Type	Notes
`form_values`	`object of string`	Prefills keyed by field name, or by field index as a string.
`recipients` required	`array of object of any`	One entry per template placeholder, in signing position: {name, email, auth_level?}.

`BulkRowOut`

Member	Type	Notes
`delivery_state`	`string \| null`
`document_id`	`string \| null`
`error`	`string \| null`
`recipients` required	`array of object of any`
`row_no` required	`integer`
`sent_at`	`string (date-time) \| null`
`status` required	`"invalid" \| "queued" \| "sending" \| "sent" \| "failed" \| "canceled"`

`BulkSendOut`

Member	Type	Notes
`canceled_count` required	`integer`
`created_at` required	`string (date-time)`
`dispatched_at`	`string (date-time) \| null`
`failed_count` required	`integer`
`finished_at`	`string (date-time) \| null`
`id` required	`string`
`mode` required	`"live" \| "test"`
`review_flagged` required	`boolean`
`row_count` required	`integer`
`rows`	`array of BulkRowOut \| null`BulkRowOut
`sent_count` required	`integer`
`source_filename`	`string \| null`
`status` required	`"draft" \| "invalid" \| "ready" \| "dispatching" \| "done" \| "failed" \| "canceled"`
`template_id` required	`string`

`BulkSendPage`

Member	Type	Notes
`items` required	`array of BulkSendOut`BulkSendOut
`limit` required	`integer`
`offset` required	`integer`
`total` required	`integer`

`CreateBulkSendIn`

Member	Type	Notes
`rows` required	`array of BulkRowIn`BulkRowIn
`source_filename`	`string (max length 300) \| null`
`template_id` required	`string`	A tpl_… id.

`CreateDocumentReq`

Member	Type	Notes
`date_format`	`string \| null`
`display_timezone`	`string \| null`
`expires_at`	`string (date-time) \| null`
`fields`	`array of FieldSpec`FieldSpec
`message`	`string \| null`
`recipients`	`array of RecipientSpec`RecipientSpec
`redirect_url`	`string \| null`
`reminder_cadence_days`	`integer (>= 1) \| null`
`title` required	`string (min length 1, max length 300)`
`visibility`	`string`	Default `"everyone"`.

`CreateKeyReq`

Member	Type	Notes
`mode`	`string (pattern ^(live\|test)$)`	Default `"live"`.
`name` required	`string (min length 1, max length 120)`

`CreateTemplateIn`

Member	Type	Notes
`fields`	`array of FieldSpec`FieldSpec
`name` required	`string (min length 1, max length 300)`
`pdf_base64` required	`string`
`recipients`	`array of RecipientSpec`RecipientSpec

`CreateWebhookReq`

Member	Type	Notes
`events`	`array of string`
`url` required	`string (max length 2000)`

`DeliveryOut`

Member	Type	Notes
`attempt` required	`integer`
`created_at` required	`string`
`delivered_at`	`string \| null`
`event_type` required	`string`
`id` required	`integer`
`last_error`	`string \| null`
`next_retry_at`	`string \| null`
`response_code`	`integer \| null`
`status` required	`string`

`DeviceCodeOut`

Member	Type	Notes
`device_code` required	`string`
`expires_in` required	`integer`
`interval` required	`integer`
`user_code` required	`string`
`verification_uri` required	`string`
`verification_uri_complete` required	`string`

`DeviceCodeReq`

Member	Type	Notes
`client` required	`string (pattern ^[a-z][a-z0-9-]{0,31}$)`	e.g. senv
`client_version`	`string (max length 64) \| null`
`mode`	`"live" \| "test"`	Default `"live"`.
`name`	`string (max length 100) \| null`	Name for the key the human approves

`DeviceTokenOut`

Member	Type	Notes
`api_key` required	`string`
`display` required	`string`
`key_id` required	`string (uuid)`
`mode` required	`string`
`name` required	`string`
`tenant_slug` required	`string`

`DeviceTokenReq`

Member	Type	Notes
`device_code` required	`string (min length 16, max length 128)`

`DocumentAwaitingUpload`

`GET /documents/{id}` for a draft whose PDF has not been finalized.

Member	Type	Notes
`id` required	`string`
`status` required	`"awaiting_upload"`
`title`	`string \| null`

`DocumentDraftOut`

Member	Type	Notes
`expiresAt` required	`string (date-time)`
`id` required	`string`
`status`	`string`	Default `"awaiting_upload"`.
`uploadUrl` required	`string`

`DocumentOut`

Member	Type	Notes
`completed_at`	`string (date-time) \| null`
`created_at` required	`string (date-time)`
`date_format`	`string \| null`
`delivery_problem`	`boolean`	Default `false`.
`display_timezone`	`string \| null`
`expires_at`	`string (date-time) \| null`
`fields`	`array of FieldOut`FieldOut
`folder_id`	`string (uuid) \| null`
`id` required	`string`	Public document id, `doc_…`
`message`	`string \| null`
`mode`	`"live" \| "test"`	Default `"live"`.
`original_sha256` required	`string`
`recipients`	`array of RecipientOut`RecipientOut
`redirect_url`	`string \| null`
`reminder_cadence_days`	`integer \| null`
`seal_profile`	`string \| null`
`sealed`	`boolean`	Default `false`.
`sent_at`	`string (date-time) \| null`
`size_bytes` required	`integer`
`source_template_id`	`string (uuid) \| null`
`status` required	`"draft" \| "sent" \| "partially_signed" \| "completed" \| "voided" \| "rejected" \| "expired"`
`team_id` required	`string (uuid)`
`title` required	`string`
`visibility` required	`"everyone" \| "managers"`

`DocumentPage`

Member	Type	Notes
`items` required	`array of DocumentOut`DocumentOut
`limit` required	`integer`
`offset` required	`integer`
`total` required	`integer`

`DuplicateDocumentIn`

Member	Type	Notes
`title`	`string (min length 1, max length 300) \| null`

`DuplicateTemplateIn`

Member	Type	Notes
`name`	`string (min length 1, max length 300) \| null`

`EnvelopePatch`

Post-create mutable surface: display prefs, folder, visibility. Structural changes (recipients/fields) go through their own setters and are draft-only.

Member	Type	Notes
`clear_folder`	`boolean`	Default `false`.
`date_format`	`string \| null`
`display_timezone`	`string \| null`
`folder_id`	`string (uuid) \| null`
`redirect_url`	`string \| null`
`reminder_cadence_days`	`integer (>= 0) \| null`
`visibility`	`"everyone" \| "managers" \| null`

`Envelopes`

Member	Type	Notes
`allowance` required	`integer`
`remaining` required	`integer`
`resets_on` required	`string`
`used` required	`integer`

`EventOut`

Member	Type	Notes
`actor` required	`object of any`
`created_at_iso` required	`string`
`envelope_id` required	`string`
`event_type` required	`string`
`hash` required	`string`
`ip`	`string \| null`
`payload` required	`object of any`
`payload_hash` required	`string`
`prev_hash` required	`string`
`seq` required	`integer`
`user_agent`	`string \| null`

`FairUse`

Member	Type	Notes
`burst_rps` required	`number`
`envelopes_per_day_review_threshold`	`integer`	Default `2000`.
`sustained_rps` required	`number`

`FieldOut`

Member	Type	Notes
`completed_at`	`string (date-time) \| null`
`envelope_id` required	`string`
`h` required	`number`
`id` required	`string (uuid)`
`name`	`string \| null`
`page` required	`integer`
`prefill_value`	`string \| null`
`read_only` required	`boolean`
`recipient_id` required	`string (uuid) \| null`
`required` required	`boolean`
`settings` required	`FieldSettings`FieldSettings
`type` required	`"signature" \| "initials" \| "name" \| "email" \| "date" \| "text" \| "number" \| "checkbox" \| "radio" \| "dropdown"`
`value`	`string \| null`
`w` required	`number`
`x` required	`number`
`y` required	`number`

`FieldSettings`

F-12 field settings — enforced server-side at completion.

Member	Type	Notes
`input_modes`	`array of "draw" \| "type" \| "upload" \| null`
`max_length`	`integer (>= 1) \| null`
`max_value`	`number \| null`
`min_value`	`number \| null`
`options`	`array of string \| null`
`pattern`	`string \| null`

`FieldSpec`

Member	Type	Notes
`h` required	`number (<= 1)`
`name`	`string (max length 100, pattern ^[A-Za-z][A-Za-z0-9_.-]*$) \| null`
`page` required	`integer (>= 1)`
`prefill_value`	`string \| null`
`read_only`	`boolean`	Default `false`.
`recipient_index` required	`integer (>= 0)`
`required`	`boolean`	Default `true`.
`settings`	`FieldSettings`FieldSettings
`type` required	`"signature" \| "initials" \| "name" \| "email" \| "date" \| "text" \| "number" \| "checkbox" \| "radio" \| "dropdown"`
`w` required	`number (<= 1)`
`x` required	`number (>= 0, <= 1)`
`y` required	`number (>= 0, <= 1)`

`FolderIn`

Member	Type	Notes
`name` required	`string (min length 1, max length 120)`
`parent_id`	`string (uuid) \| null`

`FolderOut`

Member	Type	Notes
`depth` required	`integer`	1 for a root folder; at most 5
`id` required	`string (uuid)`
`name` required	`string`
`parent_id`	`string (uuid) \| null`

`FolderPatchIn`

Member	Type	Notes
`move_to_root`	`boolean`	Default `false`.
`name`	`string (min length 1, max length 120) \| null`
`parent_id`	`string (uuid) \| null`

`HTTPValidationError`

Member	Type	Notes
`detail`	`array of ValidationError`ValidationError

`KeyCreated`

Member	Type	Notes
`created_at`	`string \| null`
`display` required	`string`
`expires_at`	`string \| null`
`id` required	`string (uuid)`
`key` required	`string`
`last_used_at`	`string \| null`
`mode` required	`string`
`name` required	`string`
`revoked_at`	`string \| null`

`KeyOut`

Member	Type	Notes
`created_at`	`string \| null`
`display` required	`string`
`expires_at`	`string \| null`
`id` required	`string (uuid)`
`last_used_at`	`string \| null`
`mode` required	`string`
`name` required	`string`
`revoked_at`	`string \| null`

`Me`

Member	Type	Notes
`band` required	`integer \| null`
`envelopes` required	`Envelopes`Envelopes
`fair_use` required	`FairUse`FairUse
`grace_until` required	`string \| null`
`key_mode` required	`string`
`plan` required	`string`
`status` required	`string`
`tenant_slug` required	`string`

`PatchTemplateIn`

D54: every part given replaces the stored one; absent parts stay.

Member	Type	Notes
`fields`	`array of FieldSpec \| null`FieldSpec
`name`	`string (min length 1, max length 300) \| null`
`recipients`	`array of RecipientSpec \| null`RecipientSpec

`PatchWebhookReq`

D58(a): every member optional; `active: true` re-enables a disabled endpoint (the only way back from `/disable` short of recreating it).

Member	Type	Notes
`active`	`boolean \| null`
`events`	`array of string \| null`
`url`	`string (max length 2000) \| null`

`PingOut`

Member	Type	Notes
`event_id` required	`string`
`id` required	`integer`
`status` required	`string`

`RecipientOut`

Member	Type	Notes
`auth_level` required	`"link" \| "otp" \| "account" \| "passkey"`
`completed_at`	`string (date-time) \| null`
`consent_at`	`string (date-time) \| null`
`email` required	`string`
`email_normalized` required	`string`
`envelope_id` required	`string`
`id` required	`string (uuid)`
`name` required	`string`
`reassigned_from`	`string (uuid) \| null`
`reject_reason`	`string \| null`
`rejected_at`	`string (date-time) \| null`
`role` required	`"signer" \| "approver" \| "viewer" \| "cc"`
`signing_order` required	`integer`
`status` required	`"pending" \| "sent" \| "opened" \| "completed" \| "rejected" \| "reassigned"`

`RecipientSpec`

Member	Type	Notes
`auth_level`	`"link" \| "otp" \| "account" \| "passkey"`	Default `"link"`.
`email` required	`string (email)`
`name` required	`string (min length 1, max length 200)`
`role`	`"signer" \| "approver" \| "viewer" \| "cc"`	Default `"signer"`.
`signing_order`	`integer (>= 1)`	Default `1`.

`RedeliverOut`

Member	Type	Notes
`id` required	`integer`
`status` required	`"queued"`

`SendOut`

Member	Type	Notes
`id` required	`string`
`status` required	`"sent"`

`SendReq`

Member	Type	Notes
`message`	`string \| null`

`TemplateOut`

Member	Type	Notes
`created_at` required	`string (date-time)`
`fields`	`array of FieldSpec`FieldSpec
`id` required	`string`	Public template id, `tpl_…`
`name` required	`string`
`recipients`	`array of RecipientSpec`RecipientSpec
`sha256` required	`string`
`team_id` required	`string (uuid)`
`updated_at`	`string (date-time) \| null`
`version`	`integer`	Default `1`.

`TemplatePage`

Member	Type	Notes
`items` required	`array of TemplateOut`TemplateOut
`limit` required	`integer`
`offset` required	`integer`
`total` required	`integer`

`UseTemplateIn`

Member	Type	Notes
`date_format`	`string \| null`
`display_timezone`	`string \| null`
`form_values`	`object of string`	Prefill values keyed by field name, or by field index as a string in the template's field order ("0", "1", …). An unknown key fails the request with 422.
`recipients` required	`array of RecipientSpec`RecipientSpec
`redirect_url`	`string \| null`
`title`	`string \| null`

`ValidationError`

Member	Type	Notes
`ctx`	`object`
`input`	`any`
`loc` required	`array of string \| integer`
`msg` required	`string`
`type` required	`string`

`VoidOut`

Member	Type	Notes
`id` required	`string`
`status` required	`"voided"`

`VoidReq`

Member	Type	Notes
`reason` required	`string (min length 1, max length 1000)`

`WebhookCreated`

Member	Type	Notes
`active` required	`boolean`
`events` required	`array of string`
`id` required	`string (uuid)`
`previous_secret_expires_at`	`string \| null`
`secret` required	`string`
`url` required	`string`

`WebhookOut`

Member	Type	Notes
`active` required	`boolean`
`events` required	`array of string`
`id` required	`string (uuid)`
`previous_secret_expires_at`	`string \| null`
`url` required	`string`