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

# Receber traces OTLP

> Traces de OpenTelemetry com atributos gen_ai.*, convertidos em eventos.



## OpenAPI

````yaml openapi/pt/cell.json POST /v1/otel/v1/traces
openapi: 3.1.0
info:
  title: API de dados da Niadra
  version: '1'
  description: >-
    Escrita, contexto, histórico, objetos, identidade, privacidade e governança
    de um espaço. Cada espaço tem um endereço estável, com o espaço e a região
    no nome.
servers:
  - url: https://{space}.{region}.api.niadra.com
    variables:
      space:
        default: acme-prod
        description: O espaço, que vem na chave de fonte.
      region:
        default: us-east-1
        description: A região do espaço, que também vem na chave.
security: []
paths:
  /v1/otel/v1/traces:
    post:
      tags:
        - ingest
      summary: Receber traces OTLP
      description: >-
        Endpoint de traces OTLP/HTTP. Spans com atributos `gen_ai.*` viram
        mensagens e ações por um mapeador versionado com alternativas, porque as
        convenções semânticas `gen_ai` ainda mudam. Não existe atributo padrão
        do OpenTelemetry para canal: defina `niadra.channel` e os atributos de
        handle do cliente no span.


        **Autenticação.** Chave de fonte: `Authorization: Bearer nia_sk_...`.
        Escopo exigido: `track`.
      operationId: otel_traces_v1_otel_v1_traces_post
      responses:
        '200':
          content:
            application/json:
              schema: {}
          description: >-
            Os spans depois do mapeador, como resultado de lote: aceitos,
            duplicados e um erro por span recusado.
      security:
        - sourceKey: []
components:
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...

````