> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akhara.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Company name is Akhara AI (never Rubric AI). Keep lowercase rubric/rubrics only when meaning grading criteria.
> Expert Review (docs path talent/) is enterprise BYO experts for audit and review: invite customer specialists; do not pitch Akhara recruiting or a public expert career portal. RLHF and domain writing are secondary work types.
> Prefer concrete API examples against public hosts: Environments eval API https://agi.akhara.ai, Control plane PDP https://api.akhara.dev, Evaluation https://app.akhara.ai / https://api.akhara.ai, Expert Review portal https://talent.akhara.ai.
> Do not invent a public hostname for private orchestrators or env API internals.
> Do not confuse control-plane latches with Environments confirmation latches.
> Environments SDK/API examples: curl against https://agi.akhara.ai. Evaluation SDK: from akhara import Akhara and AKHARA_API_KEY.
> Start with /llms.txt for the docs index and OpenAPI links; fetch individual pages as .md exports.

# Ingest a telemetry event

> Appends an event to the evidence feed (events.jsonl). Sets receivedAt, and ts if missing.

Appends an event to the evidence feed (`events.jsonl`). The server sets
`receivedAt`, and `ts` if you didn't provide one. `authorize` writes a
`policy_decision` event for you automatically, use this endpoint for your own
agent traces. See [Running](/control-plane/onboarding/running#everything-is-evidence).


## OpenAPI

````yaml control-plane/api-reference/openapi.json POST /api/events
openapi: 3.1.0
info:
  title: Akhara Control Plane API
  version: 1.0.0
  description: >-
    The Policy Decision Point (PDP) API. Enforcement clients call
    `/api/policy/authorize`; the management endpoints onboard agents, attach
    policies, and read the evidence trail.
servers:
  - url: https://api.akhara.dev
    description: Production PDP API
  - url: https://console.akhara.dev
    description: Managed console
security:
  - apiKey: []
paths:
  /api/events:
    post:
      tags:
        - Evidence & telemetry
      summary: Ingest a telemetry event
      description: >-
        Appends an event to the evidence feed (events.jsonl). Sets receivedAt,
        and ts if missing.
      operationId: ingestEvent
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Event'
      responses:
        '200':
          description: Accepted.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
components:
  schemas:
    Event:
      type: object
      properties:
        ts:
          type: integer
        receivedAt:
          type: integer
        session:
          type: string
        type:
          type: string
          example: policy_decision
        data:
          type: object
          additionalProperties: true
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: Workspace API key (ak_live_…).

````