Auth

Start one-click PostHog sign-in and read-only project authorization

Creates one short-lived PostHog Cloud OIDC + read-only project consent transaction bound to the initiating CLI's ephemeral 127.0.0.1 callback. The opaque poll token, loopback ticket, and verifier are local secrets; PostHog access and refresh tokens never leave the hosted control plane.

post/v1/auth/posthog

Request

  • Base URL: https://api.agentry.sh
  • URL: https://api.agentry.sh/v1/auth/posthog
  • Auth: none declared

Request body

region'us' | 'eu' required
client_namestring

Optional agent or client name used for bounded attribution.

distribution_surfacestring

Optional coarse acquisition source such as codex_skill or cli.

handoff_redirect_uristring required

Ephemeral callback created by the interactive CLI on this computer. Only exact 127.0.0.1 callbacks are accepted.

handoff_challengestring required

SHA-256 base64url challenge binding the callback ticket to the initiating CLI.

Response

OK

authorization_urlstring required
poll_tokenstring required
expires_ininteger required
intervalinteger required
next_actionstring required

Changes

No recorded changes to this operation across all 1 revision of this API.