Riferimento API
ai
53 endpoint in quest'area. Ognuno ha la sua pagina con i suoi parametri, la sua risposta e una richiesta che puoi eseguire.
| Metodo | Percorso | Funzionalità | Autorizzazione |
|---|---|---|---|
| GET | /v1/ai/credentials | The organization's own AI provider keys. | sites.view |
| POST | /v1/ai/credentials | Store an AI provider key for this organization. | billing.manage |
| DELETE | /v1/ai/credentials/{credentialId} | Stop using an AI provider key. | billing.manage |
| POST | /v1/ai/credentials/{credentialId}/test | Test a stored AI provider key now. | billing.payment.manage |
| GET | /v1/ai/credits | Zinn® credit balance, whether to offer more, and the packs for sale. | sites.view |
| PUT | /v1/ai/credits/settings | Turn automatic top-up on or off. | billing.payment.manage |
| GET | /v1/ai/images/credentials | The organization's own image-provider keys. | sites.view |
| POST | /v1/ai/images/credentials | Store an image-provider key for this organization. | billing.manage |
| DELETE | /v1/ai/images/credentials/{credentialId} | Stop using an image-provider key. | billing.manage |
| POST | /v1/ai/images/credentials/{credentialId}/test | Check an image key now, by generating a real image with it. | billing.manage |
| GET | /v1/ai/images/library | The images this organisation generated for its own use. | sites.view |
| POST | /v1/ai/images/library | Generate images from a prompt, with no post involved. | links.edit |
| DELETE | /v1/ai/images/library/{imageId} | Throw one of your own generated images away. | links.edit |
| GET | /v1/ai/images/library/{imageId}/file | Download the image bytes. | sites.view |
| GET | /v1/ai/images/models | The image models a recipe may be pointed at. | sites.view |
| GET | /v1/ai/images/posts/{postId} | The images generated for one content post. | sites.view |
| POST | /v1/ai/images/posts/{postId} | Generate a featured image and in-post images for a content post. | links.edit |
| GET | /v1/ai/images/posts/{postId}/preview/{imageId} | The staged bytes of one generated image. | sites.view |
| GET | /v1/ai/images/providers | Which image providers this organisation can actually generate with. | sites.view |
| GET | /v1/ai/models | The live model catalogue. | links.view |
| GET | /v1/ai/proposals | What the AI agent wants done to this organization's resources. | sites.view |
| POST | /v1/ai/proposals/{proposalId}/decision | Approve or reject one proposal. | — |
| POST | /v1/ai/proposals/{proposalId}/revert | Put an applied change back. | — |
| GET | /v1/ai/providers | Which AI vendors are available, and whether this organization can use each. | links.view |
| GET | /v1/ai/recipes | This organization's AI posting recipes. | links.view |
| POST | /v1/ai/recipes | Create an AI posting recipe. | links.edit |
| DELETE | /v1/ai/recipes/{recipeId} | Delete an AI posting recipe. | links.edit |
| GET | /v1/ai/recipes/{recipeId} | One AI posting recipe. | links.view |
| PATCH | /v1/ai/recipes/{recipeId} | Edit an AI posting recipe. | links.edit |
| POST | /v1/ai/recipes/{recipeId}/run | Queue an AI posting recipe to run now. | links.edit |
| GET | /v1/ai/recipes/{recipeId}/runs | What an AI posting recipe has produced. | links.view |
| GET | /v1/ai/reports | The AI reports this organization has bought. | sites.view |
| GET | /v1/ai/site-agent/allowance | How many self-serve site checks are left this month. | sites.view |
| GET | /v1/ai/site-agent/preferences | What this customer lets the AI do to their sites without asking. | sites.view |
| PUT | /v1/ai/site-agent/preferences | Choose what the AI may do for one kind of fix. | sites.view |
| POST | /v1/ai/site-agent/sites/{site_id}/check | Read this site's server, diagnose it, and fix what the customer allows. | sites.view |
| GET | /v1/ai/site-builds | The organization's AI-built sites, its trial state and its builder spend. | sites.view |
| POST | /v1/ai/site-builds | Describe a site and the AI builds it. | sites.create |
| GET | /v1/ai/site-builds/targets | Where a draft can be published, and what is already on each destination. | hosting.deploy.manage |
| GET | /v1/ai/site-builds/{siteBuildId} | One AI-built site, with every generated file. | sites.view |
| PUT | /v1/ai/site-builds/{siteBuildId}/files | Replace one generated file's contents. | sites.create |
| GET | /v1/ai/site-builds/{siteBuildId}/images | What generating this draft's images would cost. Spends nothing. | sites.create |
| POST | /v1/ai/site-builds/{siteBuildId}/images | Draw the draft's images. Charges the content-images meter. | sites.create |
| POST | /v1/ai/site-builds/{siteBuildId}/plugin-plan | Which plugins this generated site needs, and a custom one if it needs that. | sites.create |
| POST | /v1/ai/site-builds/{siteBuildId}/preview | What publishing this draft would do to that site. Changes nothing. | hosting.deploy.manage |
| GET | /v1/ai/site-builds/{siteBuildId}/publications | Every attempt to publish this draft, newest first. | sites.view |
| POST | /v1/ai/site-builds/{siteBuildId}/publications | Publish a draft to a destination, taking a backup first when it destroys. | hosting.deploy.manage |
| POST | /v1/ai/site-builds/{siteBuildId}/publish | Put an AI-built site live on one of the organization's sites. | hosting.deploy.manage |
| POST | /v1/ai/site-builds/{siteBuildId}/rebuild | Build the site again from its brief, optionally tweaked. | sites.create |
| DELETE | /v1/ai/site-publications/{publicationId} | Stop a publication that has not finished. | hosting.deploy.manage |
| GET | /v1/ai/site-publications/{publicationId} | How far a publication has got. | sites.view |
| GET | /v1/ai/subscriptions | Which sites hold a recurring AI product, and when it next runs. | sites.view |
| GET | /v1/ai/summary | The organization's AI position — balance, funding route, usage. | sites.view |