Skip to main content
POST
Generate Intent

Overview

Generates a User Intent Signature (UIS) — a SHA-256 hash that represents what a user intends to do, without including any PII. Call this before sending a user’s request to your AI service. Attach the returned intent_hash to the AI request via the X-Intent-Hash header.

Request

string
required
Your Aether Citadel API key (ack_live_...)
string
required
The user’s JWT from your authentication system. Used to fetch semantic context from AetherDB. The token itself is never stored by Citadel.
integer
default:"3600"
Time-to-live in seconds for this intent signature. After expiry, verify will return ExpiredIntent. Default: 3600 (1 hour). Max recommended: 86400 (24h).

Response

string
The zero-knowledge intent signature. Format: sha256:<64 hex chars>. Attach this to your AI request as X-Intent-Hash.
string
Semantic classification of user intent. One of: commerce, infrastructure, wellness, finance, education, social, other.
integer
Unix timestamp when this intent expires. After this time, verification will fail with ExpiredIntent.

Example

200 Response:

Error Responses


Notes

  • The user_token is sent to AetherDB (within your infrastructure) to extract semantic tags. It is never stored by Citadel.
  • Each call generates a new, unique intent hash — even for the same user.
  • Intent hashes are single-use — do not reuse them across different AI requests.