POST
Mount an application to a service

Authorizations

Authorization
string
header
required

Bearer token for authentication. Format: 'Bearer {token}'

Headers

X-Workspace-Id
string

Workspace ID (uses default workspace if not provided)

Path Parameters

id
string
required

Service UUID

Body

application/json

Mount an application to a service

app_id
string
required

UUID of the application to mount

mount_point
string

Container mount path (e.g., /data). Defaults to the service's mount point.

sub_path
string

Subdirectory of the shared volume to mount instead of its root (relative path, e.g. media/uploads). Created automatically if missing.

label
string

Human-readable label for the mounted addon

Response

Mount an application to a service

Api_V1_Entities_Service model

uuid
string
required

Service UUID

name
string
required

Service name

label
string
required

Display name

service_type
string
required

Service type (postgres, shared_storage)

state
string
required

Current state. While provisioning: pending, processing, creating, stopped. Once running, the live Kubernetes status: healthy (postgres/mysql/valkey), bound (storage), or running when the status is unavailable. Unhealthy: degraded, degradated, failing, lost, crashloopbackoff, failed

project_id
string
required

Associated project UUID

resource_id
string
required

Assigned resource UUID, the value POST /services accepts as resource_id

miget_id
string
required

DEPRECATED: use resource_id instead

ram_size
number<float>
required

RAM allocation in MiB, the unit POST and PUT /services accept, rounded to 6 decimal places. Read from the service add-on's quota. Null when the service has no add-on

disk_size
number<float>
required

Disk allocation in GiB, the unit POST and PUT /services accept, rounded to 6 decimal places. Read from the service add-on's quota. Null when the service has no add-on

cpu_size
number<float>
required

CPU allocation in cores, the unit POST and PUT /services accept. Read from the service add-on's quota. On a free plan, creating a postgres service stores 0.1 whatever cpu_size was sent; PUT stores the value sent. Null when the service has no add-on

public_access
boolean
required

Whether public internet access is enabled, as stored on the add-on and accepted by POST and PUT /services. Null for service types without the setting (shared_storage) or when the service has no add-on

instances
integer<int32>
required

Number of database instances (1 for standalone, 3, 5 or 7 for an HA cluster). Postgres only, null for other service types

postgres_version
string
required

PostgreSQL major version, as accepted by POST /services. Null for other service types

mount_point
string
required

Container mount path of the shared volume. shared_storage only, null for other service types

mounts
object[]
required

Applications mounting this shared storage service, one entry per mount created by POST /services/{id}/mount_app, limited to apps in projects you can access. Empty for other service types

Example:
backup_enabled
boolean
required

Postgres only, null for other service types or when the service has no add-on. The effective value the platform applies, as accepted by PUT /services: false on a free plan whatever was stored, otherwise the stored value, true when never set

scheduled_backup
string
required

Postgres only, null for other service types or when the service has no add-on. The effective backup schedule as a 6-field cron expression, as accepted by PUT /services: the stored schedule, or 0 0 3 * * * when none was set

created_at
string<date-time>
required

Creation timestamp

updated_at
string<date-time>
required

Last update timestamp

connection_details
object
required

Connection details for the service

Example: