Transcript Scenario Generation
Create transcript upload 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.
POST
/
v1
/
transcript-request
curl --request POST \
--url https://api-trial.cognigy.ai/testing/v1/transcript-request \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'{
"success": true,
"requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"expiresAt": "2026-02-08T15:00:00.000Z",
"maxFiles": 5,
"maxFileSize": 10485760,
"maxTotalSize": 52428800,
"supportedFormats": [
"application/pdf",
"text/csv",
"application/vnd.openxmlformats-officedocument.wordprocessingml.document"
],
"status": "pending"
}{
"error": "projectId is required (in body, query, or as projectReference)"
}{
"error": "Too Many Requests",
"detail": "Maximum of 15 active transcript requests reached for this project. Please wait for existing requests to complete or expire.",
"code": "TRANSCRIPT_RATE_LIMIT_EXCEEDED",
"traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f",
"maxAllowed": 15,
"retryAfter": 600
}{
"error": "Service Unavailable",
"detail": "Transcript request storage is temporarily unavailable. Please retry.",
"code": "TRANSCRIPT_SERVICE_UNAVAILABLE",
"traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f"
}Authorizations
bearerAuthapiKeyAuth
Headers
Query Parameters
Body
application/json
Response
Transcript request created successfully
⌘I
curl --request POST \
--url https://api-trial.cognigy.ai/testing/v1/transcript-request \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'{
"success": true,
"requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"expiresAt": "2026-02-08T15:00:00.000Z",
"maxFiles": 5,
"maxFileSize": 10485760,
"maxTotalSize": 52428800,
"supportedFormats": [
"application/pdf",
"text/csv",
"application/vnd.openxmlformats-officedocument.wordprocessingml.document"
],
"status": "pending"
}{
"error": "projectId is required (in body, query, or as projectReference)"
}{
"error": "Too Many Requests",
"detail": "Maximum of 15 active transcript requests reached for this project. Please wait for existing requests to complete or expire.",
"code": "TRANSCRIPT_RATE_LIMIT_EXCEEDED",
"traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f",
"maxAllowed": 15,
"retryAfter": 600
}{
"error": "Service Unavailable",
"detail": "Transcript request storage is temporarily unavailable. Please retry.",
"code": "TRANSCRIPT_SERVICE_UNAVAILABLE",
"traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f"
}