---
title: "Select an alignment using timing and selection revisions"
method: PUT
path: "/projects/{projectId}/alignments/{alignmentId}/selection"
tags: ["Projects"]
---

# Select an alignment using timing and selection revisions

`PUT /projects/{projectId}/alignments/{alignmentId}/selection`

## Request

- Base URL: `https://api.youka.io/api/v1`
- URL: `https://api.youka.io/api/v1/projects/{projectId}/alignments/{alignmentId}/selection`
- Auth: HTTP bearer

## Path parameters

- `projectId` string, required
- `alignmentId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- AlignmentSelectRequest
  - `expectedRevision` string, required
  - `expectedSelectionRevision` string, required

## Response `200`

Success

- ProjectAlignment
  - `id` string, required
  - `model` string, required
  - `alignment` object, required
    - `items` object[], required
      - `id` string
      - `line` number, required
      - `word` number, required
      - `subword` number, required
      - `start` number, required
      - `end` number, required
      - `text` string, required
      - `singer` number
      - `translations` object
  - `createdAt` string, required
  - `name` string, nullable
  - `revision` string, required
  - `selected` boolean, required
  - `selectionRevision` string, required

## Other responses

- `409`: Timing or selection revision changed. Fetch fresh state before applying edits.

## Changes

- **2026-11-03** `3d5636b5e96d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/youka/apis/youka-rest-api/changes/projects/:projectId/alignments/:alignmentId/selection/put.md)

---

[API](https://skmtc.dev/youka/apis/youka-rest-api.md) - [All operations](https://skmtc.dev/youka/apis/youka-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/youka/apis/youka-rest-api/revisions/3d5636b5e96d?raw)