Sign in
Organization Seals

Create an organization seal

Create a new organization seal with an uploaded, typed, or drawn image. Company-scope seals require a protected API key.

post/seals

Request body

namestring required

Internal name for the seal

display_namestring required

Display name rendered on the seal image

signatory_titlestring nullable

Signatory title rendered on the seal image

kind'uploaded' | 'typed' | 'drawn' required

How the seal image was created

scope'company' | 'workspace' required

Scope of the seal. Company-scope requires a protected API key.

workspace_idstring uuid

Required when scope is 'workspace'

imagestring

Base64-encoded PNG data URI (data:image/png;base64,...). Required for 'uploaded' and 'drawn' kinds.

is_defaultboolean

Set as default seal for this scope

Response

Seal created successfully

idstring uuid
lineage_idstring uuid

Shared across versions of the same seal

versioninteger
companies_idstring uuid
companies_workspaces_idstring uuid nullable

Null for company-scope seals

authority_namestring nullable

The name the seal was attested for: the company for company scope or the protected workspace, otherwise the workspace. Null for seals whose lineage was created before pinning; they certify in the company's current name.

namestring
display_namestring
signatory_titlestring nullable
kind'uploaded' | 'typed' | 'drawn'
is_default0 | 1

1 if this is the default seal for its scope

statement_languagestring
statement_versioninteger
signatory_namestring
signatory_title_attestedstring nullable
attested_atstring date-time
revoked_onstring date-time nullable
created_atstring date-time
deleted0 | 1

Changes

Changed in 2 of the 5 revisions of this API.2