> ## Documentation Index > Fetch the complete documentation index at: https://docs.cotool.ai/llms.txt > Use this file to discover all available pages before exploring further. # List critical issues > Retrieve normalized critical issues flagged by LLM judge evaluations. ## OpenAPI ````yaml https://app.cotool.ai/api/docs/openapi.json get /api/critical-issues openapi: 3.1.0 info: title: Cotool API version: 1.0.0 description: >- # Cotool API Documentation The Cotool API allows you to interact with the Cotool platform programmatically, enabling you to build powerful integrations and automate your workflows. ## Getting an API Key Follow these steps to generate your API key: 1. **Log in** to the Cotool web interface 2. **Navigate** to `/settings/api-keys` 3. **Click** "Generate Key" 4. **Copy and store** your API key securely ⚠️ *It won't be shown again* ## API Key Authentication For programmatic access and integrations, use your API key with the Authorization header: ```http Authorization: Bearer your_api_key_here ``` ```bash curl -X GET "https://app.cotool.ai/api/endpoint" \ -H "Authorization: Bearer your_api_key_here" \ -H "Content-Type: application/json" ``` servers: - url: https://app.cotool.ai description: Production server security: - ApiKeyAuth: [] paths: /api/critical-issues: get: tags: - Agents summary: List critical issues description: Retrieve normalized critical issues flagged by LLM judge evaluations. parameters: - in: query name: limit description: Number of critical issues to return schema: type: number minimum: 1 maximum: 100 default: 50 description: Number of critical issues to return - in: query name: offset description: Number of critical issues to skip schema: type: number minimum: 0 default: 0 description: Number of critical issues to skip - in: query name: status description: Critical issue status filter schema: type: string enum: - open - dismissed - resolved default: open description: Critical issue status filter - in: query name: issueId description: Specific critical issue ID to return schema: type: string format: uuid description: Specific critical issue ID to return responses: '200': description: Successful response content: application/json: schema: type: object properties: alerts: type: array items: type: object properties: id: type: string format: uuid organizationId: type: string format: uuid agentId: type: string format: uuid agentName: type: string agentType: type: string enum: - response - detection description: >- Type of agent: response (standard agent) or detection (security detection agent) runId: type: string format: uuid runTitle: type: string runCreatedAt: type: string agentRunEvalId: type: - string - 'null' format: uuid evaluatorType: type: string evaluatorVersion: type: string category: type: string enum: - authentication - connectivity - missing_data - permission - configuration - service_unavailable description: >- Critical Issue Categories that prevented task completion (external blockers, not agent faults): authentication: OAuth tokens, API keys, credentials failures connectivity: Service/network connectivity issues missing_data: Required data/logs not available permission: User lacks required permissions configuration: Misconfiguration (wrong settings, missing config) service_unavailable: External service down or unresponsive explanation: type: string status: type: string enum: - open - dismissed - resolved dismissedAt: type: - string - 'null' dismissedByUserId: type: - string - 'null' format: uuid createdAt: type: string updatedAt: type: string required: - id - organizationId - agentId - agentName - agentType - runId - runTitle - runCreatedAt - agentRunEvalId - evaluatorType - evaluatorVersion - category - explanation - status - dismissedAt - dismissedByUserId - createdAt - updatedAt totalCount: type: integer required: - alerts - totalCount description: Paginated list of normalized critical issues '400': description: Bad request — input validation failed or the request was malformed content: application/json: schema: $ref: '#/components/schemas/ValidationError' '401': description: Unauthorized — missing or invalid API key / session content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Forbidden — the authenticated user lacks the required permissions content: application/json: schema: $ref: '#/components/schemas/PermissionError' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' x-codeSamples: - lang: shell label: cURL source: |- curl -X GET "https://app.cotool.ai/api/critical-issues" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" components: schemas: ValidationError: type: object properties: error: type: string description: Error message describing what went wrong issues: type: array description: >- Detailed validation issues, present when request or response schema validation fails items: type: object additionalProperties: true required: - error Error: type: object properties: error: type: string description: Error message describing what went wrong required: - error PermissionError: type: object properties: error: type: string description: Error message describing what went wrong missingPerms: type: array description: Permissions the authenticated user is missing for this operation items: type: string required: - error securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: API Key description: >- API Key authentication for programmatic access. Include your API key in the Authorization header as: `Bearer your_api_key_here` ````