Container registries

Update a container registry

Update a project's container registry configuration. Requires project admin. Credentials can be omitted to keep existing values.

PUT
/v1/orgs/{org}/projects/{project}/registries/{name}

Update a project's container registry configuration. Requires project admin. Credentials can be omitted to keep existing values.

AuthorizationBearer <token>

API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.

In: header

Path Parameters

org*string

Organization name

Match^[a-z0-9][a-z0-9-]*[a-z0-9]$
Length2 <= length <= 64
project*string

Project name

Match^[a-z0-9][a-z0-9-]*[a-z0-9]$
Length2 <= length <= 64
name*string

Registry name

Match^[a-z0-9][a-z0-9-]*[a-z0-9]$
Length2 <= length <= 64

Query Parameters

dry_run?boolean

Test connection without saving

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

auth_type*string

Authentication type

Default"personal_access_token"
Value in"basic" | "personal_access_token" | "bearer"
display_name*string

Human-readable registry name

Length1 <= length <= 100
endpoint*string

Registry hostname (e.g. ghcr.io, docker.io)

Length1 <= length <= 255
name*string

URL-safe registry identifier

Match^[a-z0-9][a-z0-9-]*[a-z0-9]$
Length2 <= length <= 64
namespace?string

Path prefix within the registry (e.g. my-org for ghcr.io)

Lengthlength <= 255
password?string

Password (omit to keep existing)

Lengthlength <= 255
token?string

Token (omit to keep existing)

Lengthlength <= 4096
username?string

Username (omit to keep existing)

Lengthlength <= 255

Response Body

application/json

application/problem+json

curl -X PUT "https://api-dev.tektona.ai/v1/orgs/string/projects/string/registries/string" \  -H "Content-Type: application/json" \  -d '{    "auth_type": "basic",    "display_name": "string",    "endpoint": "string",    "name": "string"  }'
{  "$schema": "https://api-dev.tektona.ai/schemas/RegistryResponse.json",  "auth_type": "basic",  "created_at": "string",  "display_name": "My GitHub Registry",  "endpoint": "ghcr.io",  "has_credentials": true,  "id": "string",  "name": "my-ghcr",  "namespace": "my-org",  "owner": {    "project": {      "display_name": "string",      "name": "string"    },    "type": "project"  },  "updated_at": "string"}