REST API
Copertura delle operazioni
Copertura generata per REST, CLI e MCP, autorizzazioni richieste ed eccezioni esplicite specifiche per superficie.
Questo riferimento è generato dal registro delle route e dalle relative mappature delle superfici.
Descrive la versione dell’API documentata qui, non le autorizzazioni delle tue credenziali.
Per verificarle, chiama get_account, atelier201 account oppure GET /v1/account.
Individuare il contratto
- REST: consulta OpenAPI. Ogni operazione include
x-atelier201-surfaces. - CLI: esegui
atelier201 help files read --jsonper un comando oppureatelier201 help --operation readSiteFile --jsonper gli schemi REST esatti. Questo è il contratto incluso nella CLI installata. - MCP: consulta
atelier201://operationsper un indice compatto, quindiatelier201://operations/{operation_id}per il contratto completo di una singola operazione. Il documento completo èatelier201://openapi. I client che non supportano le risorse possono usare gli schemi dei propri strumenti o la specifica OpenAPI pubblica. - Code Mode:
searchrestituisce le stesse operazioni e mappature delle superfici; una ricerca filtrata include gli schemi completi.
Tutte le superfici usano le stesse autorizzazioni del servizio. La presenza di un comando o di uno strumento nell’elenco non garantisce l’accesso. I comandi del filesystem locale, i caricamenti anonimi come ospite e le schede MCP interattive presentano differenze intenzionali. La tabella riporta le eccezioni, invece di far supporre che ogni interfaccia accetti lo stesso trasporto o formato di output.
Funzionalità
| Operazione | REST | CLI | MCP | Autorizzazione |
|---|---|---|---|---|
getAccount | GET /v1/account | atelier201 account | get_account | account:read |
submitFeedback | POST /v1/feedback | atelier201 feedback send | send_feedback | Autenticazione richiesta, nessuno 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 Richiede confirm_name: gli agenti devono riscrivere il nome o lo slug del sito prima di eliminarlo. REST supporta anche chiamate dirette degli amministratori senza questo campo di conferma. | 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 | Un archivio di progetto è un flusso binario fino a 50 MB; un modello non può produrlo tramite una chiamata a uno strumento. Gli agenti modificano i file con edit_files o un changeset; la CLI invia intere cartelle. | sites:write |
exportSiteArchive | GET /v1/sites/{site_id}/export | atelier201 site pull | Restituisce un archivio tar binario, che non è possibile trasmettere in modo utile come risultato di uno strumento. Gli agenti leggono i file con read_file; la CLI scarica l’intero progetto. | sites:read |
listSkills | GET /v1/skills | atelier201 skills list | list_skills | Pubblico |
getSkill | GET /v1/skills/{skill_id} | atelier201 skills get | get_skill | Pubblico |
prepareGuestSite | POST /v1/guest/sites | atelier201 site push --guest | Prima dell’accesso non è disponibile OAuth, e MCP remoto lo richiede prima di eseguire qualsiasi strumento. Gli agenti usano questo endpoint HTTP (o la CLI) e forniscono alla persona il link per rivendicare il sito. | Pubblico |
importGuestSite | POST /v1/guest/sites/{site_id}/import | atelier201 site push --guest | Fa parte del flusso HTTP prima della creazione dell’account (vedi prepareGuestSite). | Pubblico |
buildGuestSite | POST /v1/guest/sites/{site_id}/builds | atelier201 site push --guest | Fa parte del flusso HTTP prima della creazione dell’account (vedi prepareGuestSite). | Pubblico |
getGuestSite | GET /v1/guest/sites/{site_id} | atelier201 site push --guest | Fa parte del flusso HTTP prima della creazione dell’account (vedi prepareGuestSite). | Pubblico |