Skip to main content
POST
Créer un cachet d'organisation

Autorisations

Authorization
string
header
requis

Clé API pour l'authentification. Utilisez votre clé API directement sans préfixe (par exemple, 'your-api-key'). Le préfixe Bearer est optionnel mais pas obligatoire.

Corps

application/json

Corps de requête pour créer un cachet d'organisation.

name
string
requis

Nom interne du cachet

Maximum string length: 120
display_name
string
requis

Nom d'affichage rendu sur l'image du cachet

Maximum string length: 200
kind
enum<string>
requis

Comment l'image du cachet a été créée

Options disponibles:
uploaded,
typed,
drawn
scope
enum<string>
requis

Portée du cachet. La portée entreprise requiert une clé API protégée.

Options disponibles:
company,
workspace
statement
object
requis

Déclaration d'attestation affirmant l'autorité d'appliquer le cachet.

signatory_title
string | null

Titre du signataire rendu sur l'image du cachet

Maximum string length: 200
workspace_id
string<uuid>

Requis lorsque scope vaut 'workspace'

image
string

URI de données PNG encodée en base64 (data:image/png;base64,...). Requise pour les types 'uploaded' et 'drawn'.

typed
object

Paramètres du cachet saisi. Requis pour le type 'typed'.

is_default
boolean
défaut:false

Définir comme cachet par défaut de cette portée

Réponse

Cachet créé avec succès

Métadonnées du cachet d'organisation (les données internes de l'image et de la déclaration sont retirées des réponses de liste et de consultation).

id
string<uuid>
lineage_id
string<uuid>

Partagé entre les versions du même cachet

version
integer
Plage requise: x >= 1
companies_id
string<uuid>
companies_workspaces_id
string<uuid> | null

Null pour les cachets de portée entreprise

name
string
Maximum string length: 120
display_name
string
Maximum string length: 200
signatory_title
string | null
Maximum string length: 200
kind
enum<string>
Options disponibles:
uploaded,
typed,
drawn
is_default
enum<integer>

1 s'il s'agit du cachet par défaut de sa portée

Options disponibles:
0,
1
statement_language
string
statement_version
integer
Plage requise: x >= 1
signatory_name
string
Maximum string length: 200
signatory_title_attested
string | null
Maximum string length: 200
attested_at
string<date-time>
revoked_on
string<date-time> | null
created_at
string<date-time>
deleted
enum<integer>
Options disponibles:
0,
1