OKTA-1246319 - Document PATCH support for configuring an existing AI agent as a CIMD client

[brentschaus-okta]

Description:

• What's changed? The CIMD registration guide said that converting an existing AI agent from BYOK to CIMD required deleting and recreating the agent. The OAS3 spec was updated after this guide published (OKTA-1238297, atko-eng/okta-oas3#3793) to add oauthClient support to PATCH /workload-principals/api/v1/ai-agents/{agentId}, so this is no longer accurate. This PR:
  • Updates the note that previously described the delete-and-recreate workaround.
  • Adds a new "Configure an existing AI agent as a CIMD client" section with a PATCH example.
  • Adds a matching learning outcome bullet.
• Is this PR related to a Monolith release? Yes, 2026.09.1

Resolves:

• OKTA-1246319

Vercel Preview Link:

https://developer-docs-jz118rdig-doc-tools-8ec9f365.vercel.app/docs/guides/ai-agent-cimd-registration/main/#configure-an-existing-ai-agent-as-a-cimd-client

[okta-prod-github-app]

Acrolinx score

A minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Select Total score to review the Acrolinx scorecard for your article. Try to increase your individual scores, for example: Correctness. Your content will be clearer and more consistent.

Article	Total score Required:80	Word and phrases (Brand, terms) Preferred: 80	Correctness (Spelling, grammar) Preferred: 80	Clarity (Readability) Preferred: 80	Inclusive language (+ accesibility) Preferred: 80
✅ packages/@okta/vuepress-site/docs/guides/ai-agent-cimd-registration/main/index.md	87	88	79	83

Successfully checked 1 of 1 documents.
See summary in Content Analysis Dashboard

Reopen the pull request or push new changes to check again.

Depending on the Acrolinx server configuration, the
links expire after some time and you must have a login for the
Acrolinx server to access them again.

[okta-prod-github-app]

Acrolinx score

A minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Select Total score to review the Acrolinx scorecard for your article. Try to increase your individual scores, for example: Correctness. Your content will be clearer and more consistent.

Article	Total score Required:80	Word and phrases (Brand, terms) Preferred: 80	Correctness (Spelling, grammar) Preferred: 80	Clarity (Readability) Preferred: 80	Inclusive language (+ accesibility) Preferred: 80
✅ packages/@okta/vuepress-site/docs/guides/ai-agent-cimd-registration/main/index.md	87	88	79	83

Successfully checked 1 of 1 documents.
See summary in Content Analysis Dashboard

Reopen the pull request or push new changes to check again.

Depending on the Acrolinx server configuration, the
links expire after some time and you must have a login for the
Acrolinx server to access them again.

[okta-prod-github-app]

Acrolinx score

A minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Select Total score to review the Acrolinx scorecard for your article. Try to increase your individual scores, for example: Correctness. Your content will be clearer and more consistent.

Article	Total score Required:80	Word and phrases (Brand, terms) Preferred: 80	Correctness (Spelling, grammar) Preferred: 80	Clarity (Readability) Preferred: 80	Inclusive language (+ accesibility) Preferred: 80
✅ packages/@okta/vuepress-site/docs/guides/ai-agent-cimd-registration/main/index.md	87	88	79	83

Successfully checked 1 of 1 documents.
See summary in Content Analysis Dashboard

Reopen the pull request or push new changes to check again.

Depending on the Acrolinx server configuration, the
links expire after some time and you must have a login for the
Acrolinx server to access them again.