---
title: "Ingest Record Event"
method: POST
path: "/sessions/records/ingest"
tags: ["Sessions", "Sessions"]
---

# Ingest Record Event

`POST /sessions/records/ingest`

## Request body

- union
  - SessionRecordIngestRequest
    - `session_id` string, required
    - `kind` 'frame', nullable
    - `record_id` string, uuid, nullable
    - `record_index` integer, nullable
    - `timestamp` string, date-time, nullable
    - `record_type` string, nullable
    - `record_source` string, nullable
    - `attributes` object, nullable
    - `turn_id` string, nullable
    - `span_id` string, nullable
    - `version` 1, nullable
    - `execution_id` string, nullable
    - `frame_or_event_id` string, nullable
    - `frame_index` integer, nullable
    - `entity_id` string, nullable
    - `type` string, nullable
    - `payload` object, nullable
    - `created_at` string, date-time, nullable
  - SessionRecordIngestRequest[]
    - `session_id` string, required
    - `kind` 'frame', nullable
    - `record_id` string, uuid, nullable
    - `record_index` integer, nullable
    - `timestamp` string, date-time, nullable
    - `record_type` string, nullable
    - `record_source` string, nullable
    - `attributes` object, nullable
    - `turn_id` string, nullable
    - `span_id` string, nullable
    - `version` 1, nullable
    - `execution_id` string, nullable
    - `frame_or_event_id` string, nullable
    - `frame_index` integer, nullable
    - `entity_id` string, nullable
    - `type` string, nullable
    - `payload` object, nullable
    - `created_at` string, date-time, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-05** `9fe8525d5c27` — 1 breaking, 9 warning, 1 info
  - the request's body type changed from `object` to no type
  - removed the request property `attributes`
  - removed the request property `record_id`
  - removed the request property `record_index`
  - …7 more
- **2026-08-03** `fc532d6dc820` — 2 info
  - added the new optional request property `span_id`
  - added the new optional request property `turn_id`
- **2026-07-25** `5a14788d939f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/sessions/records/ingest/post.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agenta-ai/apis/agenta-api/revisions/79bf3f8a0683?raw)