REST API & cURL Console
Configure requests, view real-time cURL command generation, and execute live API calls in-situ.
/api/secrets (Aliases: /, /secret)Creates a one-time secret payload. Accepts JSON, URL-encoded form data, or raw string bodies. Returns a secret ID and shareable URL.
/api/secrets/:idRetrieves and immediately consumes (deletes) the secret. This endpoint executes an atomic self-destruction read.
/api/secrets/:id/checkChecks if a secret exists and is valid without consuming or deleting it.
/healthChecks server operational status and uptime.
[ API SPECIFICATION REFERENCE ]
| Field | Type | Location | Description |
|---|---|---|---|
| content | string | Body | Secret payload text. Aliases: secret, text, data, or raw body. |
| expires | integer | Body / Query | Expiration in seconds (60 to 2592000). Default: 86400 (24 hours). |
| isEncrypted | boolean | Body | Defaults to false for API requests. |
| raw | boolean | Query | If raw=true, returns raw text body instead of JSON wrapper. |
| Authorization | header | Header | Optional. Bearer <token> — authenticates as a member, applying member-tier limits to the request. Also accepted: the hushhh_user_session cookie set by logging in through the browser. |
[ MEMBER ACCOUNTS & API TOKENS ]
Create a free account →Accounts are entirely optional — every endpoint above works anonymously with no change in behavior. Registering lets you see and revoke your own secrets from /account, where you can also generate an API token for scripted or cURL access without a browser session. Paste it into the field above to try it live.
| Anonymous | Member (Bearer token) | |
|---|---|---|
| Max secret size | 50,000 chars | 500,000 chars |
| Max expiry | 30 days | 90 days |
| Secret creation rate limit | 10 / min | 60 / min |
Logging in never grants the server access to your secret's content — only to metadata (id, expiry, status) via GET /api/users/me/secrets. E2EE content stays exactly as inaccessible to us as it is for anonymous secrets.
Click "Send Request" to execute API call...