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
POSTpublicVaultServiceAuth Required

Delete Item

/aegis.v1.VaultService/DeleteItem

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)

{
  "vaultId": "string",
  "itemId": "string",
  "baseVersion": null
}

Responses

200

Success

{
  "item": {
    "itemId": "string",
    "tenantId": "string",
    "vaultId": "string",
    "version": null,
    "kind": "string",
    "titleHash": "string",
    "updatedAt": "2026-01-01T00:00:00Z",
    "encryptedPayload": {
      "alg": "string",
      "nonce": "string",
      "aad": "string",
      "ciphertext": "string",
      "version": 0
    },
    "wrappedKeys": [
      {
        "recipientId": "string",
        "wrapAlg": "string",
        "wrappedKey": "string"
      }
    ],
    "deleted": true
  },
  "cursor": {
    "vaultId": "string",
    "sequence": null
  }
}
default

Error

{
  "code": "string",
  "message": "string",
  "details": [
    {
      "type": "string",
      "value": "string",
      "debug": {}
    }
  ]
}
curl -X POST "https://aegis-consumer-api-lgbfsi3yxa-uc.a.run.app/aegis.v1.VaultService/DeleteItem" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_ID_TOKEN>" \
  -H "Connect-Protocol-Version: 1" \
  -d '{
  "vaultId": "string",
  "itemId": "string",
  "baseVersion": null
}'