From 3841f22910f4d7691c9af8cd3b5ed26896d0fde4 Mon Sep 17 00:00:00 2001 From: jhickmanit Date: Fri, 3 Jul 2026 09:15:56 -0700 Subject: [PATCH 1/2] docs: note new identities default to active state 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. --- docs/kratos/manage-identities/20_create-users-identities.mdx | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/kratos/manage-identities/20_create-users-identities.mdx b/docs/kratos/manage-identities/20_create-users-identities.mdx index 445562a64c..cdaadeed08 100644 --- a/docs/kratos/manage-identities/20_create-users-identities.mdx +++ b/docs/kratos/manage-identities/20_create-users-identities.mdx @@ -74,6 +74,11 @@ The server response contains the created identity: } ``` +Newly created identities default to the `active` state, as shown by the `"state": "active"` field in the response. Active +identities can immediately use self-service flows such as sign-in. To create an identity that can't sign in yet, set `state` to +`inactive` in the request body. For more information, see +[Activate and de-activate identities](/docs/identities/model/identity-state.mdx). + Keep in mind that you can change the `schema_id` to reflect the schema you want to use for this identity. Similarly, the trait key/values depend on your schema as well. The command shown does not create a password or any other type of credential for the identity. From cd45c6a26afbc8ba9e117ef513c750b26ebfa15f Mon Sep 17 00:00:00 2001 From: jhickmanit Date: Fri, 3 Jul 2026 09:49:33 -0700 Subject: [PATCH 2/2] docs: use relative source-file link to identity state page 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. --- docs/kratos/manage-identities/20_create-users-identities.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/kratos/manage-identities/20_create-users-identities.mdx b/docs/kratos/manage-identities/20_create-users-identities.mdx index cdaadeed08..e735eec637 100644 --- a/docs/kratos/manage-identities/20_create-users-identities.mdx +++ b/docs/kratos/manage-identities/20_create-users-identities.mdx @@ -77,7 +77,7 @@ The server response contains the created identity: Newly created identities default to the `active` state, as shown by the `"state": "active"` field in the response. Active identities can immediately use self-service flows such as sign-in. To create an identity that can't sign in yet, set `state` to `inactive` in the request body. For more information, see -[Activate and de-activate identities](/docs/identities/model/identity-state.mdx). +[Activate and de-activate identities](../../identities/model/identity-state.mdx). Keep in mind that you can change the `schema_id` to reflect the schema you want to use for this identity. Similarly, the trait key/values depend on your schema as well. The command shown does not create a password or any other type of credential for the