---
title: "Redeem a completed PostHog authorization"
method: POST
path: "/v1/auth/posthog/poll"
tags: ["Auth"]
---

# Redeem a completed PostHog authorization

`POST /v1/auth/posthog/poll`

## Request

- Base URL: `https://api.agentry.sh`
- URL: `https://api.agentry.sh/v1/auth/posthog/poll`
- Auth: none declared

Uses the opaque poll token plus the one-time loopback ticket and verifier. Success mints one private agentry_sk_ owner key and returns one authorization_id for an atomic project claim; it never returns a PostHog token.

## Request body

- object
  - `poll_token` string, required
  - `handoff_ticket` string, required
  - `handoff_verifier` string, required

## Response `200`

OK

- union
  - PosthogAuthSuccessResponse
    - `status` 'ok', required
    - `api_key` string, required
    - `prefix` string, required
    - `authorization_id` string, required
    - `authorization_expires_at` integer, required
    - `user` object, required
    - `next_action` string, required
  - object
    - `status` 'pending' | 'slow_down' | 'expired' | 'failed', required
    - `interval` integer
    - `error_code` string
    - `next_action` string, required

## Other responses

- `400`: OK
- `default`: Error

---

[API](https://skmtc.dev/agentry/apis/agentry-api.md) · [All operations](https://skmtc.dev/agentry/apis/agentry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentry/apis/agentry-api/revisions/abdecddf009f?raw)