{"success":true,"loginRequired":false,"value":{"version":"1.0","title":"zFairs AI Agent API","description":"API surface for AI agents that set up, run, and manage contest/fair events in zFairs Fair Management Service.","scope":"Event setup, configuration, and operational management only. Participant personal data is out of scope and must not be accessed via agent keys.","authentication":"Send the client-scoped agent API key as HTTP header X-Agent-Api-Key: {guid}, or as query string agentApiKey={guid}. Keys are created by event admins under Setup → Agent API Key Manager.","restrictions":["Do not read, write, or export participant, student, judge personal, medical, or registration PII.","Agent keys are limited to a single client (tenant).","All authenticated agent calls are written to the Agent API Call Log for admin review.","Revoked or inactive keys are rejected."],"endpoints":[{"method":"GET","path":"/api/AgentApi/Help","name":"Help","description":"Public documentation of agent API structure and usage. No key required.","requiresAgentApiKey":false,"public":true,"exampleRequest":null,"exampleResponse":{"success":true,"value":{"version":"1.0","title":"zFairs AI Agent API"}}},{"method":"GET|POST","path":"/api/AgentApi/Ping","name":"Ping","description":"Validates an agent API key and records an audit log entry.","requiresAgentApiKey":true,"public":false,"exampleRequest":null,"exampleResponse":{"success":true,"value":{"message":"pong","clientId":123}}},{"method":"GET","path":"/api/AgentApi/Status","name":"Status","description":"Returns non-participant client/event status for the authenticated agent.","requiresAgentApiKey":true,"public":false,"exampleRequest":null,"exampleResponse":null}],"resources":[{"name":"AgentApiKey","description":"Client-scoped credential for agents. Managed in the app under Setup → Agent API Key Manager (/app/setup/agent-api-key).","allowedOperations":["create","update","deactivate","list (admin UI)"],"forbidden":["participant data access"]},{"name":"AgentApiCallLog","description":"Immutable activity/modification audit trail of agent key usage. Review at /app/setup/agent-api-call-log.","allowedOperations":["list","view detail (admin UI)"],"forbidden":["delete","edit"]},{"name":"Event (future)","description":"Future agent handles will cover event setup/run/manage only. Participant entities remain blocked.","allowedOperations":["planned: event configuration, sessions, non-PII operational controls"],"forbidden":["participants","medical","payment PII","personal contact lists"]}],"headers":{"x-Agent-Api-Key":"Required for authenticated endpoints. Value is the Agent API key GUID.","content-Type":"application/json for POST bodies."},"responseContract":"Every response is ResponseModel<T>: { success: bool, loginRequired: bool, value: T, message: string, goTo: string, truth: string }.","auditTrail":"Authenticated calls are logged (method, endpoint, action, success, summary, IP, user-agent, duration). Admins review logs at Setup → Agent API Call Log (/app/setup/agent-api-call-log)."},"message":null,"goTo":null,"truth":null}