Container Registry API reference

Socra Container Registry — private project-scoped OCI distribution.

Published contracts: @socra/scr-api@0.2.0.

Base URL

https://scr.socra.cloud

Container Repositories

A project-scoped OCI repository, created by the first authorized push.

List container repositories

GET/v1/repositories

Query parameters

project_idcustomrequired

status"active" | "disabled"optional

limitintegeroptional

min: 1 · max: 100

afterstringoptional

Response

2 fields

dataobject[]required

idcustomrequired

project_idcustomrequired

accountstringrequired

projectstringrequired

namestringrequired

min length: 1 · max length: 128 · pattern: ^[a-z0-9]+(?:(?:[._]|__|-+)[a-z0-9]+)*$

status"active" | "disabled"required

image_countintegerrequired

min: 0 · max: 9007199254740991

size_bytesintegerrequired

min: 0 · max: 9007199254740991

created_atcustomrequired

updated_atcustomrequired

has_morebooleanrequired

Get container repository

GET/v1/repositories/{id}

Path parameters

idcustomrequired

Query parameters

No query parameters

Response

10 fields

idcustomrequired

project_idcustomrequired

accountstringrequired

projectstringrequired

namestringrequired

min length: 1 · max length: 128 · pattern: ^[a-z0-9]+(?:(?:[._]|__|-+)[a-z0-9]+)*$

status"active" | "disabled"required

image_countintegerrequired

min: 0 · max: 9007199254740991

size_bytesintegerrequired

min: 0 · max: 9007199254740991

created_atcustomrequired

updated_atcustomrequired

Update container repository

PATCH/v1/repositories/{id}

Path parameters

idcustomrequired

Request body

status"active" | "disabled"optional

Response

10 fields

idcustomrequired

project_idcustomrequired

accountstringrequired

projectstringrequired

namestringrequired

min length: 1 · max length: 128 · pattern: ^[a-z0-9]+(?:(?:[._]|__|-+)[a-z0-9]+)*$

status"active" | "disabled"required

image_countintegerrequired

min: 0 · max: 9007199254740991

size_bytesintegerrequired

min: 0 · max: 9007199254740991

created_atcustomrequired

updated_atcustomrequired

Delete empty container repository

DELETE/v1/repositories/{id}

Path parameters

idcustomrequired

Query parameters

No query parameters

Response

No response body

Container Images

An immutable OCI image manifest or index identified by digest.

List container images

GET/v1/images

Query parameters

repository_idcustomrequired

limitintegeroptional

min: 1 · max: 100

afterstringoptional

Response

2 fields

dataobject[]required

idcustomrequired

repository_idcustomrequired

digeststringrequired

pattern: ^sha256:[0-9a-f]{64}$

media_typestringrequired

kind"image" | "index" | "artifact"required

size_bytesintegerrequired

min: 0 · max: 9007199254740991

tagsstring[]required

created_atcustomrequired

has_morebooleanrequired

Get container image

GET/v1/images/{id}

Path parameters

idcustomrequired

Query parameters

No query parameters

Response

8 fields

idcustomrequired

repository_idcustomrequired

digeststringrequired

pattern: ^sha256:[0-9a-f]{64}$

media_typestringrequired

kind"image" | "index" | "artifact"required

size_bytesintegerrequired

min: 0 · max: 9007199254740991

tagsstring[]required

created_atcustomrequired

Delete untagged container image

DELETE/v1/images/{id}

Path parameters

idcustomrequired

Query parameters

No query parameters

Response

No response body

Container Tags

A mutable human-readable reference to an immutable image digest.

List container tags

GET/v1/tags

Query parameters

repository_idcustomrequired

limitintegeroptional

min: 1 · max: 100

afterstringoptional

Response

2 fields

dataobject[]required

idcustomrequired

repository_idcustomrequired

namestringrequired

min length: 1 · max length: 128 · pattern: ^[A-Za-z0-9_][A-Za-z0-9._-]*$

digeststringrequired

pattern: ^sha256:[0-9a-f]{64}$

created_atcustomrequired

updated_atcustomrequired

has_morebooleanrequired

Get container tag

GET/v1/tags/{id}

Path parameters

idcustomrequired

Query parameters

No query parameters

Response

6 fields

idcustomrequired

repository_idcustomrequired

namestringrequired

min length: 1 · max length: 128 · pattern: ^[A-Za-z0-9_][A-Za-z0-9._-]*$

digeststringrequired

pattern: ^sha256:[0-9a-f]{64}$

created_atcustomrequired

updated_atcustomrequired

Delete container tag

DELETE/v1/tags/{id}

Path parameters

idcustomrequired

Query parameters

No query parameters

Response

No response body