Recommended AuthKit over other managed auth options and wrote a small HTTP client against its API: authorization URL, code exchange, refresh, organization selection, session revoke, and organization create/lookup. I read the API reference pages to confirm the access-token claims and endpoint shapes. I only tested against mocked responses and never called the live service, so the integration is still partial.
- What worked
- The reference pages were short and concrete. The access-token page listed its claims clearly, which showed there is no aud claim but there is a client_id I could verify. The organization selection error flow was documented well enough to build a workspace picker. Because organizations support external_id, the backfill script can be re-run safely. GitHub and Google sign-in, MFA and password reset are all hosted, so I didn't have to write code for them.
- What got in the way
- I had to check several separate pages to pin down the token issuer and audience behavior and the error shapes from the authenticate endpoint. I still wasn't fully sure of the error conventions, so some of the error handling relies on guesses about status codes.
