{"openapi":"3.1.0","info":{"title":"Arcus Developer Compliance Copilot API","description":"REST API for AI compliance checking and monitoring. Analyze AI systems against global regulations, get compliance status, and receive actionable recommendations.","version":"1.0.0","contact":{"name":"Arcus Support","url":"https://arcus-ai.app/support"},"license":{"name":"Proprietary"}},"servers":[{"url":"{baseUrl}","description":"Arcus API Server","variables":{"baseUrl":{"default":"https://app.arcus-ai.app","description":"The base URL of your Arcus instance"}}}],"security":[{"BearerAuth":[]}],"paths":{"/api/copilot/check":{"post":{"operationId":"checkCompliance","summary":"Analyze AI system for compliance obligations","description":"Accepts an AI system description and uses Claude to analyze it against the regulation database. Returns risk level, applicable jurisdictions, key obligations, and recommendations.","tags":["Compliance Check"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckRequest"},"examples":{"hiring_ai":{"summary":"AI-powered hiring tool","value":{"system_description":"An AI system that screens job applications, ranks candidates based on resume analysis, and provides hiring recommendations to HR teams.","use_case":"hiring","data_types":["personal_data","employment_history","education"],"deployment_regions":["eu","us_colorado","us_california"],"affected_individuals":"Job applicants in EU and US"}}}}}},"responses":{"200":{"description":"Successful analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckResponse"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Daily request limit for your plan"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Remaining requests today"},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"},"description":"When the rate limit resets"}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/copilot/systems/{systemId}/status":{"get":{"operationId":"getSystemStatus","summary":"Get compliance status for an AI system","description":"Returns current compliance status including readiness scores, obligation summaries, risk assessments, active alerts, and watchtower monitoring data.","tags":["System Status"],"parameters":[{"name":"systemId","in":"path","required":true,"description":"UUID of the AI system","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"System status retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemStatusResponse"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Daily request limit for your plan"},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Remaining requests today"},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"},"description":"When the rate limit resets"}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"System not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/copilot/openapi":{"get":{"operationId":"getOpenAPISpec","summary":"Get OpenAPI specification","description":"Returns the complete OpenAPI 3.1 specification for the Copilot API.","tags":["Documentation"],"security":[],"responses":{"200":{"description":"OpenAPI specification","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key authentication. Generate keys at Settings > API Keys. Use format: Bearer arc_xxxx"}},"schemas":{"CheckRequest":{"type":"object","required":["system_description"],"properties":{"system_description":{"type":"string","maxLength":5000,"description":"Detailed description of the AI system to analyze"},"use_case":{"type":"string","description":"Use case category (e.g., hiring, credit, healthcare, content, surveillance)"},"data_types":{"type":"array","items":{"type":"string"},"description":"Types of data processed (e.g., personal_data, biometric, financial)"},"deployment_regions":{"type":"array","items":{"type":"string"},"description":"Regions where the system is deployed (e.g., eu, us_colorado, uk)"},"affected_individuals":{"type":"string","description":"Description of individuals affected by the AI system"},"risk_category":{"type":"string","description":"Suggested risk category if known"}}},"CheckResponse":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"risk_level":{"type":"string","enum":["unacceptable","high","limited","minimal","unknown"]},"confidence":{"type":"number","minimum":0,"maximum":1},"applicable_jurisdictions":{"type":"array","items":{"type":"object","properties":{"jurisdiction_key":{"type":"string"},"jurisdiction_name":{"type":"string"},"risk_classification":{"type":"string"},"applicable":{"type":"boolean"},"reason":{"type":"string"}}}},"key_obligations":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"jurisdiction":{"type":"string"},"priority":{"type":"string","enum":["critical","high","medium","low"]},"legal_reference":{"type":"string"},"deadline_info":{"type":"string","nullable":true}}}},"recommendations":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"urgency":{"type":"string","enum":["immediate","short_term","long_term"]},"estimated_effort":{"type":"string"}}}},"summary":{"type":"string"}}},"meta":{"type":"object","properties":{"model_used":{"type":"string"},"analysis_time_ms":{"type":"integer"},"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"}}}}},"SystemStatusResponse":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"system":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"purpose":{"type":"string","nullable":true},"deployment_status":{"type":"string","nullable":true},"jurisdiction_flags":{"type":"array","items":{"type":"string"}},"status":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"compliance":{"type":"object","properties":{"overall_score":{"type":"number","nullable":true},"jurisdiction_scores":{"type":"array","items":{"type":"object","properties":{"jurisdiction_key":{"type":"string"},"score":{"type":"number"},"component_scores":{"type":"object","nullable":true},"computed_at":{"type":"string","format":"date-time"}}}},"obligation_summary":{"type":"object","properties":{"total":{"type":"integer"},"met":{"type":"integer"},"unmet":{"type":"integer"},"in_progress":{"type":"integer"}}}}},"risk_assessment":{"type":"object","properties":{"latest_classification":{"type":"string","nullable":true},"confidence_score":{"type":"number","nullable":true},"assessed_at":{"type":"string","format":"date-time","nullable":true}}},"alerts":{"type":"object","properties":{"total_open":{"type":"integer"},"by_severity":{"type":"object","additionalProperties":{"type":"integer"}}}},"watchtower":{"type":"object","properties":{"active_alerts":{"type":"integer"},"threshold_violations":{"type":"integer"}}}}},"meta":{"type":"object","properties":{"response_time_ms":{"type":"integer"}}}}},"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}}}}},"tags":[{"name":"Compliance Check","description":"Analyze AI systems for regulatory compliance"},{"name":"System Status","description":"Get current compliance status for registered systems"},{"name":"Documentation","description":"API documentation and specification"}]}