Mettre à jour un cachet d'organisation
Mettez à jour le nom, le nom d’affichage, l’image ou le statut par défaut d’un cachet. Tout changement de image, typed, display_name, signatory_title ou statement crée une nouvelle version (remplacement) et exige un statement avec accepted true, version 1, language, text exactement égal au statement_text du cachet, signatory_name et signatory_title facultatif ; sinon, la demande échoue avec 400 SEAL_STATEMENT_REQUIRED. La nouvelle version enregistre l’acceptation de cette demande : signatory_name et signatory_title_attested correspondent au signataire envoyé, et attested_at est le moment du remplacement. Les demandes déjà envoyées conservent la version figée lors de leur envoi ; les demandes envoyées après le remplacement utilisent la nouvelle version, et leurs certificats affichent le nouveau signataire. Le texte de la déclaration ne change jamais. Les cachets de portée entreprise requièrent une clé API protégée pour les mutations.
Autorisations
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.
Paramètres de chemin
ID du cachet
Corps
Nouveau nom interne
120Nouveau nom d'affichage (déclenche un nouveau rendu de l'image)
200Nouveau titre du signataire
200Nouvelle URI de données PNG en base64
Déclaration d'attestation affirmant l'autorité d'appliquer le cachet.
Définir comme cachet par défaut de sa portée
Réponse
Cachet mis à jour 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).
Partagé entre les versions du même cachet
x >= 1Null pour les cachets de portée entreprise
Le nom au titre duquel le cachet a été attesté : l'entreprise pour la portée entreprise ou l'espace de travail protégé, sinon l'espace de travail. Null pour les cachets dont la lignée a été créée avant la fixation du nom ; ils certifient au nom actuel de l'entreprise.
120200200uploaded, typed, drawn 1 s'il s'agit du cachet par défaut de sa portée
0, 1 x >= 1La déclaration d'autorité sous laquelle le cachet a été attesté, enregistrée mot pour mot. Elle est en écriture unique : elle ne change jamais entre les versions d'une lignée.
SHA-256 de statement_text (UTF-8), en hexadécimal et en minuscules.
2002000, 1