openapi: 3.1.0
info:
  title: Elastic Observability (APM Server) Agent Configuration Intake API
  version: 8.x
  description: Elastic Observability exposes the APM Server intake and configuration APIs used by APM agents and the OpenTelemetry / Jaeger compatibility paths to deliver logs, metrics, and traces into the Elastic Stack.
  contact:
    name: Elastic
    url: https://www.elastic.co/guide/en/observability/current/index.html
servers:
- url: https://{host}:{port}
  description: APM Server
  variables:
    host:
      default: localhost
    port:
      default: '8200'
security:
- bearerAuth: []
- apiKeyAuth: []
tags:
- name: Intake
paths:
  /intake/v2/events:
    post:
      summary: APM agent event intake
      description: Newline-delimited JSON stream of transactions, spans, errors, and metricsets from APM agents.
      operationId: intakeEvents
      tags:
      - Intake
      requestBody:
        required: true
        content:
          application/x-ndjson:
            schema:
              type: string
      responses:
        '202':
          description: Accepted
        '400':
          description: Invalid event(s)
  /intake/v2/rum/events:
    post:
      summary: RUM (Real User Monitoring) event intake
      operationId: intakeRumEvents
      tags:
      - Intake
      requestBody:
        required: true
        content:
          application/x-ndjson:
            schema:
              type: string
      responses:
        '202':
          description: Accepted
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Secret token
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization