openapi: 3.1.0
info:
  title: Atlassian Compass REST Events API
  version: '2.0'
  description: 'Atlassian Compass is a developer experience platform with a software

    component catalog, scorecards, metrics, and event ingestion. This

    document describes the public REST API v2 (`/compass/v1`) used to send

    metric values and events. Most Compass operations (querying components,

    scorecards, dependencies, etc.) are exposed via the Compass GraphQL API

    at https://api.atlassian.com/graphql and not enumerated here.

    '
  contact:
    name: Atlassian Developer
    url: https://developer.atlassian.com/cloud/compass/
servers:
- url: https://api.atlassian.com
  description: Atlassian Cloud edge gateway
tags:
- name: Events
  description: Ingest events into a Compass event source
paths:
  /compass/v1/events:
    post:
      tags:
      - Events
      summary: Send an event into an event source
      description: 'Sends an event into a Compass event source. Returns 202 Accepted

        and processes the event asynchronously. Rate limited to 100 requests

        per user per minute.

        '
      security:
      - oauth2:
        - write:event:compass
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InsertEventRequest'
      responses:
        '202':
          description: Event accepted for processing
        '429':
          description: Rate limited
components:
  schemas:
    InsertEventRequest:
      type: object
      required:
      - eventSourceId
      - payload
      properties:
        eventSourceId:
          type: string
        externalEventId:
          type: string
        displayName:
          type: string
        description:
          type: string
        url:
          type: string
          format: uri
        lastUpdated:
          type: string
          format: date-time
        payload:
          type: object
          description: Event-specific payload (e.g. deployment, incident, build)
  securitySchemes:
    oauth2:
      type: oauth2
      description: OAuth 2.0 (3LO) for Atlassian Cloud
      flows:
        authorizationCode:
          authorizationUrl: https://auth.atlassian.com/authorize
          tokenUrl: https://auth.atlassian.com/oauth/token
          scopes:
            write:metric:compass: Send metric values
            write:event:compass: Send events
            read:component:compass: Read component data
            write:component:compass: Write component data