API ਸੰਦਰਭ
ai
ਇਸ ਖੇਤਰ ਵਿੱਚ 53 ਐਂਡਪੁਆਇੰਟ ਹਨ। ਹਰ ਇੱਕ ਦਾ ਆਪਣਾ ਪੰਨਾ ਹੈ ਜਿਸ ਵਿੱਚ ਇਸ ਦੇ ਮਾਪਦੰਡ, ਇਸ ਦਾ ਜਵਾਬ ਅਤੇ ਇੱਕ ਬੇਨਤੀ ਹੈ ਜਿਸ ਨੂੰ ਤੁਸੀਂ ਚਲਾ ਸਕਦੇ ਹੋ।
| ਢੰਗ | ਪਾਥ | ਇਹ ਕੀ ਕਰਦਾ ਹੈ | ਇਜਾਜ਼ਤ |
|---|---|---|---|
| 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 |