curl --request POST \
--url https://registry.{region}.basaltic.sh/v1/repositories \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "team/api",
"tag_mutability": "mutable",
"deletion_protection": false,
"tags": {}
}
'import requests
url = "https://registry.{region}.basaltic.sh/v1/repositories"
payload = {
"name": "team/api",
"tag_mutability": "mutable",
"deletion_protection": False,
"tags": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'team/api',
tag_mutability: 'mutable',
deletion_protection: false,
tags: {}
})
};
fetch('https://registry.{region}.basaltic.sh/v1/repositories', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://registry.{region}.basaltic.sh/v1/repositories",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'team/api',
'tag_mutability' => 'mutable',
'deletion_protection' => false,
'tags' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://registry.{region}.basaltic.sh/v1/repositories"
payload := strings.NewReader("{\n \"name\": \"team/api\",\n \"tag_mutability\": \"mutable\",\n \"deletion_protection\": false,\n \"tags\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://registry.{region}.basaltic.sh/v1/repositories")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"team/api\",\n \"tag_mutability\": \"mutable\",\n \"deletion_protection\": false,\n \"tags\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://registry.{region}.basaltic.sh/v1/repositories")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"team/api\",\n \"tag_mutability\": \"mutable\",\n \"deletion_protection\": false,\n \"tags\": {}\n}"
response = http.request(request)
puts response.read_body{
"repository": {
"id": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"crn": "crn:registry:sa-saopaulo-1:my-account:repository/team/api",
"name": "team/api",
"uri": "cr.sa-saopaulo-1.basaltic.cloud/my-account/team/api",
"tag_mutability": "mutable",
"deletion_protection": false,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"tags": {
"env": "prod",
"team": "platform"
},
"stats": {
"image_count": 42,
"tag_count": 17,
"size_bytes": 1073741824,
"last_pushed_at": "2023-11-07T05:31:56Z"
}
},
"push_commands": [
"basaltic registry get-login-password --region sa-saopaulo-1 | docker login --username basaltic --password-stdin cr.sa-saopaulo-1.basaltic.cloud",
"docker build -t cr.sa-saopaulo-1.basaltic.cloud/my-account/team/api:latest .",
"docker push cr.sa-saopaulo-1.basaltic.cloud/my-account/team/api:latest"
]
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"params": {
"instances": 2,
"pools": 0
}
}
}{
"error": {
"code": "IDEMPOTENCY_KEY_REUSED",
"message": "This Idempotency-Key was already used with a different request payload",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Create a repository
A repository must exist before anything can be pushed to it. There
is no create-on-push: a repository carries quota, resource tags, a
tag-mutability setting, and possibly a resource policy, and
conjuring one from a typo in a docker push would produce an
unlabelled, unpoliced repository nobody meant to make.
The name is immutable. It is the CRN every IAM policy names and the reference every deployment manifest pulls, so renaming would silently invalidate both.
curl --request POST \
--url https://registry.{region}.basaltic.sh/v1/repositories \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "team/api",
"tag_mutability": "mutable",
"deletion_protection": false,
"tags": {}
}
'import requests
url = "https://registry.{region}.basaltic.sh/v1/repositories"
payload = {
"name": "team/api",
"tag_mutability": "mutable",
"deletion_protection": False,
"tags": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'team/api',
tag_mutability: 'mutable',
deletion_protection: false,
tags: {}
})
};
fetch('https://registry.{region}.basaltic.sh/v1/repositories', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://registry.{region}.basaltic.sh/v1/repositories",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'team/api',
'tag_mutability' => 'mutable',
'deletion_protection' => false,
'tags' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://registry.{region}.basaltic.sh/v1/repositories"
payload := strings.NewReader("{\n \"name\": \"team/api\",\n \"tag_mutability\": \"mutable\",\n \"deletion_protection\": false,\n \"tags\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://registry.{region}.basaltic.sh/v1/repositories")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"team/api\",\n \"tag_mutability\": \"mutable\",\n \"deletion_protection\": false,\n \"tags\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://registry.{region}.basaltic.sh/v1/repositories")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"team/api\",\n \"tag_mutability\": \"mutable\",\n \"deletion_protection\": false,\n \"tags\": {}\n}"
response = http.request(request)
puts response.read_body{
"repository": {
"id": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"crn": "crn:registry:sa-saopaulo-1:my-account:repository/team/api",
"name": "team/api",
"uri": "cr.sa-saopaulo-1.basaltic.cloud/my-account/team/api",
"tag_mutability": "mutable",
"deletion_protection": false,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"tags": {
"env": "prod",
"team": "platform"
},
"stats": {
"image_count": 42,
"tag_count": 17,
"size_bytes": 1073741824,
"last_pushed_at": "2023-11-07T05:31:56Z"
}
},
"push_commands": [
"basaltic registry get-login-password --region sa-saopaulo-1 | docker login --username basaltic --password-stdin cr.sa-saopaulo-1.basaltic.cloud",
"docker build -t cr.sa-saopaulo-1.basaltic.cloud/my-account/team/api:latest .",
"docker push cr.sa-saopaulo-1.basaltic.cloud/my-account/team/api:latest"
]
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"params": {
"instances": 2,
"pools": 0
}
}
}{
"error": {
"code": "IDEMPOTENCY_KEY_REUSED",
"message": "This Idempotency-Key was already used with a different request payload",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}registry:CreateRepository. See REGISTRY permissions for the full list, what each one covers, and an example policy.Authorizations
An OAuth 2.0 bearer token, sent as Authorization: Bearer <token>.
This is the recommended way to authenticate.
Get one by exchanging a service account's access key pair at
POST /v1/oauth/token with grant_type=client_credentials. It is the
standard client-credentials grant, so any OAuth-aware library will
obtain and refresh it for you.
curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \
https://iam.basaltic.sh/v1/oauth/token
Tokens last an hour by default. The same access key pair is separately your AWS SigV4 credential for the S3-compatible object endpoint, which speaks nothing else.
Headers
Optional client-generated key that makes a create replay-safe. Retrying a request with the same key returns the original outcome verbatim instead of creating a duplicate resource. Reusing a key with a different request body is rejected (422); a request whose key is still being processed returns 409. Records are honored for 24 hours. Use a UUID or similarly unique token.
255Body
Resource names must not start with the literal crn: prefix or be UUIDs (canonical, compact, braced, or urn:uuid: forms, in either case).
191"team/api"
mutable, immutable Show child attributes
Show child attributes
Response
Repository created.
Show child attributes
Show child attributes
The login/build/push sequence for this repository. Rendered server-side because the login username, the endpoint, and the account handle's position in the reference all come from service configuration.
[
"basaltic registry get-login-password --region sa-saopaulo-1 | docker login --username basaltic --password-stdin cr.sa-saopaulo-1.basaltic.cloud",
"docker build -t cr.sa-saopaulo-1.basaltic.cloud/my-account/team/api:latest .",
"docker push cr.sa-saopaulo-1.basaltic.cloud/my-account/team/api:latest"
]

