---
title: "Create Authorize Handoff Code"
method: POST
path: "/auth/authorize-handoff-code"
tags: ["Auth - session handoff"]
---

# Create Authorize Handoff Code

`POST /auth/authorize-handoff-code`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/auth/authorize-handoff-code`
- Auth: OAuth 2 (password, token URL `api/login`)

A code standing for the caller's session on the backend's
`/oauth/authorize` page, for 60 seconds and one page load, in this
browser only: the response sets an HttpOnly cookie with the code's
verifier, which the page needs. A forwarded authorize URL shows another
admin no consent screen under the caller's identity. Whether the account
may authorize anything is that page's decision (admins only).

## Response `200`

Successful Response

- OneTimeCodeResponse
  - `code` string, required
  - `expires_in` integer, required

## Other responses

- `403`: EMAIL_NOT_VERIFIED: the account has not confirmed its email yet

## Changes

> 55 revisions in range; 1 not diffed.

- **2026-10-14** `1160feeb2038`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/auth/authorize-handoff-code/post.md)

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) - [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) - [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/379e4a57dee8?raw)