Coolify

@shrug/coolifyv2026.07.12.3· 19d agoMODELS

01README

Manage a Coolify instance over its REST API v1: list/get services (incl. docker_compose_raw) and applications, patch a service's compose, start/stop/restart applications, add persistent (named-volume) application storage, and trigger deploys/restarts. Mutations are audited, confirm-gated, and preceded by a live reachability pre-flight check.

02Models1

@shrug/coolifyv2026.07.12.3coolify.ts

fn listServices()

List all services on the Coolify instance.

fn getService(uuid: string)

Fetch one service by uuid and snapshot it, including its docker_compose_raw.

Argument	Type	Required	Description
uuid	string	yes	Service uuid

fn updateServiceCompose(uuid: string)

Replace a service's docker_compose_raw (base64-encoded on the wire) via PATCH. Gated behind confirm:true. Records an audit attempt on both paths.

Argument	Type	Required	Description
uuid	string	yes	Service uuid

fn deploy(uuid: string)

Trigger a (re)deploy of a service by uuid. Gated behind confirm:true. Records an audit attempt.

Argument	Type	Required	Description
uuid	string	yes	Service uuid to deploy

fn restartService(uuid: string)

Restart a service (optionally pulling latest images). Records an audit attempt.

Argument	Type	Required	Description
uuid	string	yes	Service uuid

fn listApplications()

List all applications on the Coolify instance.

fn getApplication(uuid: string)

Fetch one application by uuid and snapshot it.

Argument	Type	Required	Description
uuid	string	yes	Application uuid

fn controlApplication(uuid: string)

Start, stop, or restart an application by uuid. Gated behind confirm:true for all three actions (one predictable rule, even though `start` is arguably safe). Records an audit attempt on both paths. NOTE: to pick up a freshly built image, use `deploy` — there is no `?latest=` pull-latest param on the application restart endpoint (that exists only for services); `restart` recreates the app from its current image/build without pulling.

Argument	Type	Required	Description
uuid	string	yes	Application uuid

fn createApplicationStorage(uuid: string, name: string)

Add a persistent (named-volume) storage to an application so its data survives redeploys. POST /applications/{uuid}/storages. Gated behind confirm:true; records an audit attempt on both paths. Takes effect on the next deploy.

Argument	Type	Required	Description
uuid	string	yes	Application uuid
name	string	yes	Storage name (label in Coolify)

Resources

services(infinite)— Snapshot of all services on the instance

service(infinite)— Snapshot of one service, including its docker_compose_raw

applications(30d)— Snapshot of all applications on the instance

application(infinite)— Snapshot of one application

deployment(infinite)— Record of a triggered deploy

attempt(infinite)— Audit record of a mutation attempt (request + result/error + timestamp). Written on both success and failure.

03Previous Versions6

2026.07.12.2Jul 12, 2026

v2026.07.12.2: getApplication captures the full Coolify application record verbatim (raw) plus curated fields incl. dockerImageTag/buildPack; listApplications summary gains dockerImageTag.

2026.07.12.1Jul 12, 2026

v2026.07.12.1: application surface — listApplications, getApplication, controlApplication (start/stop/restart, confirm-gated, audited). deploy remains the app pull-latest path. Additive; services unchanged.

Modified 1 models

2026.07.11.4Jul 11, 2026

2026.07.11.3Jul 11, 2026

2026.07.11.2Jul 11, 2026

2026.07.11.1Jul 11, 2026

04Stats

100 / 100

Downloads

Archive size

14.0 KB