Skip to content

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.

organisation
required
string

The organisation ID

Example
test-org
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

The created resource

Media typeapplication/json
Shared resource
object
orgName
string
resourceId
string
type
string
Allowed values: object-storage valkey
name
string
status
string
Allowed values: provisioning 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

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

A resource with this name already exists

Invalid type, name or cache capacity