Skip to content

feat(okta): add SKILL.md for Okta emulator#58

Open
mvanhorn wants to merge 2 commits intovercel-labs:mainfrom
mvanhorn:feat/okta-skill
Open

feat(okta): add SKILL.md for Okta emulator#58
mvanhorn wants to merge 2 commits intovercel-labs:mainfrom
mvanhorn:feat/okta-skill

Conversation

@mvanhorn
Copy link
Copy Markdown
Contributor

@mvanhorn mvanhorn commented Apr 8, 2026

Adds agent-consumable documentation for the Okta emulator package.

Covers the admin API (users, groups, apps, authorization servers) and the full OAuth/OIDC implementation with dual-routing (org-level at /oauth2/v1/ and per-authorization-server at /oauth2//v1/). Documents user lifecycle state machine (STAGED, ACTIVE, SUSPENDED, DEPROVISIONED), group membership, app assignment, and token introspection/revocation. Includes Okta Node.js SDK integration (orgUrl override), seed config YAML, and common patterns (OIDC login, lifecycle management).

Follows the same structure as existing skills (resend, slack, etc.).

This contribution was developed with AI assistance (Claude Code).

Documents all admin API endpoints, user lifecycle states,
group and app management, dual-routing OAuth/OIDC (org-level
and per-authorization-server), and token introspection.
@vercel
Copy link
Copy Markdown
Contributor

vercel bot commented Apr 8, 2026

@mvanhorn is attempting to deploy a commit to the Vercel Labs Team on Vercel.

A member of the Team first needs to authorize it.


# Partial update (POST merges profile)
curl -X POST $BASE/api/v1/users/<userId> \
-H "Authorization: SSWS $TOKEN" \
Copy link
Copy Markdown
Contributor

@vercel vercel bot Apr 8, 2026

Choose a reason for hiding this comment

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

SKILL.md documents reactivation as transitioning to ACTIVE, but the implementation transitions to PROVISIONED, misleading agents about expected user status after reactivation.

Fix on Vercel

Comment on lines +407 to +408
// Create user (starts as STAGED)
const res = await fetch(`${BASE}/api/v1/users`, {
Copy link
Copy Markdown
Contributor

@vercel vercel bot Apr 8, 2026

Choose a reason for hiding this comment

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

SKILL.md "User Lifecycle Management" example claims POST /api/v1/users creates a STAGED user, but the implementation defaults activate=true, creating an ACTIVE user instead.

Fix on Vercel

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.

1 participant