Bind a stable Artifact handle

PUT
/v1/scopes/{scope_id}/artifact-handles/{family}/{key}

Idempotently and permanently bind one scope-local handle to an exact immutable Artifact revision. A committed binding cannot be updated, released, or deleted. Repeating the same binding succeeds, while binding the key to another Artifact revision returns 409. Verify the family, Artifact ID, revision, and key before committing the binding; a mistakenly bound key cannot be reused in that Scope.

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer credential resolved to an opaque authenticated Principal by the Server deployment.

In: header

Path Parameters

scope_id*string
Match.*\S.*
Length1 <= length <= 256
family*string
Match^[\x21-\x7E]+$
Length1 <= length <= 128
key*string
Match^[a-z0-9]+(?:-[a-z0-9]+)*$
Length1 <= length <= 128

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/scopes/string/artifact-handles/string/string" \  -H "Content-Type: application/json" \  -d '{    "artifact_id": "string",    "revision": 1  }'
{  "family": "string",  "key": "string",  "artifact": {    "family": "string",    "artifact_id": "string",    "revision": 1  }}

Resolve a stable Artifact handle GET

Resolve one scope-local handle to the exact immutable Artifact revision it names.

Get the current Artifact head GET

Next Page