External Services

Import an existing Docker container as a managed external service

Changed on
post/external-services/import

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/external-services/import
  • Auth: HTTP bearer

Request body

container_idstring required

Container ID or name to import

namestring required

Name to register the service as in Temps

parametersobject required

Service configuration parameters

service_type'mariadb' | 'mongodb' | 'postgres' | 'redis' | 's3' | 'kv' | 'blob' | 'rustfs' | 'minio' required
versionstring nullable

Optional version override

Example request

{
  "container_id": "abc123def456",
  "name": "production-database"
}

Response

Service imported successfully

connection_infostring nullable
continuous_archive_pinned_atstring nullable

When continuous_archive_s3_source_id was last set. Null alongside a non-null source id means it was set by the original provisioning flow rather than an explicit repoint.

continuous_archive_s3_source_idinteger nullable

S3 source ID that this service's continuous archiving (Postgres/ Timescale WAL-G archive_command, or MariaDB's binlog shipper) currently writes to. Null for service types with no continuous archiving concept, or a Postgres/MariaDB service that has never had one provisioned. Change it with repoint_continuous_archive_source.

created_atstring required
error_messagestring nullable

Error message from failed initialization.

idinteger required
metrics_enabledboolean

Whether metric collection is enabled for this service. The UI uses this to decide whether to poll the monitoring endpoints.

namestring required
node_idinteger nullable

Node ID where the service runs. Null means control plane (local).

service_type'mariadb' | 'mongodb' | 'postgres' | 'redis' | 's3' | 'kv' | 'blob' | 'rustfs' | 'minio' required
statusstring required
topologystring required

Service topology: "standalone" (single container) or "cluster" (HA multi-member).

updated_atstring required
versionstring nullable

Example response

{
  "topology": "standalone"
}

Changes