Components
Set a component's status
Scope: component:write
Authorization
bearerAuth An API key, or an access token minted from one. Pass it in the Authorization header: Bearer admp_...
In: header
Path Parameters
The component_id path parameter.
^cmp-[0-9a-z]+$Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
SetComponentStatusRequest names a component, its new status, and why. set_component_status.reason // a deprecated component needs a reason set_component_status.successor // only a deprecated component names a successor
Response Body
application/json
curl -X POST "https://example.com/v1/components/string/set-status" \ -H "Content-Type: application/json" \ -d '{ "status": "STATUS_UNSPECIFIED" }'{ "component": { "id": "string", "name": "string", "description": "string", "labels": { "property1": "string", "property2": "string" }, "tags": [ { "name": "string", "digest": "string", "immutable": true, "created_at": "2023-01-15T01:30:15.01Z", "updated_at": "2023-01-15T01:30:15.01Z" } ], "created_by": { "id": "string", "display_name": "string", "email": "string" }, "created_at": "2023-01-15T01:30:15.01Z", "updated_at": "2023-01-15T01:30:15.01Z", "status": "STATUS_UNSPECIFIED", "status_reason": "string", "status_changed_at": "2023-01-15T01:30:15.01Z", "successor_component_id": "string" }}Publish a component version POST
The bundle is a gzipped tar of the component root, carried inline and capped at 64 MiB; a fully vendored tree that exceeds it will get a resumable upload path of its own. The server normalizes the bytes (strips `.git`, canonicalizes entry order and timestamps), digests them, runs the publish gate, stores the blob and answers with the version. If the digest already exists under the name, the existing version is returned with `unchanged` set and nothing is written, which is what makes a publish-everything CI recipe safe. Any tags named in the request are set on the resulting version. Repointing a semver tag is refused with FAILED_PRECONDITION and the whole publish fails; the bytes are not kept. Scope: `component:publish`
Set a tag PUT
Scope: `component:publish`