Points the site at an existing release — the go-live, and equally the ROLLBACK.
Points the site at an existing release — the go-live, and equally the ROLLBACK.
POST /v1/projects/{slug}/releases/{release}/activate
| Address | https://api.hanzo.ai/v1/projects/{slug}/releases/{release}/activate |
| Method | POST |
| Operation | post_projects_by_slug_releases_by_release_activate |
| Auth | Authorization: Bearer $HANZO_API_KEY |
Points the site at an existing release — the go-live, and equally the ROLLBACK.
Aim it at an older release and the site serves that one again: releases are immutable and retained to the retention depth, so nothing is rebuilt or re-copied and the flip is one atomic statement. Before the flip, two conditions run in the order that gives each its own honest answer — the ROW says whether this release exists for this tenant at all (404, with no signal about a foreign id), and only then do the BYTES say whether it can still serve (410 GONE when retention has reclaimed them; that rollback target is not coming back, so publish again). Going live also claims the public host and purges the edge, so the release is reachable and no cached predecessor is served. NOT billed: no new content is produced, only a pointer moved.
Scope: a validated principal is required (403 without one) and the site is resolved within that principal's org, so another tenant's slug is a 404.
Request
2 fields.
| Field | In | Type | Required | Description |
|---|---|---|---|---|
slug | path | string | yes | Slug is the site the release belongs to, from the path. |
release | path | string | yes | Release is the content-addressed release id ("rel_" + 32 hex chars), from the path. |
Response
| Status | Body | Meaning |
|---|---|---|
200 | projectsRelease | ok |
200 body — 8 fields.
| Field | In | Type | Always | Description |
|---|---|---|---|---|
active | body | boolean | — | Active is whether this is the release the site is SERVING right now. |
bytes | body | integer | — | Bytes is their total size in bytes. |
createdAt | body | integer | — | CreatedAt is when the release was cut, as Unix seconds — not when it was last activated. |
objects | body | integer | — | Objects is how many files the release holds. |
releaseId | body | string | — | ReleaseID is derived from a DIGEST of the release's own manifest, so identical content is the same release and a release can never be confused with another… |
slug | body | string | — | Slug is the site this release belongs to. |
source | body | string | — | Source is what the release was cut from — the build output or upload it was promoted out of. |
url | body | string | — | URL is where the site serves. |
Failure carries the platform error shape — see Errors.
Examples
hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.
import { Configuration, ProjectsApi } from 'hanzoai';
const api = new ProjectsApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.postProjectsBySlugReleasesByReleaseActivate({ slug: 'slug', release: 'release' });from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import ProjectsApi
client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = ProjectsApi(client).post_projects_by_slug_releases_by_release_activate(slug='slug', release='release')cfg := cloud.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := cloud.NewAPIClient(cfg)
resp, _, err := client.ProjectsAPI.PostProjectsBySlugReleasesByReleaseActivate(context.Background()).Execute()
if err != nil {
return err
}use hanzo_cloud::apis::{configuration::Configuration, projects_api};
let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();
let result = projects_api::post_projects_by_slug_releases_by_release_activate(&cfg, Default::default()).await?;import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.ProjectsApi;
ApiClient client = new ApiClient();
client.setRequestInterceptor(b -> b.header("Authorization", "Bearer " + System.getenv("HANZO_API_KEY")));
var result = new ProjectsApi(client).postProjectsBySlugReleasesByReleaseActivate();The method above is the one at the current release of the document. [email protected] (npm) and [email protected] (PyPI) were generated from an earlier release, where this operation carried a different id, so it spells the method differently — regenerating the clients is what makes the two agree. SDKs →
curl -X POST https://api.hanzo.ai/v1/projects/<slug>/releases/<release>/activate \
-H "Authorization: Bearer $HANZO_API_KEY"The door reaches projects through the projects tool, which names its 48 operations with its own verbs — this one among them, under a name only the door declares. describe explains any of them:
curl -X POST https://api.hanzo.ai/v1/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "describe",
"arguments": {
"op": "list_projects"
}
}
}'How is this guide?