API REST
Couverture des opérations
Couverture générée pour REST, la CLI et MCP, autorisations requises et exceptions propres à chaque interface.
Cette référence est générée à partir du registre des routes et de leurs correspondances avec les différentes interfaces.
Elle décrit la version de l’API utilisée dans cette documentation, et non les autorisations associées à vos identifiants.
Appelez get_account, atelier201 account ou GET /v1/account pour les vérifier.
Découvrir le contrat
- REST : consultez OpenAPI. Chaque opération comporte
x-atelier201-surfaces. - CLI : exécutez
atelier201 help files read --jsonpour une commande, ouatelier201 help --operation readSiteFile --jsonpour consulter les schémas REST exacts. Il s’agit du contrat fourni avec la version de la CLI installée. - MCP : consultez
atelier201://operationspour obtenir un index synthétique, puisatelier201://operations/{operation_id}pour le contrat complet d’une opération. Le document complet est disponible à l’adresseatelier201://openapi. Les clients qui ne prennent pas en charge les ressources peuvent utiliser les schémas de leurs outils ou la spécification OpenAPI publique. - Mode Code :
searchrenvoie les mêmes opérations et correspondances entre interfaces ; une recherche filtrée inclut les schémas complets.
Toutes les interfaces utilisent les mêmes autorisations de service. La présence d’une commande ou d’un outil dans la liste ne donne pas accès aux fonctionnalités. Les commandes qui agissent sur le système de fichiers local, les imports anonymes en tant qu’invité et les cartes interactives MCP fonctionnent volontairement différemment. Le tableau répertorie les exceptions au lieu de laisser entendre que chaque interface accepte le même mode de transport ou le même format de sortie.
Capacités
| Opération | REST | CLI | MCP | Autorisation |
|---|---|---|---|---|
getAccount | GET /v1/account | atelier201 account | get_account | account:read |
submitFeedback | POST /v1/feedback | atelier201 feedback send | send_feedback | Authentification requise, aucun scope |
getCredits | GET /v1/credits | atelier201 credits | get_credit_balance | account:read |
getUsage | GET /v1/usage | atelier201 usage | get_usage | usage:read |
listSites | GET /v1/sites | atelier201 sites list | list_sites | sites:read |
createSite | POST /v1/sites | atelier201 sites create | create_site | sites:write |
getSite | GET /v1/sites/{site_id} | atelier201 sites get | get_site | sites:read |
updateSite | PATCH /v1/sites/{site_id} | atelier201 sites rename | rename_site | sites:write |
deleteSite | DELETE /v1/sites/{site_id} | atelier201 sites delete | delete_site Exige confirm_name : avant la suppression, les agents doivent saisir le nom ou le slug du site. REST permet également aux administrateurs d’effectuer directement l’appel sans ce champ de confirmation. | sites:publish |
applySitePlan | POST /v1/sites/{site_id}/plan:apply | atelier201 sites apply | apply_site_plan | sites:write |
listSiteFiles | GET /v1/sites/{site_id}/files | atelier201 files list | list_files | sites:read |
readSiteFile | GET /v1/sites/{site_id}/files/content | atelier201 files read | read_file | sites:read |
readSiteFiles | POST /v1/sites/{site_id}/files/read | atelier201 files read-many | read_files | sites:read |
searchSiteFiles | GET /v1/sites/{site_id}/search | atelier201 files search | search_files | sites:read |
commitSiteFiles | POST /v1/sites/{site_id}/commits | atelier201 files commit | edit_files | sites:write |
runSiteCommand | POST /v1/sites/{site_id}/workspace:run | atelier201 workspace run | bash | sites:write |
getSiteWorkspace | GET /v1/sites/{site_id}/workspace | atelier201 workspace diff | get_workspace | sites:write |
commitSiteWorkspace | POST /v1/sites/{site_id}/workspace:commit | atelier201 workspace commit | commit_workspace | sites:write |
discardSiteWorkspace | POST /v1/sites/{site_id}/workspace:discard | atelier201 workspace discard | discard_workspace | sites:write |
listSiteRevisions | GET /v1/sites/{site_id}/revisions | atelier201 history list | list_history | sites:read |
compareSiteRevisions | GET /v1/sites/{site_id}/compare | atelier201 history compare | compare_revisions | sites:read |
restoreSiteRevision | POST /v1/sites/{site_id}/revisions/{revision}/restore | atelier201 history restore | restore_revision | sites:write |
openChangeset | POST /v1/sites/{site_id}/changesets | atelier201 changesets open | open_changeset | sites:write |
patchChangeset | POST /v1/sites/{site_id}/changesets/{changeset_id}/patch | atelier201 changesets stage | stage_changes | sites:write |
commitChangeset | POST /v1/sites/{site_id}/changesets/{changeset_id}/commit | atelier201 changesets commit | commit_changeset | sites:write |
abandonChangeset | POST /v1/sites/{site_id}/changesets/{changeset_id}/abandon | atelier201 changesets abandon | abandon_changeset | sites:write |
startSiteBuild | POST /v1/sites/{site_id}/builds | atelier201 builds start | build_site | sites:write |
listSiteBuilds | GET /v1/sites/{site_id}/builds | atelier201 builds list | list_builds | sites:read |
getSiteBuild | GET /v1/sites/{site_id}/builds/{build_id} | atelier201 builds get | get_build | sites:read |
readSitePage | GET /v1/sites/{site_id}/pages | atelier201 pages read | read_page | sites:read |
getSiteBuildLog | GET /v1/sites/{site_id}/builds/{build_id}/log | atelier201 builds log | get_build_log | sites:read |
createSitePreview | POST /v1/sites/{site_id}/previews | atelier201 previews create | share_preview | sites:write |
listSitePreviews | GET /v1/sites/{site_id}/previews | atelier201 previews list | list_previews | sites:read |
revokeSitePreview | DELETE /v1/sites/{site_id}/previews/{preview_id} | atelier201 previews revoke | revoke_preview | sites:write |
getSiteAnalytics | GET /v1/sites/{site_id}/analytics | atelier201 analytics | get_site_analytics | sites:read |
reviewSitePublish | GET /v1/sites/{site_id}/publish/review | atelier201 publish review | review_publish | sites:read |
publishSite | POST /v1/sites/{site_id}/publish | atelier201 publish | publish_site | sites:publish |
rollbackSite | POST /v1/sites/{site_id}/rollback | atelier201 publish rollback | rollback_site | sites:publish |
unpublishSite | POST /v1/sites/{site_id}/unpublish | atelier201 publish unpublish | unpublish_site | sites:publish |
listSitePublications | GET /v1/sites/{site_id}/publications | atelier201 publish history | list_publications | sites:read |
listSiteDomains | GET /v1/sites/{site_id}/domains | atelier201 domains list | list_domains | sites:read |
addSiteDomain | POST /v1/sites/{site_id}/domains | atelier201 domains add | add_domain | domains:write |
checkSiteDomain | POST /v1/sites/{site_id}/domains/{domain_id}/check | atelier201 domains check | check_domain | domains:write |
removeSiteDomain | DELETE /v1/sites/{site_id}/domains/{domain_id} | atelier201 domains remove | remove_domain | domains:write |
setSiteAddress | POST /v1/sites/{site_id}/address | atelier201 domains address | set_site_address | domains:write |
setSiteCanonicalDomain | POST /v1/sites/{site_id}/domains/{domain_id}/canonical | atelier201 domains main | set_main_domain | domains:write |
getContentModel | GET /v1/sites/{site_id}/content | atelier201 content model | get_content_model | sites:read |
listContentEntries | GET /v1/sites/{site_id}/content/{collection} | atelier201 content list | list_entries | sites:read |
getContentEntry | GET /v1/sites/{site_id}/content/{collection}/{slug} | atelier201 content get | get_entry | sites:read |
saveContentEntry | PUT /v1/sites/{site_id}/content/{collection}/{slug} | atelier201 content save | save_entry | sites:write |
deleteContentEntry | DELETE /v1/sites/{site_id}/content/{collection}/{slug} | atelier201 content delete | delete_entry | sites:write |
saveContentEntries | POST /v1/sites/{site_id}/content:batch | atelier201 content save-many | save_entries | sites:write |
getSingleton | GET /v1/sites/{site_id}/singletons/{name} | atelier201 content singleton | get_singleton | sites:read |
saveSingleton | PUT /v1/sites/{site_id}/singletons/{name} | atelier201 content save-singleton | save_singleton | sites:write |
replaceSiteText | POST /v1/sites/{site_id}/text:replace | atelier201 content replace | edit_text | sites:write |
setContentField | POST /v1/sites/{site_id}/fields | atelier201 content set | set_field | sites:write |
listSiteMedia | GET /v1/sites/{site_id}/media | atelier201 media list | list_media | sites:read |
uploadSiteMedia | POST /v1/sites/{site_id}/media | atelier201 media upload | upload_media | sites:write |
deleteSiteMedia | DELETE /v1/sites/{site_id}/media | atelier201 media delete | delete_media | sites:write |
searchStockMedia | GET /v1/sites/{site_id}/media/stock | atelier201 media stock search | search_stock_media | sites:read |
importStockMedia | POST /v1/sites/{site_id}/media/stock | atelier201 media stock import | import_stock_media | sites:write |
placeSiteImage | POST /v1/sites/{site_id}/images:place | atelier201 media place | place_image | sites:write |
listMediaModels | GET /v1/media/models | atelier201 media models | list_media_models | sites:read |
generateSiteMedia | POST /v1/sites/{site_id}/media/generations | atelier201 media generate | generate_media | media:generate |
getSiteMediaGeneration | GET /v1/sites/{site_id}/media/generations/{generation_id} | atelier201 media generation | get_media_generation | sites:read |
importSiteArchive | POST /v1/sites/{site_id}/import | atelier201 site push | Une archive de projet est un flux binaire pouvant atteindre 50 MB ; un modèle ne peut pas la produire via un appel d’outil. Les agents modifient les fichiers avec edit_files ou un changeset ; la CLI importe des dossiers entiers. | sites:write |
exportSiteArchive | GET /v1/sites/{site_id}/export | atelier201 site pull | Renvoie une archive tar binaire, inexploitable dans le résultat d’un outil. Les agents lisent les fichiers avec read_file ; la CLI télécharge l’ensemble du projet. | sites:read |
listSkills | GET /v1/skills | atelier201 skills list | list_skills | Public |
getSkill | GET /v1/skills/{skill_id} | atelier201 skills get | get_skill | Public |
prepareGuestSite | POST /v1/guest/sites | atelier201 site push --guest | Avant la connexion, OAuth n’est pas disponible, et MCP à distance en a besoin avant toute exécution d’outil. Les agents utilisent cet endpoint HTTP (ou la CLI), puis transmettent le lien de revendication à la personne. | Public |
importGuestSite | POST /v1/guest/sites/{site_id}/import | atelier201 site push --guest | Fait partie du flux HTTP préalable à la création du compte (voir prepareGuestSite). | Public |
buildGuestSite | POST /v1/guest/sites/{site_id}/builds | atelier201 site push --guest | Fait partie du flux HTTP préalable à la création du compte (voir prepareGuestSite). | Public |
getGuestSite | GET /v1/guest/sites/{site_id} | atelier201 site push --guest | Fait partie du flux HTTP préalable à la création du compte (voir prepareGuestSite). | Public |