---
title: "Create transcript upload request"
method: POST
path: "/v1/transcript-request"
tags: ["Transcript Scenario Generation"]
---

# Create transcript upload request

`POST /v1/transcript-request`

Create a new transcript upload session. This is the first step in the three-step workflow
for generating scenarios from transcript files.

This endpoint:
- Creates a new request with a unique ID
- Checks rate limits per project (max active requests)
- Returns configuration details (max files, max file size, supported formats)

The returned requestId must be passed in subsequent upload and generation calls.

**projectId is required.** Provide it via the `project_id` header, or in the request body/query.

## Query parameters

- `projectId` string

## Headers

- `project_id` string

## Request body

- object
  - `projectId` string — Project identifier (alternative to project_id header)
  - `projectReference` string — Alternative project reference

## Response `201`

Transcript request created successfully

- object
  - `success` boolean, required
  - `requestId` string, required — Unique request identifier for subsequent calls
  - `expiresAt` string, date-time, required — When this request will expire
  - `maxFiles` integer, required — Maximum number of files that can be uploaded
  - `maxFileSize` integer, required — Maximum file size in bytes
  - `maxTotalSize` integer — Maximum total upload size in bytes
  - `supportedFormats` string[], required — Supported file formats
  - `status` 'pending', required — Request status

## Other responses

- `400` — Bad Request - projectId is required (provide via project_id header, or in body/query)
- `401` — Unauthorized
- `403` — Forbidden - Insufficient permissions
- `429` — Too Many Requests - Rate limit exceeded

---

[API](https://skmtc.net/cognigy/apis/simulator-openapi-rest-ful-api-reference.md) · [All operations](https://skmtc.net/cognigy/apis/simulator-openapi-rest-ful-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cognigy/simulator-openapi-rest-ful-api-reference/revisions/85b2872bdfb7/schema)