openapi: 3.2.0
info:
  title: Latitude OAuth Keys API
  version: v1
  description: Open-source AI agent monitoring platform. Full observability into what's failing in production. Discover underlying issues, get alerts when something breaks and verify your fix worked.
  servers:
  - url: https://api.latitude.so
    description: Production
servers:
- url: https://api.latitude.so
tags:
- name: OAuth Keys
paths:
  /v1/oauth-keys:
    get:
      tags:
      - OAuth Keys
      x-fern-sdk-group-name: oauthKeys
      x-fern-sdk-method-name: list
      summary: List OAuth keys
      description: Returns every OAuth key (like MCP clients) connected to the organization.
      security:
      - ApiKeyAuth: []
      operationId: listOAuthKeys
      responses:
        '200':
          description: List of OAuth keys
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OAuthKeyList'
  /v1/oauth-keys/{oauthKeyId}:
    get:
      tags:
      - OAuth Keys
      x-fern-sdk-group-name: oauthKeys
      x-fern-sdk-method-name: get
      summary: Get OAuth key
      description: Returns a single OAuth key (like MCP clients) by id.
      security:
      - ApiKeyAuth: []
      operationId: getOAuthKey
      parameters:
      - schema:
          type: string
          minLength: 1
          description: OAuth key identifier.
        required: true
        description: OAuth key identifier.
        name: oauthKeyId
        in: path
      responses:
        '200':
          description: OAuth key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OAuthKey'
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    delete:
      tags:
      - OAuth Keys
      x-fern-sdk-group-name: oauthKeys
      x-fern-sdk-method-name: revoke
      summary: Revoke OAuth key
      description: Revokes an OAuth key (like MCP clients). The connected client immediately loses access.
      security:
      - ApiKeyAuth: []
      operationId: revokeOAuthKey
      parameters:
      - schema:
          type: string
          minLength: 1
          description: OAuth key identifier.
        required: true
        description: OAuth key identifier.
        name: oauthKeyId
        in: path
      responses:
        '204':
          description: OAuth key revoked
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    OAuthKey:
      type: object
      properties:
        id:
          type: string
          description: Stable OAuth key identifier.
        clientId:
          type: string
          description: Identifier of the OAuth client the key was issued to.
        clientName:
          type: string
          nullable: true
          description: Display name of the OAuth client.
        clientIcon:
          type: string
          nullable: true
          description: Icon URL of the OAuth client.
        userId:
          type: string
          description: Identifier of the user the key belongs to.
        userName:
          type: string
          nullable: true
          description: Display name of the user. `null` until the user completes onboarding.
        userEmail:
          type: string
          description: Email of the user.
        lastActivityAt:
          type: string
          nullable: true
          description: ISO-8601 timestamp of the last refresh on the key. `null` if the key has never been used.
        connectedAt:
          type: string
          description: ISO-8601 timestamp at which the key was connected.
        disabled:
          type: boolean
          description: Whether the key has been disabled.
      required:
      - id
      - clientId
      - clientName
      - clientIcon
      - userId
      - userName
      - userEmail
      - lastActivityAt
      - connectedAt
      - disabled
    OAuthKeyList:
      type: object
      properties:
        oauthKeys:
          type: array
          items:
            $ref: '#/components/schemas/OAuthKey'
      required:
      - oauthKeys
    Error:
      type: object
      properties:
        error:
          type: string
      required:
      - error
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
      description: 'Organization-scoped API key, sent as `Authorization: Bearer <key>`.'
      x-fern-bearer:
        name: apiKey
        env: LATITUDE_API_KEY