---
title: "Ingest Event"
method: POST
path: "/events/ingest"
tags: ["events"]
---

# Ingest Event

`POST /events/ingest`

Ingest an event into the buffer.

## Request body

- EventIngest — Event ingestion request.
  - `data` object, required — Event payload
  - `event_id` string, nullable — Optional deduplication ID
  - `event_type` string, required — Type of event (e.g., push, invoice.paid)
  - `metadata` object, nullable — Optional routing metadata
  - `source` string, required — Event source: github, stripe, slack, manual, etc.
  - `timestamp` number, nullable — Optional timestamp (defaults to now)

## Response `200`

Successful Response

- EventResponse — Event response.
  - `data` object, required
  - `event_type` string, required
  - `id` string, required
  - `metadata` object, nullable
  - `source` string, required
  - `timestamp` number, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/agents-squads/apis/squads-api.md) · [All operations](https://skmtc.dev/agents-squads/apis/squads-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agents-squads/squads-api/revisions/3812730a1cb4/schema)