Trace session model. There can only be one active session at a moment on a pipeline. Either terminate it and create a new one, or update and extend the lifespan of the current active one.
GET /v1/pipelines/{pipelineID}/trace_session HTTP/1.1 Host: cloud-api.calyptia.com Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
OK
{ "id": "123e4567-e89b-12d3-a456-426614174000", "pipelineID": "123e4567-e89b-12d3-a456-426614174000", "plugins": [ "dummy.0" ], "lifespan": "10m", "createdAt": "2025-05-11T19:38:52.599Z", "updatedAt": "2025-05-11T19:38:52.599Z" }
Response body when a trace session is terminated.
DELETE /v1/pipelines/{pipelineID}/trace_session HTTP/1.1 Host: cloud-api.calyptia.com Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
{ "id": "123e4567-e89b-12d3-a456-426614174000", "lifespan": "10m", "updatedAt": "2025-05-11T19:38:52.599Z" }