---
title: "Queue automatic clip suggestions"
method: POST
path: "/api/v1/projects/{projectId}/auto-pick"
tags: ["Moments"]
---

# Queue automatic clip suggestions

`POST /api/v1/projects/{projectId}/auto-pick`

## Request

- Base URL: `https://prismclip.com`
- URL: `https://prismclip.com/api/v1/projects/{projectId}/auto-pick`
- Auth: HTTP bearer

Queue 1–12 independent 15–30 second clip suggestions from an owned project's completed visual timeline. The operation is asynchronous and safely replayed with the same Idempotency-Key.

## Path parameters

- `projectId` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `count` integer, required: Number of independent clip suggestions to create

## Response `200`

An earlier request with this idempotency key was replayed.

- object
  - `job` object, required
    - `id` string, uuid, required
    - `status` string, required
    - `createdAt` string, required: ISO 8601 timestamp
    - `requestedCount` integer, required
    - `projectId` string, uuid, required
    - `replayed` boolean, required

## Other responses

- `202`: The automatic selection job was queued.
- `400`: The count or idempotency key is invalid.
- `401`: The API key is missing or invalid.
- `404`: The owned project was not found.
- `409`: The project does not have a completed visual analysis.
- `429`: The API-key rate limit was exceeded.
- `503`: Automatic clip selection is unavailable.

---

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