{
  "openapi": "3.1.0",
  "info": {
    "title": "Axion Bodycam API",
    "version": "1.0.0",
    "description": "Community-scoped integration credentials. Call this API from your authenticated backend with Authorization: Bearer <full API key>; use ax_live_ keys with production and ax_test_ keys with the sandbox API. External routes omit Access-Control-Allow-Origin in every environment, including development. Registered embed origins authorize private viewers only and do not enable browser API CORS or grant scopes. Check authentication with GET /installation, then diagnose failures by HTTP status and error.code. Embed private viewers using single-use bootstraps."
  },
  "servers": [
    {
      "url": "https://getaxion.xyz/api/external/v1"
    }
  ],
  "paths": {
    "/installation": {
      "get": {
        "summary": "Installation and feature limits",
        "operationId": "get__installation",
        "x-axion-scopes": [],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstallationResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "description": "Backend connection check requiring a valid credential and an available, approved installation. No resource scope or registered embed origin is required. A successful response verifies authentication for this request only."
      }
    },
    "/members": {
      "get": {
        "summary": "Members and current bodycam status",
        "operationId": "get__members",
        "x-axion-scopes": [
          "bodycams:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "roblox_user_id",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemberPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/members/{member_id}/bodycam": {
      "get": {
        "summary": "One member's bodycam",
        "operationId": "get__members_member_id_bodycam",
        "x-axion-scopes": [
          "bodycams:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "member_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Bodycam"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/unit-mappings": {
      "get": {
        "summary": "Unit assignments",
        "operationId": "get__unit_mappings",
        "x-axion-scopes": [
          "units:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "member_id",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "callsign",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "department",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UnitPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/unit-mappings/{external_unit_id}": {
      "get": {
        "summary": "Unit assignment by CAD identity",
        "operationId": "get__unit_mappings_external_unit_id_",
        "x-axion-scopes": [
          "units:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "external_unit_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UnitResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "put": {
        "summary": "Assign or revise a unit",
        "operationId": "put__unit_mappings_external_unit_id_",
        "x-axion-scopes": [
          "units:write"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "external_unit_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UnitResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "member_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "roblox_user_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "callsign": {
                    "type": "string",
                    "maxLength": 80
                  },
                  "badge_number": {
                    "type": "string",
                    "maxLength": 80
                  },
                  "department": {
                    "type": "object",
                    "properties": {
                      "external_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 128
                      },
                      "name": {
                        "type": "string",
                        "maxLength": 80
                      }
                    }
                  },
                  "expected_revision": {
                    "type": "integer",
                    "minimum": 1
                  }
                },
                "required": []
              },
              "example": {
                "member_id": "MEMBER_ID",
                "callsign": "A-12",
                "badge_number": "104",
                "department": {
                  "external_id": "pd",
                  "name": "Police"
                }
              }
            }
          }
        }
      },
      "delete": {
        "summary": "End a unit assignment",
        "operationId": "delete__unit_mappings_external_unit_id_",
        "x-axion-scopes": [
          "units:write"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "external_unit_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UnitResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "required": []
              },
              "example": {}
            }
          }
        }
      }
    },
    "/clips": {
      "get": {
        "summary": "Ready footage in this community",
        "operationId": "get__clips",
        "x-axion-scopes": [
          "clips:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "member_id",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "event_type",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClipPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/clips/{clip_id}": {
      "get": {
        "summary": "Footage metadata",
        "operationId": "get__clips_clip_id_",
        "x-axion-scopes": [
          "clips:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "clip_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClipResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/capture-requests": {
      "post": {
        "summary": "Request a recent buffer capture",
        "operationId": "post__capture_requests",
        "x-axion-scopes": [
          "bodycams:capture"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaptureResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "member_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "external_unit_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "pre_ms": {
                    "type": "integer",
                    "minimum": 1000,
                    "maximum": 1800000,
                    "default": 60000
                  },
                  "external_case_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "external_actor_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  }
                },
                "required": []
              },
              "example": {
                "member_id": "MEMBER_ID",
                "pre_ms": 5000,
                "external_case_id": "sample-1"
              }
            }
          }
        }
      }
    },
    "/capture-requests/{request_id}": {
      "get": {
        "summary": "Capture result and progress",
        "operationId": "get__capture_requests_request_id_",
        "x-axion-scopes": [
          "bodycams:capture"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "request_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaptureResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/viewer-sessions": {
      "post": {
        "summary": "Create a private clip, low/high quality live view or timeline viewer",
        "operationId": "post__viewer_sessions",
        "x-axion-scopes": [],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ViewerResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "resource_type": {
                    "type": "string",
                    "enum": [
                      "clip",
                      "preview",
                      "timeline"
                    ]
                  },
                  "quality": {
                    "type": "string",
                    "enum": [
                      "low",
                      "high"
                    ],
                    "default": "low",
                    "description": "Preview viewers only. Low: up to 640x360, JPEG quality 65%. High: up to 1280x720, JPEG quality 85%; requires the community's Power plan and desktop capability live_view_quality_v1. Both refresh about once per second. Power is checked again on every high quality viewer access."
                  },
                  "clip_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "member_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "external_unit_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "external_case_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "origin": {
                    "type": "string",
                    "format": "uri",
                    "maxLength": 512,
                    "description": "Exact registered parent website origin (scheme, hostname and optional port), with no path or trailing slash. For example, https://relaycad.net and https://www.relaycad.net are distinct origins. This authorizes the private viewer embed, not browser API CORS."
                  }
                },
                "required": [
                  "resource_type",
                  "origin"
                ]
              },
              "example": {
                "resource_type": "preview",
                "quality": "low",
                "member_id": "MEMBER_ID",
                "origin": "https://cad.example"
              }
            }
          }
        },
        "x-axion-resource-scopes": {
          "clip": [
            "clips:read"
          ],
          "preview": [
            "bodycams:preview"
          ],
          "timeline": [
            "timeline:read"
          ]
        }
      }
    },
    "/evidence-links": {
      "post": {
        "summary": "Link footage to a CAD case",
        "operationId": "post__evidence_links",
        "x-axion-scopes": [
          "evidence:write",
          "clips:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvidenceResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clip_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "external_case_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  }
                },
                "required": [
                  "clip_id",
                  "external_case_id"
                ]
              },
              "example": {
                "clip_id": "CLIP_ID",
                "external_case_id": "sample-1"
              }
            }
          }
        }
      },
      "get": {
        "summary": "Case evidence references",
        "operationId": "get__evidence_links",
        "x-axion-scopes": [
          "clips:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "external_case_id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvidencePage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/evidence-links/{link_id}": {
      "delete": {
        "summary": "Unlink case evidence",
        "operationId": "delete__evidence_links_link_id_",
        "x-axion-scopes": [
          "evidence:write"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "link_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Removed"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "required": []
              },
              "example": {}
            }
          }
        }
      }
    },
    "/cases/{external_case_id}/timeline": {
      "get": {
        "summary": "Revisioned incident chronology and camera intervals",
        "operationId": "get__cases_external_case_id_timeline",
        "x-axion-scopes": [
          "timeline:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "external_case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          },
          {
            "name": "revision",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Timeline"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/cases/{external_case_id}/events": {
      "post": {
        "summary": "Append a CAD event",
        "operationId": "post__cases_external_case_id_events",
        "x-axion-scopes": [
          "timeline:write"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "external_case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaseEventResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "external_event_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "type": {
                    "type": "string",
                    "maxLength": 64
                  },
                  "occurred_at": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "note": {
                    "type": "string",
                    "maxLength": 2000
                  },
                  "member_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "external_unit_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  }
                },
                "required": [
                  "external_event_id",
                  "type",
                  "occurred_at"
                ]
              },
              "example": {
                "external_event_id": "dispatch-1",
                "type": "dispatch",
                "occurred_at": 0,
                "note": "Units dispatched"
              }
            }
          }
        }
      }
    },
    "/cases/{external_case_id}/events/{event_id}": {
      "patch": {
        "summary": "Correct a CAD event",
        "operationId": "patch__cases_external_case_id_events_event_id_",
        "x-axion-scopes": [
          "timeline:write"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "external_case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          },
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaseEventResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "expected_revision": {
                    "type": "integer",
                    "minimum": 1
                  },
                  "note": {
                    "type": "string",
                    "maxLength": 2000
                  },
                  "occurred_at": {
                    "type": "integer",
                    "minimum": 0
                  }
                },
                "required": [
                  "expected_revision"
                ]
              },
              "example": {
                "expected_revision": 1,
                "note": "Corrected dispatch note"
              }
            }
          }
        }
      },
      "delete": {
        "summary": "Tombstone a CAD event",
        "operationId": "delete__cases_external_case_id_events_event_id_",
        "x-axion-scopes": [
          "timeline:write"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "external_case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          },
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaseEventResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "expected_revision": {
                    "type": "integer",
                    "minimum": 1
                  }
                },
                "required": [
                  "expected_revision"
                ]
              },
              "example": {
                "expected_revision": 1
              }
            }
          }
        }
      }
    },
    "/events": {
      "get": {
        "summary": "Durable event feed with a seven-day replay window",
        "operationId": "get__events",
        "x-axion-scopes": [
          "events:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "after",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/webhook-endpoints": {
      "get": {
        "summary": "Webhook subscriptions",
        "operationId": "get__webhook_endpoints",
        "x-axion-scopes": [
          "events:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "post": {
        "summary": "Register a callback and obtain its signing secret",
        "operationId": "post__webhook_endpoints",
        "x-axion-scopes": [
          "events:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "format": "uri",
                    "maxLength": 2048
                  },
                  "events": {
                    "type": "array",
                    "maxItems": 9,
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "required": [
                  "url",
                  "events"
                ]
              },
              "example": {
                "url": "https://cad.example/hooks/axion",
                "events": [
                  "capture_request.updated",
                  "clip.ready"
                ]
              }
            }
          }
        }
      }
    },
    "/webhook-endpoints/{endpoint_id}/verify": {
      "post": {
        "summary": "Verify callback ownership",
        "operationId": "post__webhook_endpoints_endpoint_id_verify",
        "x-axion-scopes": [
          "events:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "endpoint_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Verified"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "required": []
              },
              "example": {}
            }
          }
        }
      }
    },
    "/webhook-endpoints/{endpoint_id}": {
      "delete": {
        "summary": "Revoke a callback",
        "operationId": "delete__webhook_endpoints_endpoint_id_",
        "x-axion-scopes": [
          "events:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "endpoint_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Revoked endpoint"
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "required": []
              },
              "example": {}
            }
          }
        }
      }
    },
    "/webhook-deliveries": {
      "get": {
        "summary": "Delivery attempts and failures",
        "operationId": "get__webhook_deliveries",
        "x-axion-scopes": [
          "events:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeliveryPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/webhook-deliveries/{delivery_id}/replay": {
      "post": {
        "summary": "Replay an authorized event",
        "operationId": "post__webhook_deliveries_delivery_id_replay",
        "x-axion-scopes": [
          "events:read"
        ],
        "security": [
          {
            "integrationKey": []
          }
        ],
        "parameters": [
          {
            "name": "delivery_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Accepted"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, malformed, expired, revoked or wrong-environment credential, or unavailable installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing scope, owner approval required, or viewer origin not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Resource unavailable or outside the installation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Conflict, changed revision or unavailable device",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "Expired session or event cursor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Request budget reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "required": []
              },
              "example": {}
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "code",
              "message"
            ]
          }
        },
        "required": [
          "error"
        ]
      },
      "Installation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "community_id": {
            "type": "string"
          },
          "integration_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "owner_user_id": {
            "type": "string"
          },
          "environment": {
            "type": "string",
            "enum": [
              "live",
              "test"
            ]
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "origins": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uri"
            }
          },
          "revoked_at": {
            "type": "integer",
            "minimum": 0
          },
          "created_at": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "id",
          "community_id",
          "integration_id",
          "name",
          "owner_user_id",
          "environment",
          "scopes",
          "origins",
          "revoked_at",
          "created_at"
        ]
      },
      "InstallationResponse": {
        "type": "object",
        "properties": {
          "installation": {
            "$ref": "#/components/schemas/Installation"
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "limits": {
            "type": "object",
            "properties": {
              "metadata_per_minute": {
                "type": "integer",
                "minimum": 0
              },
              "capture_per_minute": {
                "type": "integer",
                "minimum": 0
              },
              "max_pre_ms": {
                "type": "integer",
                "minimum": 0
              }
            },
            "required": [
              "metadata_per_minute",
              "capture_per_minute",
              "max_pre_ms"
            ]
          }
        },
        "required": [
          "installation",
          "features",
          "limits"
        ]
      },
      "UnitSnapshot": {
        "type": "object",
        "properties": {
          "external_unit_id": {
            "type": "string"
          },
          "member_id": {
            "type": "string"
          },
          "callsign": {
            "type": "string"
          },
          "badge_number": {
            "type": "string"
          },
          "department": {
            "type": "object",
            "properties": {
              "external_id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            },
            "required": [
              "external_id",
              "name"
            ]
          },
          "revision": {
            "type": "integer",
            "minimum": 1
          }
        },
        "required": [
          "external_unit_id",
          "member_id",
          "callsign",
          "badge_number",
          "department",
          "revision"
        ]
      },
      "Unit": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "community_id": {
            "type": "string"
          },
          "integration_id": {
            "type": "string"
          },
          "external_unit_id": {
            "type": "string"
          },
          "member_id": {
            "type": "string"
          },
          "callsign": {
            "type": "string"
          },
          "badge_number": {
            "type": "string"
          },
          "department": {
            "type": "object",
            "properties": {
              "external_id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            },
            "required": [
              "external_id",
              "name"
            ]
          },
          "revision": {
            "type": "integer",
            "minimum": 1
          },
          "active": {
            "type": "boolean"
          },
          "effective_from": {
            "type": "integer",
            "minimum": 0
          },
          "effective_to": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "id",
          "community_id",
          "integration_id",
          "external_unit_id",
          "member_id",
          "callsign",
          "badge_number",
          "department",
          "revision",
          "active",
          "effective_from",
          "effective_to"
        ]
      },
      "UnitResponse": {
        "type": "object",
        "properties": {
          "unit": {
            "$ref": "#/components/schemas/Unit"
          }
        },
        "required": [
          "unit"
        ]
      },
      "UnitPage": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Unit"
            }
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "items",
          "next_cursor"
        ]
      },
      "Bodycam": {
        "type": "object",
        "properties": {
          "member_id": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "offline",
              "unknown",
              "idle",
              "recording"
            ]
          },
          "observed_at": {
            "type": "integer",
            "minimum": 0
          },
          "stale_after_ms": {
            "type": "integer",
            "minimum": 0
          },
          "in_community": {
            "type": "boolean"
          },
          "buffer_ms": {
            "type": "integer",
            "minimum": 0
          },
          "preview_available": {
            "type": "boolean"
          },
          "capture_available": {
            "type": "boolean"
          },
          "unavailable_reason": {
            "type": "string"
          }
        },
        "required": [
          "member_id",
          "status",
          "observed_at",
          "stale_after_ms",
          "in_community",
          "buffer_ms",
          "preview_available",
          "capture_available",
          "unavailable_reason"
        ]
      },
      "Member": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "roblox_user_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "bodycam": {
            "$ref": "#/components/schemas/Bodycam"
          }
        },
        "required": [
          "id",
          "roblox_user_id",
          "name",
          "bodycam"
        ]
      },
      "MemberPage": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Member"
            }
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "items",
          "next_cursor"
        ]
      },
      "Clip": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "member_id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "event_type": {
            "type": "string"
          },
          "occurred_at": {
            "type": "integer",
            "minimum": 0
          },
          "duration_ms": {
            "type": "integer",
            "minimum": 0
          },
          "uploaded_at": {
            "type": "integer",
            "minimum": 0
          },
          "expires_at": {
            "type": "integer",
            "minimum": 0
          },
          "playback_available": {
            "type": "boolean"
          },
          "original_footage": {
            "type": "boolean"
          },
          "started_at_server_ms": {
            "type": "integer",
            "minimum": 0
          },
          "sync_rtt_ms": {
            "type": "integer",
            "minimum": 0
          },
          "timing_quality": {
            "type": "string",
            "enum": [
              "approximate",
              "unknown"
            ]
          }
        },
        "required": [
          "id",
          "member_id",
          "title",
          "event_type",
          "occurred_at",
          "duration_ms",
          "uploaded_at",
          "expires_at",
          "playback_available",
          "original_footage",
          "started_at_server_ms",
          "sync_rtt_ms",
          "timing_quality"
        ]
      },
      "ClipResponse": {
        "type": "object",
        "properties": {
          "clip": {
            "$ref": "#/components/schemas/Clip"
          }
        },
        "required": [
          "clip"
        ]
      },
      "ClipPage": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Clip"
            }
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "items",
          "next_cursor"
        ]
      },
      "Capture": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "community_id": {
            "type": "string"
          },
          "integration_id": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "accepted",
              "delivered",
              "acknowledged",
              "upload_queued",
              "ready",
              "failed",
              "expired"
            ]
          },
          "requested_pre_ms": {
            "type": "integer",
            "minimum": 0
          },
          "effective_pre_ms": {
            "type": "integer",
            "minimum": 0
          },
          "expires_at": {
            "type": "integer",
            "minimum": 0
          },
          "clip_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "member_id": {
            "type": "string"
          },
          "external_case_id": {
            "type": "string"
          },
          "external_actor_id": {
            "type": "string"
          },
          "unit": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/UnitSnapshot"
              },
              {
                "type": "null"
              }
            ]
          },
          "revision": {
            "type": "integer",
            "minimum": 1
          },
          "created_at": {
            "type": "integer",
            "minimum": 0
          },
          "failure_code": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "status",
          "requested_pre_ms",
          "effective_pre_ms",
          "expires_at",
          "clip_id"
        ]
      },
      "CaptureResponse": {
        "type": "object",
        "properties": {
          "request": {
            "$ref": "#/components/schemas/Capture"
          }
        },
        "required": [
          "request"
        ]
      },
      "ViewerResponse": {
        "type": "object",
        "properties": {
          "session": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "resource_type": {
                "type": "string",
                "enum": [
                  "clip",
                  "preview",
                  "timeline"
                ]
              },
              "quality": {
                "type": "string",
                "enum": [
                  "low",
                  "high"
                ],
                "description": "Present for preview sessions. Existing sessions without this field use low quality."
              },
              "expires_at": {
                "type": "integer",
                "minimum": 0
              },
              "bootstrap_expires_at": {
                "type": "integer",
                "minimum": 0
              }
            },
            "required": [
              "id",
              "resource_type",
              "expires_at",
              "bootstrap_expires_at"
            ]
          },
          "embed_url": {
            "type": "string",
            "format": "uri",
            "description": "Private capability; fragment redeems once within 60 seconds. Do not log."
          }
        },
        "required": [
          "session",
          "embed_url"
        ]
      },
      "Evidence": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "community_id": {
            "type": "string"
          },
          "integration_id": {
            "type": "string"
          },
          "clip_id": {
            "type": "string"
          },
          "external_case_id": {
            "type": "string"
          },
          "unit": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/UnitSnapshot"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "type": "integer",
            "minimum": 0
          },
          "removed_at": {
            "type": "integer",
            "minimum": 0
          },
          "available": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "external_case_id"
        ]
      },
      "EvidenceResponse": {
        "type": "object",
        "properties": {
          "link": {
            "$ref": "#/components/schemas/Evidence"
          }
        },
        "required": [
          "link"
        ]
      },
      "EvidencePage": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Evidence"
            }
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "items",
          "next_cursor"
        ]
      },
      "Removed": {
        "type": "object",
        "properties": {
          "removed": {
            "type": "boolean"
          }
        },
        "required": [
          "removed"
        ]
      },
      "CaseEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "community_id": {
            "type": "string"
          },
          "integration_id": {
            "type": "string"
          },
          "external_case_id": {
            "type": "string"
          },
          "external_event_id": {
            "type": "string"
          },
          "source": {
            "type": "string",
            "enum": [
              "cad",
              "axion"
            ]
          },
          "type": {
            "type": "string"
          },
          "occurred_at": {
            "type": "integer",
            "minimum": 0
          },
          "received_at": {
            "type": "integer",
            "minimum": 0
          },
          "revision": {
            "type": "integer",
            "minimum": 1
          },
          "note": {
            "type": "string"
          },
          "member_id": {
            "type": "string"
          },
          "unit": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/UnitSnapshot"
              },
              {
                "type": "null"
              }
            ]
          },
          "clip_id": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          },
          "deleted": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "community_id",
          "integration_id",
          "external_case_id",
          "external_event_id",
          "source",
          "type",
          "occurred_at",
          "received_at",
          "revision",
          "note",
          "member_id",
          "unit",
          "clip_id",
          "request_id",
          "deleted"
        ]
      },
      "CaseEventResponse": {
        "type": "object",
        "properties": {
          "event": {
            "$ref": "#/components/schemas/CaseEvent"
          }
        },
        "required": [
          "event"
        ]
      },
      "Footage": {
        "type": "object",
        "properties": {
          "link_id": {
            "type": "string"
          },
          "available": {
            "type": "boolean"
          },
          "clip_id": {
            "type": "string"
          },
          "unit": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/UnitSnapshot"
              },
              {
                "type": "null"
              }
            ]
          },
          "clip": {
            "$ref": "#/components/schemas/Clip"
          },
          "start_ms": {
            "type": [
              "integer",
              "null"
            ]
          },
          "end_ms": {
            "type": [
              "integer",
              "null"
            ]
          },
          "timing_quality": {
            "type": "string",
            "enum": [
              "approximate",
              "unknown"
            ]
          }
        },
        "required": [
          "link_id",
          "available"
        ]
      },
      "Timeline": {
        "type": "object",
        "properties": {
          "external_case_id": {
            "type": "string"
          },
          "revision": {
            "type": "integer",
            "minimum": 1
          },
          "updated_at": {
            "type": "integer",
            "minimum": 0
          },
          "events": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CaseEvent"
            }
          },
          "footage": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Footage"
            }
          }
        },
        "required": [
          "external_case_id",
          "revision",
          "updated_at",
          "events",
          "footage"
        ]
      },
      "Event": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "community_id": {
            "type": "string"
          },
          "integration_id": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "resource_id": {
            "type": "string"
          },
          "resource_revision": {
            "type": "integer",
            "minimum": 1
          },
          "occurred_at": {
            "type": "integer",
            "minimum": 0
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "required": [
          "id",
          "community_id",
          "integration_id",
          "type",
          "resource_id",
          "resource_revision",
          "occurred_at",
          "scopes",
          "data"
        ]
      },
      "EventPage": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Event"
            }
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "replay_window_ms": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "items",
          "next_cursor",
          "replay_window_ms"
        ]
      },
      "Webhook": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "community_id": {
            "type": "string"
          },
          "integration_id": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "events": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "created_at": {
            "type": "integer",
            "minimum": 0
          },
          "revoked_at": {
            "type": "integer",
            "minimum": 0
          },
          "verified_at": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "id",
          "community_id",
          "integration_id",
          "url",
          "events",
          "created_at",
          "revoked_at",
          "verified_at"
        ]
      },
      "WebhookPage": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Webhook"
            }
          }
        },
        "required": [
          "items"
        ]
      },
      "WebhookResponse": {
        "type": "object",
        "properties": {
          "endpoint": {
            "$ref": "#/components/schemas/Webhook"
          },
          "signing_secret": {
            "type": "string",
            "description": "Signing secret, returned on creation only. Do not log."
          }
        },
        "required": [
          "endpoint",
          "signing_secret"
        ]
      },
      "Verified": {
        "type": "object",
        "properties": {
          "verified": {
            "type": "boolean"
          }
        },
        "required": [
          "verified"
        ]
      },
      "Delivery": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "community_id": {
            "type": "string"
          },
          "integration_id": {
            "type": "string"
          },
          "event_id": {
            "type": "string"
          },
          "endpoint_id": {
            "type": "string"
          },
          "attempts": {
            "type": "integer",
            "minimum": 0
          },
          "next_attempt_at": {
            "type": "integer",
            "minimum": 0
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "delivered",
              "failed"
            ]
          },
          "last_error": {
            "type": "string"
          },
          "created_at": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "id",
          "community_id",
          "integration_id",
          "event_id",
          "endpoint_id",
          "attempts",
          "next_attempt_at",
          "status",
          "last_error",
          "created_at"
        ]
      },
      "DeliveryPage": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Delivery"
            }
          }
        },
        "required": [
          "items"
        ]
      },
      "Accepted": {
        "type": "object",
        "properties": {
          "accepted": {
            "type": "boolean"
          }
        },
        "required": [
          "accepted"
        ]
      }
    },
    "securitySchemes": {
      "integrationKey": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "ax_live_ID.SECRET or ax_test_ID.SECRET",
        "description": "Backend-only full installation credential, including the secret after the dot. Send Authorization: Bearer <key> without quotes, duplicate Bearer prefixes or embedded whitespace. Human session and device tokens are not accepted. Match the credential's live/test environment to the API deployment."
      }
    }
  }
}
