Skip to main content

Identity callables

Base URL:

https://us-central1-axy-ujex.cloudfunctions.net

All functions use Firebase callable JSON. Human-owner calls require a Firebase Auth ID token. Agent calls use the session device-key exchange, then Authorization: Bearer <firebase-id-token>.

FunctionCallerPurpose
sessionunauthenticated body with agentId + deviceKeyMint a Firebase custom token for an agent device key.
createAgenthuman ownerCreate an agent and mailbox local part.
rotateDeviceKeyhuman ownerMint a new device key and optionally revoke existing keys.
identityListDeviceKeyshuman ownerList key prefixes and metadata.
revokeDeviceKeyhuman ownerRevoke a device key by prefix.
delegateagentMint a short-lived delegation token for another owned agent.
storeSecrethuman owner or authorized agentStore an encrypted agent secret.
listSecretshuman ownerList secret names.
deleteSecrethuman ownerDelete a secret.
getSecretauthorized agentRetrieve a scoped secret value. Requires sessionId and stamps sensitive_access=true on that session.

See https://ujex.dev/openapi.json for the machine-readable Inbox/session subset.