AegisAegis
Dashboard
AegisAegis Developer Portal

Developer Search

Press ⌘K or Ctrl+K to jump through guides and public API docs for user-owned master key and scoped credential flows.

API Reference

Aegis Platform API

Connect RPC surface for the Aegis zero-knowledge platform. Operations are tagged as `public` (integrator-facing) or `private` (internal/elevated).

This explorer lists public operations and documents the model where users control master keys while platform services enforce policy and scoped access.

Developer Home
POSTpublicRecoveryServiceAuth Required

Request Emergency Access

/aegis.v1.RecoveryService/RequestEmergencyAccess

Authentication

This endpoint requires a bearer access token. Use short-lived tokens and send them only in the Authorization header.

  • Keep tokens short-lived and rotate them frequently.
  • Never include tokens in query parameters or logs.
  • Use least-privilege scope grants for the caller.
  • Preserve user data ownership boundaries: authenticate and authorize access without transmitting plaintext master key material.

Security Schemes

  • BearerAuthscopes: token must still be policy-allowlisted.

Parameters

NameInRequiredDescription
Connect-Protocol-Versionheaderyes-
Connect-Timeout-Msheaderno-

Request Body (Example)

{
  "granteeEmail": "string",
  "reason": "string"
}

Responses

200

Success

{
  "request": {
    "requestId": "string",
    "kind": "string",
    "status": "string",
    "target": "string",
    "reason": "string",
    "delaySeconds": null,
    "requestedAt": "2026-01-01T00:00:00Z",
    "resolvedAt": "2026-01-01T00:00:00Z"
  }
}
default

Error

{
  "code": "string",
  "message": "string",
  "details": [
    {
      "type": "string",
      "value": "string",
      "debug": {}
    }
  ]
}
curl -X POST "https://aegis-business-api-essxwc4hja-uc.a.run.app/aegis.v1.RecoveryService/RequestEmergencyAccess" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_ID_TOKEN>" \
  -H "Connect-Protocol-Version: 1" \
  -d '{
  "granteeEmail": "string",
  "reason": "string"
}'