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

# Ingest events to Togai

`POST /ingest`

This API let’s you to ingest events to your Togai account.
Events ingested using this API will be processed via associated usage meters and further via associated price plans to generate final billable value to invoice the customer
Read more about [Event Ingestion](https://docs.togai.com/docs/event-ingestion)

## Request body

- IngestEventRequest — Payload for ingesting events
  - `event` Event, required — Contents of the event
    - `schemaName` string, required — Name of the Event Schema. Know more about [event schema](https://docs.togai.com/docs/event-schemas)
    - `id` string — Togai restricts users to ingest events with same id within a period of *45 days*. This restriction is common for [/entitled API](/api-reference/entitlements/ingest-event-if-a-user-is-entitled-to-a-feature), [/ingest API](/api-reference/event-ingestion/ingest-events-to-togai) and [/ingestBatch API](/api-reference/event-ingestion/ingest-events-to-togai-in-batch). i.e, an id used on /ingest API will not be allowed on /ingestBatch or /entitled APIs
    - `timestamp` string, date-time, required — Source time stamp of the event. This timestamp must be in ISO 8601 format.
    - `accountId` string, required — The event will be associated with the provided account
    - `attributes` Attribute[], required — Attributes are numeric values. It can be usage metric which you push to Togai
      - `name` string, required — Name of the event attribute
      - `value` string, required — Value of the event attribute
      - `unit` string — Unit with which the attribute value was measured. Natively supported units - "Meters, Miles, Kilometers, Grams, Kilograms, ounces, Pounds, Minutes, Hours, Seconds, Milliseconds, Microseconds, None". Clients are free to add any other custom units.
    - `dimensions` Dimensions, required — Dimensions are tags/labels associated with the events.

## Response `202`

Successfully accepted to process all the events from payload.

- IngestEventResponse
  - `success` boolean
  - `statusCode` integer
  - `name` string
  - `message` string
  - `code` string
  - `details` object

## Other responses

- `400` — Bad request. Please check the response message for failure details.
- `401` — Credential "x-api-key" is not valid. Please check the response message for failure details.
- `422` — Unable to process the events as the size of the event payload is above the supported limit. Please check our docs for the api limits - https://togai.com/docs/limits.
- `429` — Request throttled. Please check the response message on the failure details.
- `503` — Service is currently unavailable to process the request.
- `default` — Error response

---

[API](https://skmtc.net/togaihq/apis/togai-apis.md) · [All operations](https://skmtc.net/togaihq/apis/togai-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/togaihq/togai-apis/revisions/442f5d8f4aa0/schema)