Swap a one-time code for the workspace’s key
Swap a one-time code for the workspace’s key
Your server, after Rydhm sends the admin back to your redirect_uri with code and state (check state). Form-encoded or JSON. The client authenticates with client_secret (in the body, or HTTP Basic) when the app has one, and always with the PKCE code_verifier. A code works once, for 10 minutes; presented again, the connection it made is revoked. Connecting the same app to the same workspace again replaces the earlier connection. Errors are RFC 6749: invalid_request, invalid_client (401), invalid_grant, unsupported_grant_type.
No API key: your app authenticates with its client id and secret (in the body, or HTTP Basic) and the PKCE code_verifier. Rate limited per address and per app.
Request
rydhm_app_… (or in HTTP Basic).
The PKCE verifier whose S256 challenge started the connection (43–128 characters).
rydhm_cs_…, when the app has one (or in HTTP Basic).
Response
rydhm_live_…: send it as Bearer on every call for this workspace.
The granted scopes, space-separated.
Why no webhook endpoint could be added (the connection works anyway).