---
title: "Create a Studio create-handoff URL"
method: POST
path: "/handoffs"
tags: ["Agent"]
---

# Create a Studio create-handoff URL

`POST /handoffs`

## Request

- Base URL: `https://studio.listnr.ai/api/v1`
- URL: `https://studio.listnr.ai/api/v1/handoffs`
- Auth: none required
- TypeScript: <https://skmtc.dev/listnr/apis/listnr-studio-api/docs/handoffs/post.ts> (a function with typed inputs; its response is checked against the schema)

Idempotent write that returns a /create?tool=<toolId> URL. It does not generate video or charge credits. Retry with the same Idempotency-Key to receive the original handoff.

## Query parameters

- `toolId` string

## Headers

- `Idempotency-Key` string

## Response `201`

Handoff created or replayed

- Handoff
  - `toolId` string, required
  - `createHref` string, required
  - `url` string, uri, required
  - `billed` boolean

## Other responses

- `429`: Too many requests from this IP. Honor RateLimit and Retry-After.

---

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