---
title: "Submit an asynchronous onboarding mirror request"
method: POST
path: "/api/v1/repositories/available/mirror-requests/{owner}/{repo}"
tags: ["Repositories"]
---

# Submit an asynchronous onboarding mirror request

`POST /api/v1/repositories/available/mirror-requests/{owner}/{repo}`

## Path parameters

- `owner` string, required
- `repo` string, required

## Request body

- object
  - `clusterHost` string, required

## Response `202`

Mirror creation request accepted

- object
  - `requestId` string, uuid, required
  - `status` 'pending' | 'processing' | 'succeeded' | 'failed', required
  - `pollUrl` string, required

## Other responses

- `400` — Invalid request
- `401` — Core authentication required
- `403` — Repository access denied
- `422` — Repository cannot be mirrored or region unavailable
- `502` — Failed to submit mirror request

## Changes

- **2026-09-04** `6a719469b72a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/repositories/available/mirror-requests/:owner/:repo/post.md)

---

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