Persist Session History

Persist session history from worker to Control Plane database.

Worker POSTs session messages after each run completion. This ensures history is available even when worker is offline.

Sessions are stored in database for fast loading by the UI streaming endpoint.

POST /api/v1/executions/{execution_id}/session

Persist Session History

cURL

curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/executions/{execution_id}/session \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Enter your Kubiya API token (format: Bearer )

Path Parameters

execution_id · string · required

Body

application/json

The body is of type Session Data · object.

Response

201

application/json

Successful Response