---
title: "Save Annotations"
method: POST
path: "/api/v1/aRole/annotations/{video_id}"
tags: ["aRole"]
---

# Save Annotations

`POST /api/v1/aRole/annotations/{video_id}`

Save annotations for a specific video and generate embeddings for each annotation description.

Args:
    video_id: The ID of the video to annotate
    request: The annotation data containing timestamps and descriptions
    db: Database session
    user: The authenticated user
    
Returns:
    JSON response confirming the annotations were saved with their embeddings

## Path parameters

- `video_id` string, required

## Request body

- AnnotationRequest
  - `annotations` Annotation[], required
    - `id` string, nullable
    - `startTime` number, required
    - `endTime` number, required
    - `description` string, required
  - `videoMetadata` VideoMetadata
    - `id` string, required
    - `user_id` string, required
    - `name` string, required
    - `domain_id` string, required
    - `account_id` string, required
    - `media_url` string, required
    - `type` string, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `video_index` string, required
    - `indexingStatus` string, required
    - `orientation` string, required
    - `error_details` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) · [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brandbooster/fastapi/revisions/624917d53409/schema)