Skip to content

docs: note new identities default to active state#2660

Open
jhickmanit wants to merge 2 commits into
masterfrom
docs/note-identity-default-active-state
Open

docs: note new identities default to active state#2660
jhickmanit wants to merge 2 commits into
masterfrom
docs/note-identity-default-active-state

Conversation

@jhickmanit

Copy link
Copy Markdown
Contributor

What

Adds a short note to the Create identities page explaining that identities created via the admin API default to the `active` state (already visible as `"state": "active"` in the sample response, but previously unexplained), and how to create an `inactive` identity instead.

Why

The sample response on this page shows `"state": "active"` with no explanation. This clarifies the default and points readers to the identity state page for activating/de-activating identities.

Notes

  • Verified the `createIdentityBody` API schema accepts a `state` field (enum `active`/`inactive`) in `src/static/api.json`, so the "set `state` to `inactive`" guidance is accurate.
  • This section is still in the pre-migration `docs/kratos/` structure, so a plain `/docs/...mdx` file-path link is used (not `SameDeploymentLink`), consistent with neighboring pages. No migrated equivalent of this creation-flow page exists.

Explain that identities created via the admin API default to the active
state, and how to create an inactive identity, linking to the identity
state page.
Copilot AI review requested due to automatic review settings July 3, 2026 16:16

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a clarifying note to the existing (pre-migration) Kratos “Create identities” documentation explaining the default identity state returned by the Admin API and how to create an inactive identity.

Changes:

  • Document that identities created via the Admin API default to state: active.
  • Add guidance to set state: inactive to prevent sign-in until activation.
  • Link readers to the identity state documentation for additional details.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/kratos/manage-identities/20_create-users-identities.mdx Outdated
Absolute /docs/...mdx links aren't resolved as source-file references by
Docusaurus and ignore the target's custom slug, producing a broken link.
Use a relative .mdx link so the route resolves via the doc graph.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants