Skip to content
QuantCDN

Create a shared resource

POST
/api/v3/organizations/{organisation}/resources
curl --request POST \
  --url https://dashboard.quantcdn.io/api/v3/organizations/test-org/resources \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "type": "object-storage", "name": "buzz-media", "config": { "dataStorageMaxGb": 2 } }'

Object storage is provisioned synchronously and returns status available. A Valkey cache is asynchronous and returns status provisioning; poll the show endpoint until it reports available.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
organisation
required
string

The organisation ID

Example
test-org

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
type
required
string
Allowed values: object-storage valkey
Example
object-storage
name
required

Lowercase letters, numbers and hyphens, 2-41 characters, starting with a letter or number

string
Example
buzz-media
config

Valkey only

object
dataStorageMaxGb
integer
>= 1 <= 50
Example
2

Responses

Section titled “Responses”

201

Section titled “201”

The created resource

Media typeapplication/json
Shared resource
object
orgName
string
resourceId
string
type
string
Allowed values: object-storage valkey ci-runner-pool
name
string
status

Creating and updating apply to a CI runner pool

string
Allowed values: provisioning creating updating available deleting error
scope

Org for resources managed by these endpoints. app rows are compatibility records for an application-managed cache and cannot be mutated here.

string
Allowed values: org app
config

Type-specific settings, such as dataStorageMaxGb for a cache

object
physical

Provisioned detail: bucket and region for object storage, cache identifier and endpoint for a cache. Not returned for a CI runner pool.

object
createdAt
string format: date-time
Example
{
  "orgName": "test-org",
  "resourceId": "os-buzz-media",
  "type": "object-storage",
  "name": "buzz-media",
  "status": "provisioning",
  "scope": "org"
}

409

Section titled “409”

A resource with this name already exists

422

Section titled “422”

Invalid type, name or cache capacity