PocketCI

Appearance

Pipelines API ​

Manage stored pipelines on the server.

List Pipelines ​

GET /api/pipelines

Returns a paginated list of pipelines.

bash
curl http://localhost:8080/api/pipelines

Create or Update Pipeline ​

PUT /api/pipelines/:name

Store a new pipeline or update an existing one.

bash
curl -X PUT http://localhost:8080/api/pipelines/my-pipeline \
  -H "Content-Type: application/json" \
  -d '{
    "content": "export const pipeline = async () => { console.log(\"test\"); };",
    "driver_dsn": "docker://",
    "webhook_secret": "optional-secret"
  }'

Get Pipeline ​

GET /api/pipelines/:name

Retrieve a specific pipeline's metadata and source.

bash
curl http://localhost:8080/api/pipelines/my-pipeline

Delete Pipeline ​

DELETE /api/pipelines/:name

Remove a pipeline.

bash
curl -X DELETE http://localhost:8080/api/pipelines/my-pipeline

Trigger Pipeline ​

POST /api/pipelines/:name/run

Execute a stored pipeline and stream output back as Server-Sent Events.

bash
curl -X POST http://localhost:8080/api/pipelines/my-pipeline/run \
  -H "Content-Type: application/json" \
  -d '{"args": ["arg1", "arg2"]}'

Response is an SSE stream with events:

  • {"stream":"stdout","data":"..."} — container stdout
  • {"stream":"stderr","data":"..."} — container stderr
  • {"event":"exit","code":0,"run_id":"..."} — pipeline finished
  • {"event":"error","message":"..."} — fatal error

See pocketci run for client-side usage.