Queue a self-service required action
Queues a Keycloak required-action on the caller and invalidates their sessions so the next sign-in walks them through it (TOTP enrollment, WebAuthn registration, password rotation, etc.). Allows only safe self-applied actions; admin-driven required-actions go through a different surface. Works only for Keycloak-authenticated callers.
Headers
Idempotency-KeyUnique key that makes this POST safe to retry: repeats with the same key replay the first response instead of re-executing. Replays are scoped to the retrying principal (same API key / user) and kept for 24 hours. Required on every POST.
Client-generated idempotency key (e.g. a UUID).
X-Workspace-IdSelects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.
Workspace UUID or slug.
Queue a self-service required action › Responses
No Content