Rechercher dans la documentation Appuyez sur / pour chercher

`project.settings.write`

Markdownv0.3.0

Modifier les réglages d'un projet.

APIPATCH /v1/projects/{projectId}
MCPproject_settings_write
CLIbastide project settings write

Propriété	Valeur
Niveau	`project`
Rang minimal	`maintainer`
Rôle transversal	—
Portées	`project:write`
Compte de service	ne la mène pas : cette écriture ne lui est pas ouverte
Réversibilité	E — réversible avec effort : validation d'une personne avant l'appel, puis cinq minutes pour tout défaire d'un seul appel
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

PATCH /v1/projects/{projectId} — 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.
`name`	corps	texte, de 1 à 120 caractères	non
`gitRemote`	corps	texte, 2048 caractères au plus, format uri	non
`defaultBranch`	corps	texte, motif `^(?!-)[A-Za-z0-9._/@+-]{1,255}$`	non	Nom de branche Git
`rootDirectory`	corps	texte, motif `^[A-Za-z0-9._/-]{0,255}$`	non	Racine de projet dans le dépôt
`includePaths`	corps	liste de 32 éléments au plus — chaque élément : texte	non
`registresAdmis`	corps	liste de 16 éléments au plus — chaque élément : texte	non
`veilleMinutes`	corps	entier, de 5 à 120	non	Minutes sans requête avant l'arrêt d'un environnement qui peut dormir. Le premier appel suivant le réveille.
`veilleEnvironnementsPersonnalises`	corps	booléen	non	Vrai pour que les environnements personnalisés dorment aussi.
`instances`	corps	entier, de 1 à 10	non	Nombre d'exemplaires du service de PRODUCTION, de 1 à 10. Les autres environnements en tiennent toujours un.
`fuseau`	corps	texte, de 1 à 64 caractères	non	Nom de fuseau de la base IANA, par exemple « Europe/Paris ».
`horaires`	corps	liste de 24 éléments au plus — chaque élément : objet (`heure`, `exemplaires`)	non	Ordonnancement horaire du nombre d'exemplaires, déclaré EN ENTIER : absent, il reste tel quel ; vide, il est retiré. À chaque heure déclarée, lue dans le fuseau du projet, le compte d'exemplaires devient celui de cette heure jusqu'à la suivante.
`licencesContaminantesBloquantes`	corps	booléen	non	Vrai : un paquet AGPL, SSPL ou BUSL dans l'image fait échouer la construction ; faux : il est seulement signalé.
`sortieMode`	corps	l'un de `fermee`, `ouverte`, `restreinte`	non
`sortieDomaines`	corps	liste de 100 éléments au plus — chaque élément : texte	non
`tier`	corps	l'un de `discovery`, `standard`, `pro`, `sovereign`	non
`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
`id`	texte, motif `^prj_[0-9A-HJKMNP-TV-Z]{26}$`	Identifiant de projet
`expiresAt`	texte, format date-time, ou nul
`slug`	texte, motif `^[a-z0-9][a-z0-9-]{1,62}$`	Identifiant lisible, unique dans son périmètre
`name`	objet (`untrusted`, `source`, `content`)
`organizationId`	texte, motif `^org_[0-9A-HJKMNP-TV-Z]{26}$`	Identifiant de organisation
`tier`	l'un de `discovery`, `standard`, `pro`, `sovereign`
`status`	l'un de `active`, `suspended`, `closing`
`defaultBranch`	texte
`gitRemote`	objet (`untrusted`, `source`, `content`), ou nul	Adresse du dépôt Git, sans les identifiants, les paramètres ni le fragment qu'elle pouvait porter. Nul : aucun dépôt déclaré.
`rootDirectory`	objet (`untrusted`, `source`, `content`), ou nul
`includePaths`	liste — chaque élément : texte
`registresAdmis`	liste — chaque élément : texte
`veilleMinutes`	entier	Minutes sans requête après lesquelles un environnement de ce projet qui peut dormir s'arrête.
`veilleEnvironnementsPersonnalises`	booléen	Vrai quand les environnements personnalisés de ce projet dorment aussi.
`licencesContaminantesBloquantes`	booléen	Vrai quand un paquet sous licence AGPL, SSPL ou BUSL fait échouer la construction de ce projet ; faux, il est seulement signalé.
`sortie`	objet (`mode`, `domaines`, `smtp`)
`instances`	entier	Nombre d'exemplaires du service de production, de 1 à 10. Les autres environnements en tiennent toujours un.
`fuseau`	texte	Fuseau dans lequel se lisent les heures de l'ordonnancement.
`horaires`	liste — chaque élément : objet (`heure`, `exemplaires`)	Ordonnancement horaire du nombre d'exemplaires de production, par heure croissante. Vide : aucun ordonnancement, le réglage manuel tient.
`createdAt`	texte, format date-time
`createdBy`	objet (`accountId`, `serviceTokenId`, `agentSession`, `channel`), ou nul
`undoToken`	texte, motif `^und_[0-9A-HJKMNP-TV-Z]{26}$`	Défait cet appel par action.undo, pendant cinq minutes, pour le même compte et la même session d'agent, une seule fois.

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 project settings write --project-id <valeur>

Option	Type	Requise	Défaut	Description
`--project-id`	texte	oui	—	Identifiant de projet
`--name`	texte	non	—
`--git-remote`	texte	non	—
`--default-branch`	texte	non	—	Nom de branche Git
`--root-directory`	texte	non	—	Racine de projet dans le dépôt
`--include-paths`	liste	non	—
`--registres-admis`	liste	non	—
`--veille-minutes`	nombre	non	—	Minutes sans requête avant l'arrêt d'un environnement qui peut dormir. Le premier appel suivant le réveille.
`--veille-environnements-personnalises`	booléen	non	—	Vrai pour que les environnements personnalisés dorment aussi.
`--instances`	nombre	non	—	Nombre d'exemplaires du service de PRODUCTION, de 1 à 10. Les autres environnements en tiennent toujours un.
`--fuseau`	texte	non	—	Nom de fuseau de la base IANA, par exemple « Europe/Paris ».
`--horaires`	liste	non	—	Ordonnancement horaire du nombre d'exemplaires, déclaré EN ENTIER : absent, il reste tel quel ; vide, il est retiré. À chaque heure déclarée, lue dans le fuseau du projet, le compte d'exemplaires devient celui de cette heure jusqu'à la suivante.
`--licences-contaminantes-bloquantes`	booléen	non	—	Vrai : un paquet AGPL, SSPL ou BUSL dans l'image fait échouer la construction ; faux : il est seulement signalé.
`--sortie-mode`	texte	non	—
`--sortie-domaines`	liste	non	—
`--tier`	texte	non	—
`--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 demande une confirmation avant d'agir, sauf avec « --yes ».

MCP

Outil project_settings_write.

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

Erreurs

Code	Surface	Cause
`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.
`palier_choisi_par_une_personne`	les deux	Le palier d'un projet engage une dépense, et seule une personne le choisit : un agent crée et règle un projet au palier par défaut.

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éclarer la racine d'un projet dans un dépôt à plusieurs applications :

{
  "projectId": "prj_01JQ8ZK4M7NP2RSTVWXYZ34567",
  "rootDirectory": "apps/web",
  "idempotencyKey": "racine-apps-web-2026-09-13"
}

Signaler une erreur sur cette page