FireTail API

openapi: 3.1.0
info:
  title: FireTail API
  version: '2026-10-21'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-21: 4 operation(s) read from 5 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; FireTail has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 3
    documentation: 1
    pages-with-code: 4
    pages-read: 5
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-21'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.firetail.ai/api/pagination
  - https://docs.firetail.ai/api/authentication
  - https://docs.firetail.ai/docs/endpoint-agent/macos/manual
  - https://docs.firetail.ai/docs/endpoint-agent/macos/managed
  - https://docs.firetail.ai/docs/endpoint-agent/windows/manual
paths:
  /:
    get:
      operationId: get
      tags:
      - Api
      summary: GET /
      x-source: https://docs.firetail.ai/docs/endpoint-agent/windows/manual
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -sS -o /dev/null -w '%{http_code}\\n' https://api.anthropic.com/ \n A 4xx response means TLS negotiated successfully. A\
          \ curl: (60) SSL certificate problem means certificate validation failed. A successful connection alone does not prove interception:\
          \ also confirm the agent is active and that activity from a supported AI provider appears in Employee Logs . \n Claude Code and other\
          \ Node.js tools \n"
  /oauth/token:
    post:
      operationId: post_oauth_token
      tags:
      - Oauth
      summary: POST /oauth/token
      x-source: https://docs.firetail.ai/api/authentication
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostOauthTokenResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST  https://api.saas.eu-west-1.prod.firetail.app/oauth/token  -d grant_type=client_credentials -d client_id={CLIENT_ID}\
          \ -d client_secret={CLIENT_SECRET} \n Python example \n import requests\nurl = 'https://api.saas.eu-west-1.prod.firetail.app/oauth/token'\n\
          payload = {\n 'grant_type': 'client_credentials',\n 'client_id': 'YOUR_CLIENT_ID',\n 'client_secret': 'YOUR_CLIENT_SECRET'\n}\nheaders\
          \ = {\n 'C"
  /organisations/{orgUuid}/search:
    post:
      operationId: post_organisations_orgUuid_search
      tags:
      - Organisations
      summary: All top-level API resources support bulk fetches through the organization search endpoint
      description: Retrieves large datasets efficiently by breaking them into manageable chunks using pagination parameters size and marker.
      x-source: https://docs.firetail.ai/api/pagination
      parameters:
      - name: orgUuid
        in: path
        required: true
        schema:
          type: string
      - name: size
        in: query
        required: false
        schema:
          type: string
        description: 'Number of records to return in the response (Maximum: 100).'
      - name: marker
        in: query
        required: false
        schema:
          type: string
        description: Starting point for pagination (offset).
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /releases/endpoint-agent/macos/manifest.json:
    get:
      operationId: get_releases_endpoint_agent_macos_manifest_json
      tags:
      - Releases
      summary: GET /releases/endpoint-agent/macos/manifest.json
      x-source: https://docs.firetail.ai/docs/endpoint-agent/macos/manual
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -fsSL "https://assets.cdn.services.firetail.app/releases/endpoint-agent/macos/manifest.json"  -o firetail-macos-manifest.json
          && '
components:
  schemas:
    PostOauthTokenResponse:
      type: object
      properties:
        access_token:
          type: string
        expires_in:
          type: integer
  securitySchemes:
    OAuth_2.0_client_credentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://api.saas.eu-west-1.prod.firetail.app/oauth/token
          scopes: {}
      x-source: https://docs.firetail.ai/api/authentication
tags:
- name: Api
- name: Oauth
- name: Organisations
- name: Releases
security:
- OAuth_2.0_client_credentials: []