Records

Create trace record

post

Authorizations

userproject

Path parameters

pipelineIDstring · uuidRequired

Body

Request body to create a trace record on an active session.

typeinteger · enumRequiredPossible values:

trace_idstringRequiredExample: trace.5

start_timeinteger · int64Required

Unix timestamp with seconds precision.

Example: 1658953439

end_timeinteger · int64Required

Unix timestamp with seconds precision.

Example: 1658953439

plugin_instancestringRequiredExample: nest.2

plugin_aliasstringRequiredExample: nest_2

return_codeintegerRequired

Responses

201

Created

application/json

post

HTTPcURLJavaScriptPython

POST /v1/pipelines/{pipelineID}/trace_session/records HTTP/1.1
Host: cloud-api.calyptia.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 366

{
  "type": 1,
  "trace_id": "trace.5",
  "start_time": 1658953439,
  "end_time": 1658953439,
  "plugin_instance": "nest.2",
  "plugin_alias": "nest_2",
  "return_code": 1,
  "records": [
    {
      "timestamp": 1658953439,
      "record": "{\n  \"dummy\": \"dummy_0\",\n  \"powered_by\": \"calyptia\",\n  \"data\": {\n    \"key_name\": \"foo\",\n    \"key_cnt\": \"1\"\n  }\n}",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ]
}

201

Created

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "sessionID": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-06-06T02:03:25.867Z"
}