---
title: "Create Snippet"
method: POST
path: "/snippets"
tags: ["Tool", "Snippet"]
---

# Create Snippet

`POST /snippets`

Creates a new conversation snippet that can be used for reference, analysis, or sharing. This endpoint allows you to capture and store important parts of conversations for future use.

## Request body

- CreateSnippetRequest
  - `user_uuid` string, required
  - `conversation_id` string, required
  - `reference` NewSnippetReference
    - `characters` NewRange, required
      - `start_idx` string, required
      - `end_idx` string, required
    - `speakers` NewRange, required
      - `start_idx` string, required
      - `end_idx` string, required
    - `transcript_version` 'V1' | 'V2', required
  - `video` NewVideoTimespan, required
    - `start_time` number, required
    - `end_time` number, required
    - `duration` number
  - `notes` string
  - `title` string
  - `in_library` boolean — Indicates whether the snippet should be added to the library or not
  - `library_item_info` NewLibraryItemInfo
    - `my_library` boolean, required
    - `folder_path` string
  - `internal` boolean, required
  - `notify_views` boolean, required

## Response `200`

Snippet successfully created and stored

- CreatedSnippetResponse
  - `url` string, required
  - `id` string, required
  - `share_code` string

## Other responses

- `401` — Authentication failed - valid API key required
- `default` — Unexpected error occurred while creating the snippet

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/revisions/5de55d3804cf/schema)