{"openapi":"3.1.0","info":{"title":"Aevum Security — agent actions","description":"Auditor-developed cybersecurity solutions for MAS-regulated financial institutions and GovTech-regulated technology vendors in Singapore.","version":"20260711T073640Z-316809ca"},"servers":[{"url":"https://agents.aevumsecurity.com.sg"}],"paths":{"/actions/list_services":{"post":{"operationId":"list_services","summary":"List services","description":"List Aevum Security's cybersecurity services (slug, name, one-line summary). Use the slug with get_service_details or submit_enquiry.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false},"examples":{"all_services":{"summary":"all services","value":{}}}}}},"responses":{"200":{"description":"Action executed","content":{"application/json":{"schema":{"type":"object","required":["ok","action","result"],"properties":{"ok":{"const":true},"action":{"const":"list_services"},"result":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"services":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"summary":{"type":"string"}},"required":["slug","name","summary"],"additionalProperties":false}}},"required":["services"],"additionalProperties":false}}}}}},"400":{"description":"Input failed schema validation"},"429":{"description":"Rate limited — the agent key exceeded its quota. Retry after the Retry-After header.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}}}}}},"/actions/get_service_details":{"post":{"operationId":"get_service_details","summary":"Get service details","description":"Full details of one Aevum Security service, by slug from list_services.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"service":{"type":"string","enum":["cyberpatch","cybermonitor","cyberbaseline","cyberforensic"]}},"required":["service"],"additionalProperties":false},"examples":{"cyberpatch_details":{"summary":"cyberpatch details","value":{"service":"cyberpatch"}}}}}},"responses":{"200":{"description":"Action executed","content":{"application/json":{"schema":{"type":"object","required":["ok","action","result"],"properties":{"ok":{"const":true},"action":{"const":"get_service_details"},"result":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"summary":{"type":"string"},"audience":{"type":"string"},"engagement":{"type":"string"},"moreInfo":{"type":"string","format":"uri"}},"required":["slug","name","summary","audience","engagement","moreInfo"],"additionalProperties":false}}}}}},"400":{"description":"Input failed schema validation"},"429":{"description":"Rate limited — the agent key exceeded its quota. Retry after the Retry-After header.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}}}}}},"/actions/submit_enquiry":{"post":{"operationId":"submit_enquiry","summary":"Submit an enquiry","description":"Send a business enquiry to Aevum Security on behalf of your principal. Creates a real enquiry (a human will respond within 1 business day) — only call with the principal's consent. Returns the enquiry id as proof of receipt.","security":[{"agentKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100,"description":"Contact person's name"},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$","description":"Reply-to email address"},"service":{"anyOf":[{"type":"string","enum":["cyberpatch","cybermonitor","cyberbaseline","cyberforensic"]},{"type":"string","const":"general"}],"description":"Service slug from list_services, or 'general'"},"message":{"type":"string","minLength":10,"maxLength":2000,"description":"The enquiry itself"}},"required":["name","email","service","message"],"additionalProperties":false},"examples":{"patch_management_enquiry":{"summary":"patch management enquiry","value":{"name":"Jane Tan","email":"jane.tan@example.com","service":"cyberpatch","message":"We are a MAS-regulated FI exploring managed patch evidence for our next inspection."}}}}}},"responses":{"200":{"description":"Action executed","content":{"application/json":{"schema":{"type":"object","required":["ok","action","result"],"properties":{"ok":{"const":true},"action":{"const":"submit_enquiry"},"result":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"enquiryId":{"type":"number"},"receivedAt":{"type":"string"},"status":{"type":"string","const":"received"},"expectation":{"type":"string"}},"required":["enquiryId","receivedAt","status","expectation"],"additionalProperties":false}}}}}},"400":{"description":"Input failed schema validation"},"401":{"description":"Missing/invalid agent key"},"429":{"description":"Rate limited — the agent key exceeded its quota. Retry after the Retry-After header.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}}}}}}},"components":{"securitySchemes":{"agentKey":{"type":"http","scheme":"bearer","description":"Mutating actions require a bearer key issued by the gateway. Request one via contact@aevumsecurity.com.sg. Agents may additionally present RFC 9421 / Web-Bot-Auth signatures; they are verified and recorded (advisory — never required)."}}}}