---
title: "Build an agent handoff prompt"
method: GET
path: "/api/v1/handoffs/{referenceId}"
tags: ["handoffs"]
---

# Build an agent handoff prompt

`GET /api/v1/handoffs/{referenceId}`

## Request

- Base URL: `https://screenrove.com`
- URL: `https://screenrove.com/api/v1/handoffs/{referenceId}`
- Auth: none declared

Generate a complete build prompt for a coding agent: ordered screens with notes, observed
transitions, full-resolution image URLs, the measured design guide, and an implementation
checklist. This is the same prompt as the "Use in agent" button on the site.

Reference IDs: use `{product}-onboarding` for a product's signup flow, `{product}-collection`
for all their screens, or any single screen id (like `linear-marketing-pricing`).

Use this when you want to build UI that follows a real product's patterns. The prompt includes
everything an agent needs: screenshots to reference, design tokens to match, and implementation
steps to follow.

## Path parameters

- `referenceId` string, required

## Query parameters

- `goal` string
- `stack` string
- `screens` string
- `includeDesign` boolean

## Response `200`

Prompt and machine-readable manifest.

- Handoff
  - `prompt` string: Markdown prompt to follow or paste into an agent.
  - `manifest` object: Versioned reference manifest

## Other responses

- `400`: The request could not be used.
- `404`: No product, screen or reference with that id.

---

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