Update organization settings

PATCH/settings

Authorization

AuthorizationBearer token · headerrequired

Pass your API key as a Bearer token. API keys are scoped to specific operations — configure scopes in your organization's Settings → Developer → API Keys.

Request body

requiredapplication/json

signingobjectrequired

Show properties

allowed_signature_typesstring[]required

default_deadline_daysintegerrequired

esign_consent_textstring | nullrequired

notificationsobjectrequired

Show properties

reminder_scheduleinteger[]required

expiration_alert_daysintegerrequired

send_completion_emailbooleanrequired

send_viewed_notificationbooleanrequired

aiobjectrequired

Show properties

enabledbooleanrequired

auto_analyzebooleanrequired

securityobjectrequired

Show properties

ip_allowliststring[]required

allow_api_accessbooleanrequired

require_mfabooleanrequired

session_timeout_minutesinteger | nullrequired

Responses

200

Updated

successbooleanrequired

400

Invalid request parameters

typestringrequired

Machine-readable error code

statusintegerrequired

HTTP status code

titlestringrequired

Human-readable error message

detailsobject

Field-level validation errors

401

Missing or invalid API key

typestringrequired

Machine-readable error code

statusintegerrequired

HTTP status code

titlestringrequired

Human-readable error message

detailsobject

Field-level validation errors

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Bodyapplication/json

Request body

Request

curl -X PATCH "https://api.seal.nyc/api/v1/settings" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "signing": {
    "allowed_signature_types": [
      "draw"
    ],
    "default_deadline_days": 0,
    "esign_consent_text": "string"
  },
  "notifications": {
    "reminder_schedule": [
      0
    ],
    "expiration_alert_days": 0,
    "send_completion_email": true,
    "send_viewed_notification": true
  },
  "ai": {
    "enabled": true,
    "auto_analyze": true
  },
  "security": {
    "ip_allowlist": [
      "string"
    ],
    "allow_api_access": true,
    "require_mfa": true,
    "session_timeout_minutes": 0
  }
}'

const response = await fetch("https://api.seal.nyc/api/v1/settings", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"signing\": {\n    \"allowed_signature_types\": [\n      \"draw\"\n    ],\n    \"default_deadline_days\": 0,\n    \"esign_consent_text\": \"string\"\n  },\n  \"notifications\": {\n    \"reminder_schedule\": [\n      0\n    ],\n    \"expiration_alert_days\": 0,\n    \"send_completion_email\": true,\n    \"send_viewed_notification\": true\n  },\n  \"ai\": {\n    \"enabled\": true,\n    \"auto_analyze\": true\n  },\n  \"security\": {\n    \"ip_allowlist\": [\n      \"string\"\n    ],\n    \"allow_api_access\": true,\n    \"require_mfa\": true,\n    \"session_timeout_minutes\": 0\n  }\n}"
});

import requests

response = requests.patch(
    "https://api.seal.nyc/api/v1/settings",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"signing\": {\n    \"allowed_signature_types\": [\n      \"draw\"\n    ],\n    \"default_deadline_days\": 0,\n    \"esign_consent_text\": \"string\"\n  },\n  \"notifications\": {\n    \"reminder_schedule\": [\n      0\n    ],\n    \"expiration_alert_days\": 0,\n    \"send_completion_email\": true,\n    \"send_viewed_notification\": true\n  },\n  \"ai\": {\n    \"enabled\": true,\n    \"auto_analyze\": true\n  },\n  \"security\": {\n    \"ip_allowlist\": [\n      \"string\"\n    ],\n    \"allow_api_access\": true,\n    \"require_mfa\": true,\n    \"session_timeout_minutes\": 0\n  }\n}",
)

Response

{
  "success": true
}

{
  "type": "VALIDATION_ERROR",
  "status": 400,
  "title": "Validation failed",
  "details": {
    "email": [
      "Must be a valid email address"
    ]
  }
}

{
  "type": "AUTH_ERROR",
  "status": 401,
  "title": "Missing or invalid API key"
}