---
title: "Create new export snapshot"
method: POST
path: "/api/projects/{id}/exports/"
tags: ["Export"]
---

# Create new export snapshot

`POST /api/projects/{id}/exports/`

Create a new export request to start a background task and generate an export file for a specific project by ID.

## Path parameters

- `id` integer, required

## Request body

- LseExportCreateRequest
  - `annotation_filter_options` LseAnnotationFilterOptionsRequest
    - `ground_truth` boolean, nullable — Include ground truth annotations
    - `reviewed` 'only' | 'exclude' — * `only` - only * `exclude` - exclude * `None` - None
    - `skipped` boolean, nullable — Include skipped annotations
    - `usual` boolean, nullable — Include not skipped and not ground truth annotations
  - `converted_formats` ConvertedFormatRequest[]
    - `export_type` string, required
    - `status` 'created' | 'in_progress' | 'failed' | 'completed' — * `created` - Created * `in_progress` - In progress * `failed` - Failed * `completed` - Completed
    - `traceback` string, nullable — Traceback report in case of errors
  - `counters` unknown
  - `created_by` UserSimpleRequest — A ModelSerializer that takes additional arguments for "fields", "omit" and "expand" in order to control which fields are displayed, and whether to replace simple values with complex, nested serializations
    - `email` string, email
    - `first_name` string
    - `last_name` string
    - `username` string, required
  - `finished_at` string, date-time, nullable — Complete or fail time
  - `md5` string
  - `serialization_options` SerializationOptionsRequest
    - `annotations__completed_by` SerializationOptionRequest
      - `only_id` boolean — Include a full json body or IDs only
    - `drafts` SerializationOptionRequest
      - `only_id` boolean — Include a full json body or IDs only
    - `include_annotation_history` boolean — Include annotation history
    - `interpolate_key_frames` boolean — Interpolate video key frames
    - `predictions` SerializationOptionRequest
      - `only_id` boolean — Include a full json body or IDs only
  - `status` 'created' | 'in_progress' | 'failed' | 'completed' — * `created` - Created * `in_progress` - In progress * `failed` - Failed * `completed` - Completed
  - `task_filter_options` LseTaskFilterOptionsRequest
    - `annotated` 'only' | 'exclude' — * `only` - only * `exclude` - exclude * `None` - None
    - `finished` 'only' | 'exclude' — * `only` - only * `exclude` - exclude * `None` - None
    - `only_with_annotations` boolean
    - `reviewed` 'only' | 'exclude' — * `only` - only * `exclude` - exclude * `None` - None
    - `skipped` 'only' | 'exclude' — * `only` - only * `exclude` - exclude * `None` - None
    - `view` integer — Apply filters from the view ID (a tab from the Data Manager)
  - `title` string

## Response `201`

- LseExportCreate
  - `annotation_filter_options` LseAnnotationFilterOptions
    - `ground_truth` boolean, nullable — Include ground truth annotations
    - `reviewed` 'only' | 'exclude' — * `only` - only * `exclude` - exclude * `None` - None
    - `skipped` boolean, nullable — Include skipped annotations
    - `usual` boolean, nullable — Include not skipped and not ground truth annotations
  - `converted_formats` ConvertedFormat[]
    - `export_type` string, required
    - `id` integer, required
    - `status` 'created' | 'in_progress' | 'failed' | 'completed' — * `created` - Created * `in_progress` - In progress * `failed` - Failed * `completed` - Completed
    - `traceback` string, nullable — Traceback report in case of errors
  - `counters` unknown
  - `created_at` string, date-time, required — Creation time
  - `created_by` UserSimple — A ModelSerializer that takes additional arguments for "fields", "omit" and "expand" in order to control which fields are displayed, and whether to replace simple values with complex, nested serializations
    - `avatar` string, nullable, required
    - `email` string, email
    - `first_name` string
    - `id` integer, required
    - `last_name` string
    - `username` string, required
  - `finished_at` string, date-time, nullable — Complete or fail time
  - `id` integer, required
  - `md5` string
  - `serialization_options` SerializationOptions
    - `annotations__completed_by` SerializationOption
      - `only_id` boolean — Include a full json body or IDs only
    - `drafts` SerializationOption
      - `only_id` boolean — Include a full json body or IDs only
    - `include_annotation_history` boolean — Include annotation history
    - `interpolate_key_frames` boolean — Interpolate video key frames
    - `predictions` SerializationOption
      - `only_id` boolean — Include a full json body or IDs only
  - `status` 'created' | 'in_progress' | 'failed' | 'completed' — * `created` - Created * `in_progress` - In progress * `failed` - Failed * `completed` - Completed
  - `task_filter_options` LseTaskFilterOptions
    - `annotated` 'only' | 'exclude' — * `only` - only * `exclude` - exclude * `None` - None
    - `finished` 'only' | 'exclude' — * `only` - only * `exclude` - exclude * `None` - None
    - `only_with_annotations` boolean
    - `reviewed` 'only' | 'exclude' — * `only` - only * `exclude` - exclude * `None` - None
    - `skipped` 'only' | 'exclude' — * `only` - only * `exclude` - exclude * `None` - None
    - `view` integer — Apply filters from the view ID (a tab from the Data Manager)
  - `title` string

---

[API](https://skmtc.net/humansignal/apis/label-studio-api.md) · [All operations](https://skmtc.net/humansignal/apis/label-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humansignal/label-studio-api/versions/1b113b8df950/schema)