Managed services are curated databases and storage offerings. Pick an offering by slug and we handle provisioning, upgrades, and sensible defaults.
List managed services
Create a managed service
Provision a curated database or storage offering. Env vars and volume size can be overridden. The image, port, startup command, and default volume layout come with the offering.
Available offerings (pick one via slug):
postgres-16: PostgreSQL 16valkey-8: Valkey 8, a Redis-compatible cache and storeminio: MinIO, S3-compatible object storage
path Parameters
workspace_idproject_idCreate a managed service › Request Body
nameslugtagsvolume_sizeCreate a managed service › Responses
Managed service created
messagestatusGet a managed service
Returns the managed service's configuration: the slug of the
offering it was created from, the resolved image, and any applied
overrides.
path Parameters
workspace_idproject_idmanaged_service_idGet a managed service › Responses
Managed service detail
messagestatusUpdate a managed service
Updates env vars, volume size, resources, and tags. The slug is
immutable. Major-version upgrades are a delete-and-recreate flow.
path Parameters
workspace_idproject_idmanaged_service_idUpdate a managed service › Request Body
nametagsvolume_sizeUpdate a managed service › Responses
Updated
messagestatusDelete a managed service
Removes the managed service and all of its backing resources, including volumes. Data is permanently lost. Irreversible.
path Parameters
workspace_idproject_idmanaged_service_idDelete a managed service › Responses
Deleted
datamessagestatusGet managed service logs
Returns stdout and stderr lines from every instance within the
requested time window. Supply ?since=<seconds> for a relative
window, or ?start=<ISO 8601 timestamp>&end=<ISO 8601 timestamp>
for an absolute one.
path Parameters
workspace_idproject_idmanaged_service_idquery Parameters
sincestartendlimitfilterGet managed service logs › Responses
Logs
messagestatusGet managed service metrics
Returns a batch of time series for the requested metrics. Pass a
comma-separated list in ?names=. Each metric's result is wrapped
with its own status so one failing query does not fail the whole
request.
Available metrics:
cpu_usage: average CPU across instances, in coresmemory_usage: total memory across instances, in bytes
Offering-specific metrics such as connection counts, cache hit ratios, and storage used are on the near-term roadmap.
path Parameters
workspace_idproject_idmanaged_service_idquery Parameters
namessincestartendGet managed service metrics › Responses
All metrics succeeded
messagestatusRestart a managed service
Triggers a rolling restart of every instance. Useful for picking up env var changes such as a rotated password. Instances are replaced one at a time so clients are never interrupted.
path Parameters
workspace_idproject_idmanaged_service_idRestart a managed service › Responses
Restart triggered
datamessagestatusScale a managed service
Adjusts the number of running instances. Useful for read replicas of supported databases. Scaling to 0 pauses the service without deleting its data.
path Parameters
workspace_idproject_idmanaged_service_idScale a managed service › Responses
Scaled
datamessagestatusGet managed service status
Returns live instance counts (total, ready) and whether the service is currently available. Poll after a create, update, scale, or restart to know when the service has converged.
path Parameters
workspace_idproject_idmanaged_service_idGet managed service status › Responses
Status
messagestatus