Rechercher dans la documentation Appuyez sur / pour chercher

`action.undo`

Markdownv0.3.0

Défaire en un appel, dans les cinq minutes, une action de classe E par le jeton qu'elle a rendu.

APIPOST /v1/projects/{projectId}/undo
MCPaction_undo
CLIbastide action undo

Propriété	Valeur
Niveau	`project`
Rang minimal	`developer`
Rôle transversal	—
Portées	`project:write`
Compte de service	ne la mène pas : cette écriture ne lui est pas ouverte
Réversibilité	R — réversible : exécution directe, tracée, annulable
Idempotence	une clé d'idempotence est acceptée : le rejeu rend la première réponse
Limites de débit, par jeton	600 appels par 60 secondes (`general`), et 60 appels par 60 secondes (`sensitive`)

API

POST /v1/projects/{projectId}/undo — succès en 200.

Paramètre	Où	Type	Requis	Description
`projectId`	chemin	texte, motif `^prj_[0-9A-HJKMNP-TV-Z]{26}$`	oui	Identifiant de projet
`Idempotency-Key`	en-tête	texte, de 8 à 128 caractères	non	Clé d'idempotence. Un rejeu portant la même clé retourne le résultat initial sans nouvel effet de bord, et la réponse porte alors « Idempotency-Replayed: true ». Équivaut au champ « idempotencyKey » du corps ; les deux à la fois ne sont acceptés que s'ils sont identiques.
`undoToken`	corps	texte, motif `^und_[0-9A-HJKMNP-TV-Z]{26}$`	oui	Le jeton rendu par l'appel à défaire
`idempotencyKey`	corps	texte, de 8 à 128 caractères	non	Clé d'idempotence, obligatoire. Un rejeu portant la même clé rend le résultat initial, sans nouvel effet de bord.

La réponse :

Champ	Type	Description
`operation`	l'un de `env.write.nonproduction`, `env.write.production`, `env.delete.nonproduction`, `env.delete.production`, `backend.key.revoke`, `backend.key.replace`, `project.settings.write`, `backend.auth.configure`, `backend.realtime.configure`, `deployment.rollback`	L'opération défaite
`target`	texte, motif `^(?:[A-Z][A-Z0-9_]{0,63}\	(?:bky\	prj\	env)_[0-9A-HJKMNP-TV-Z]{26})$`	Ce qu'elle visait : le nom de la variable, l'identifiant de la clé, du projet ou de l'environnement
`undoneAt`	texte, format date-time
`undoToken`	nul	Aucun jeton : une annulation se défait en rejouant l'opération d'origine.

En-têtes de la réponse : RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit-Policy, Idempotency-Replayed.

Autres réponses : 400, 401, 403, 404, 409, 429, 500, 503 — communes à toute opération.

Ligne de commande

bastide action undo --project-id <valeur> --undo-token <valeur>

Option	Type	Requise	Défaut	Description
`--project-id`	texte	oui	—	Identifiant de projet
`--undo-token`	texte	oui	—	Le jeton rendu par l'appel à défaire
`--idempotency-key`	texte	non	—	Clé d'idempotence, obligatoire. Un rejeu portant la même clé rend le résultat initial, sans nouvel effet de bord.

La commande s'exécute sans confirmation.

MCP

Outil action_undo.

Propriété	Valeur
Lecture seule	non
Destructif	non
Idempotent	oui
Monde ouvert	non
Confirmation en deux temps	non
Budget de jetons du résultat	300

Erreurs

Code	Surface	Cause
`annulation_invalide`	les deux	Ce jeton d'annulation ne défait rien pour cet appelant : inconnu, d'un autre projet, d'un autre compte ou d'une autre session, ou déjà servi.
`annulation_expiree`	les deux	La fenêtre de cinq minutes de cette annulation est close.
`annulation_perimee`	les deux	La ressource a changé depuis l'action : la défaire écraserait ce changement.
`idempotency_key_conflict`	API	Deux clés d'idempotence différentes ont été présentées, dans le corps et dans l'en-tête.

S'y ajoutent les refus communs à toute opération — entrée invalide, authentification, autorisation, cible introuvable, conflit, limite de débit, indisponibilité — que le catalogue des erreurs décrit.

Exemples

Défaire une écriture de variable qui vient d'être faite :

{
  "projectId": "prj_01JQ8ZK4M7NP2RSTVWXYZ34567",
  "undoToken": "und_01JQ8ZK4M7NP2RSTVWXYZ34567",
  "idempotencyKey": "annulation-ecriture-variable-2026-09-15"
}

Signaler une erreur sur cette page