{ "openapi": "3.1.1", "info": { "title": "VoiceStudio client API", "version": "1.0.0", "description": "Generated from @voicestudio/contracts/integrations. Changes belong in the shared operation catalog." }, "servers": [ { "url": "https://api.tryvoicestudio.com/v1" } ], "components": { "securitySchemes": { "apiKey": { "type": "apiKey", "in": "header", "name": "x-api-key" }, "bearerToken": { "type": "http", "scheme": "bearer", "bearerFormat": "Opaque VoiceStudio access token" } } }, "paths": { "/account": { "get": { "operationId": "account_get", "summary": "Lire votre compte", "description": "Lire votre compte. Permission requise : `account:read`. Les accès sont limités par les droits actuels de votre compte, de votre entreprise et de vos projets.", "tags": ["account"], "security": [ { "apiKey": [] }, { "bearerToken": [] } ], "x-required-scope": "account:read", "parameters": [], "responses": { "200": { "description": "Le résultat actuel dans le périmètre autorisé.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "displayName": { "type": "string" }, "accountType": { "type": "string", "enum": ["internal", "external"] } }, "required": ["id", "displayName", "accountType"], "additionalProperties": false }, "requestId": { "type": "string" } }, "required": ["data", "requestId"], "additionalProperties": false } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "401": { "description": "Missing, expired or revoked credential.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "403": { "description": "Scope, company access or review role is insufficient.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "404": { "description": "The resource is absent or inaccessible.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "409": { "description": "Review version or idempotency conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "413": { "description": "Request body too large.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "422": { "description": "Invalid arguments.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "429": { "description": "Rate limit exceeded; wait for Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "500": { "description": "The request could not be completed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "502": { "description": "Invalid upstream response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "503": { "description": "VoiceStudio is temporarily unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } } } } }, "/projects": { "get": { "operationId": "project_list", "summary": "Lister les projets", "description": "Lister les projets. Permission requise : `projects:read`. Les accès sont limités par les droits actuels de votre compte, de votre entreprise et de vos projets.", "tags": ["projects"], "security": [ { "apiKey": [] }, { "bearerToken": [] } ], "x-required-scope": "projects:read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "companyId", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Le résultat actuel dans le périmètre autorisé.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "companyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string" }, "status": { "type": "string" }, "sourceLanguage": { "type": "string" }, "createdAt": { "type": "string" }, "videoCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "localizationCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "completedLocalizationCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updatedAt": { "type": "string" } }, "required": [ "id", "companyId", "name", "status", "sourceLanguage", "createdAt", "videoCount", "localizationCount", "completedLocalizationCount", "updatedAt" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] } }, "required": ["items", "nextCursor"], "additionalProperties": false }, "requestId": { "type": "string" } }, "required": ["data", "requestId"], "additionalProperties": false } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "401": { "description": "Missing, expired or revoked credential.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "403": { "description": "Scope, company access or review role is insufficient.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "404": { "description": "The resource is absent or inaccessible.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "409": { "description": "Review version or idempotency conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "413": { "description": "Request body too large.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "422": { "description": "Invalid arguments.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "429": { "description": "Rate limit exceeded; wait for Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "500": { "description": "The request could not be completed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "502": { "description": "Invalid upstream response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "503": { "description": "VoiceStudio is temporarily unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } } } } }, "/projects/{projectId}": { "get": { "operationId": "project_get", "summary": "Consulter un projet", "description": "Consulter un projet. Permission requise : `projects:read`. Les accès sont limités par les droits actuels de votre compte, de votre entreprise et de vos projets.", "tags": ["projects"], "security": [ { "apiKey": [] }, { "bearerToken": [] } ], "x-required-scope": "projects:read", "parameters": [ { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Le résultat actuel dans le périmètre autorisé.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "companyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string" }, "status": { "type": "string" }, "sourceLanguage": { "type": "string" }, "createdAt": { "type": "string" }, "videoCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "localizationCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "completedLocalizationCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updatedAt": { "type": "string" } }, "required": [ "id", "companyId", "name", "status", "sourceLanguage", "createdAt", "videoCount", "localizationCount", "completedLocalizationCount", "updatedAt" ], "additionalProperties": false }, "requestId": { "type": "string" } }, "required": ["data", "requestId"], "additionalProperties": false } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "401": { "description": "Missing, expired or revoked credential.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "403": { "description": "Scope, company access or review role is insufficient.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "404": { "description": "The resource is absent or inaccessible.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "409": { "description": "Review version or idempotency conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "413": { "description": "Request body too large.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "422": { "description": "Invalid arguments.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "429": { "description": "Rate limit exceeded; wait for Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "500": { "description": "The request could not be completed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "502": { "description": "Invalid upstream response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "503": { "description": "VoiceStudio is temporarily unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } } } } }, "/videos": { "get": { "operationId": "video_list", "summary": "Lister les vidéos", "description": "Lister les vidéos. Permission requise : `videos:read`. Les accès sont limités par les droits actuels de votre compte, de votre entreprise et de vos projets.", "tags": ["videos"], "security": [ { "apiKey": [] }, { "bearerToken": [] } ], "x-required-scope": "videos:read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "companyId", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "projectId", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Le résultat actuel dans le périmètre autorisé.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "companyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "projectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string" }, "ingestionStatus": { "type": "string" }, "transcriptReviewStatus": { "type": "string" }, "voiceAssignmentStatus": { "type": "string" }, "durationUs": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "localizations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "language": { "type": "string" }, "status": { "type": "string" }, "translationApprovalStatus": { "type": "string" }, "lipSyncStatus": { "type": "string" } }, "required": [ "id", "language", "status", "translationApprovalStatus", "lipSyncStatus" ], "additionalProperties": false } } }, "required": [ "id", "companyId", "projectId", "name", "ingestionStatus", "transcriptReviewStatus", "voiceAssignmentStatus", "durationUs", "createdAt", "updatedAt", "localizations" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] } }, "required": ["items", "nextCursor"], "additionalProperties": false }, "requestId": { "type": "string" } }, "required": ["data", "requestId"], "additionalProperties": false } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "401": { "description": "Missing, expired or revoked credential.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "403": { "description": "Scope, company access or review role is insufficient.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "404": { "description": "The resource is absent or inaccessible.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "409": { "description": "Review version or idempotency conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "413": { "description": "Request body too large.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "422": { "description": "Invalid arguments.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "429": { "description": "Rate limit exceeded; wait for Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "500": { "description": "The request could not be completed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "502": { "description": "Invalid upstream response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "503": { "description": "VoiceStudio is temporarily unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } } } } }, "/videos/{videoId}": { "get": { "operationId": "video_get", "summary": "Consulter une vidéo", "description": "Consulter une vidéo. Permission requise : `videos:read`. Les accès sont limités par les droits actuels de votre compte, de votre entreprise et de vos projets.", "tags": ["videos"], "security": [ { "apiKey": [] }, { "bearerToken": [] } ], "x-required-scope": "videos:read", "parameters": [ { "name": "videoId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Le résultat actuel dans le périmètre autorisé.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "companyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "projectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string" }, "ingestionStatus": { "type": "string" }, "transcriptReviewStatus": { "type": "string" }, "voiceAssignmentStatus": { "type": "string" }, "durationUs": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "localizations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "language": { "type": "string" }, "status": { "type": "string" }, "translationApprovalStatus": { "type": "string" }, "lipSyncStatus": { "type": "string" } }, "required": [ "id", "language", "status", "translationApprovalStatus", "lipSyncStatus" ], "additionalProperties": false } } }, "required": [ "id", "companyId", "projectId", "name", "ingestionStatus", "transcriptReviewStatus", "voiceAssignmentStatus", "durationUs", "createdAt", "updatedAt", "localizations" ], "additionalProperties": false }, "requestId": { "type": "string" } }, "required": ["data", "requestId"], "additionalProperties": false } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "401": { "description": "Missing, expired or revoked credential.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "403": { "description": "Scope, company access or review role is insufficient.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "404": { "description": "The resource is absent or inaccessible.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "409": { "description": "Review version or idempotency conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "413": { "description": "Request body too large.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "422": { "description": "Invalid arguments.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "429": { "description": "Rate limit exceeded; wait for Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "500": { "description": "The request could not be completed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "502": { "description": "Invalid upstream response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "503": { "description": "VoiceStudio is temporarily unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } } } } }, "/reviews": { "get": { "operationId": "review_list", "summary": "Lister les reviews", "description": "Lister les reviews. Permission requise : `reviews:read`. Les accès sont limités par les droits actuels de votre compte, de votre entreprise et de vos projets.", "tags": ["reviews"], "security": [ { "apiKey": [] }, { "bearerToken": [] } ], "x-required-scope": "reviews:read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "companyId", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "projectId", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "pendingOnly", "in": "query", "required": false, "schema": { "default": true, "type": "boolean" } } ], "responses": { "200": { "description": "Le résultat actuel dans le périmètre autorisé.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "companyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "projectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "projectName": { "type": "string" }, "subjectType": { "type": "string" }, "subjectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "subjectRevision": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "status": { "type": "string" }, "requestedAudience": { "type": "string" }, "createdAt": { "type": "string" }, "videoId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "videoName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "language": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "type": "string", "format": "uri" }, "approvable": { "type": "boolean" }, "approvalUnavailableReason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "companyId", "projectId", "projectName", "subjectType", "subjectId", "subjectRevision", "status", "requestedAudience", "createdAt", "videoId", "videoName", "language", "url", "approvable", "approvalUnavailableReason" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] } }, "required": ["items", "nextCursor"], "additionalProperties": false }, "requestId": { "type": "string" } }, "required": ["data", "requestId"], "additionalProperties": false } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "401": { "description": "Missing, expired or revoked credential.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "403": { "description": "Scope, company access or review role is insufficient.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "404": { "description": "The resource is absent or inaccessible.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "409": { "description": "Review version or idempotency conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "413": { "description": "Request body too large.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "422": { "description": "Invalid arguments.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "429": { "description": "Rate limit exceeded; wait for Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "500": { "description": "The request could not be completed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "502": { "description": "Invalid upstream response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "503": { "description": "VoiceStudio is temporarily unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } } } } }, "/reviews/{reviewId}": { "get": { "operationId": "review_get", "summary": "Consulter une review", "description": "Consulter une review. Permission requise : `reviews:read`. Les accès sont limités par les droits actuels de votre compte, de votre entreprise et de vos projets.", "tags": ["reviews"], "security": [ { "apiKey": [] }, { "bearerToken": [] } ], "x-required-scope": "reviews:read", "parameters": [ { "name": "reviewId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Le résultat actuel dans le périmètre autorisé.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "companyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "projectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "projectName": { "type": "string" }, "subjectType": { "type": "string" }, "subjectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "subjectRevision": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "status": { "type": "string" }, "requestedAudience": { "type": "string" }, "createdAt": { "type": "string" }, "videoId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "videoName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "language": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "type": "string", "format": "uri" }, "approvable": { "type": "boolean" }, "approvalUnavailableReason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "companyId", "projectId", "projectName", "subjectType", "subjectId", "subjectRevision", "status", "requestedAudience", "createdAt", "videoId", "videoName", "language", "url", "approvable", "approvalUnavailableReason" ], "additionalProperties": false }, "requestId": { "type": "string" } }, "required": ["data", "requestId"], "additionalProperties": false } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "401": { "description": "Missing, expired or revoked credential.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "403": { "description": "Scope, company access or review role is insufficient.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "404": { "description": "The resource is absent or inaccessible.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "409": { "description": "Review version or idempotency conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "413": { "description": "Request body too large.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "422": { "description": "Invalid arguments.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "429": { "description": "Rate limit exceeded; wait for Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "500": { "description": "The request could not be completed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "502": { "description": "Invalid upstream response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "503": { "description": "VoiceStudio is temporarily unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } } } } }, "/reviews/{reviewId}/approve": { "post": { "operationId": "review_approve", "summary": "Valider une review", "description": "Valider une review. Permission requise : `reviews:approve`. Les accès sont limités par les droits actuels de votre compte, de votre entreprise et de vos projets. Validez uniquement la review explicitement demandée, après avoir consulté sa version actuelle. Réutilisez la même clé d’idempotence pour une requête identique.", "tags": ["reviews"], "security": [ { "apiKey": [] }, { "bearerToken": [] } ], "x-required-scope": "reviews:approve", "parameters": [ { "name": "reviewId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "expectedSubjectRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "idempotencyKey": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": ["expectedSubjectRevision", "idempotencyKey"], "additionalProperties": false } } } }, "responses": { "200": { "description": "Le résultat actuel dans le périmètre autorisé.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "status": { "type": "string", "const": "approved" }, "subjectRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": ["id", "status", "subjectRevision"], "additionalProperties": false }, "requestId": { "type": "string" } }, "required": ["data", "requestId"], "additionalProperties": false } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "401": { "description": "Missing, expired or revoked credential.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "403": { "description": "Scope, company access or review role is insufficient.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "404": { "description": "The resource is absent or inaccessible.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "409": { "description": "Review version or idempotency conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "413": { "description": "Request body too large.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "422": { "description": "Invalid arguments.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "429": { "description": "Rate limit exceeded; wait for Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "500": { "description": "The request could not be completed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "502": { "description": "Invalid upstream response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "503": { "description": "VoiceStudio is temporarily unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } } } } }, "/reviews/{reviewId}/comments": { "get": { "operationId": "comment_list", "summary": "Lister les commentaires", "description": "Lister les commentaires. Permission requise : `comments:read`. Les accès sont limités par les droits actuels de votre compte, de votre entreprise et de vos projets.", "tags": ["reviews"], "security": [ { "apiKey": [] }, { "bearerToken": [] } ], "x-required-scope": "comments:read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "reviewId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Le résultat actuel dans le périmètre autorisé.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reviewId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "body": { "type": "string" }, "status": { "type": "string" }, "startUs": { "type": "number" }, "endUs": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "createdAt": { "type": "string" }, "replies": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "body": { "type": "string" }, "kind": { "type": "string" }, "createdAt": { "type": "string" } }, "required": [ "id", "body", "kind", "createdAt" ], "additionalProperties": false } } }, "required": [ "id", "reviewId", "body", "status", "startUs", "endUs", "createdAt", "replies" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] } }, "required": ["items", "nextCursor"], "additionalProperties": false }, "requestId": { "type": "string" } }, "required": ["data", "requestId"], "additionalProperties": false } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "401": { "description": "Missing, expired or revoked credential.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "403": { "description": "Scope, company access or review role is insufficient.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "404": { "description": "The resource is absent or inaccessible.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "409": { "description": "Review version or idempotency conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "413": { "description": "Request body too large.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "422": { "description": "Invalid arguments.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "429": { "description": "Rate limit exceeded; wait for Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "500": { "description": "The request could not be completed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "502": { "description": "Invalid upstream response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "503": { "description": "VoiceStudio is temporarily unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } } } } }, "/projects/{projectId}/activity": { "get": { "operationId": "activity_list", "summary": "Consulter l’activité du projet", "description": "Consulter l’activité du projet. Permission requise : `activity:read`. Les accès sont limités par les droits actuels de votre compte, de votre entreprise et de vos projets.", "tags": ["projects"], "security": [ { "apiKey": [] }, { "bearerToken": [] } ], "x-required-scope": "activity:read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "videoId", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Le résultat actuel dans le périmètre autorisé.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "projectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "videoId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "status": { "type": "string" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "projectId", "videoId", "status", "createdAt", "updatedAt" ], "additionalProperties": false } }, "nextCursor": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] } }, "required": ["items", "nextCursor"], "additionalProperties": false }, "requestId": { "type": "string" } }, "required": ["data", "requestId"], "additionalProperties": false } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "401": { "description": "Missing, expired or revoked credential.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "403": { "description": "Scope, company access or review role is insufficient.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "404": { "description": "The resource is absent or inaccessible.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "409": { "description": "Review version or idempotency conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "413": { "description": "Request body too large.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "422": { "description": "Invalid arguments.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "429": { "description": "Rate limit exceeded; wait for Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "500": { "description": "The request could not be completed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "502": { "description": "Invalid upstream response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "503": { "description": "VoiceStudio is temporarily unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } } } } }, "/projects/{projectId}/team": { "get": { "operationId": "project_team_get", "summary": "Consulter l’équipe du projet", "description": "Consulter l’équipe du projet. Permission requise : `team:read`. Les accès sont limités par les droits actuels de votre compte, de votre entreprise et de vos projets.", "tags": ["projects"], "security": [ { "apiKey": [] }, { "bearerToken": [] } ], "x-required-scope": "team:read", "parameters": [ { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Le résultat actuel dans le périmètre autorisé.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "userId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "displayName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "role": { "type": "string" }, "isPrimary": { "type": "boolean" } }, "required": [ "id", "userId", "displayName", "role", "isPrimary" ], "additionalProperties": false } } }, "required": ["items"], "additionalProperties": false }, "requestId": { "type": "string" } }, "required": ["data", "requestId"], "additionalProperties": false } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "401": { "description": "Missing, expired or revoked credential.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "403": { "description": "Scope, company access or review role is insufficient.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "404": { "description": "The resource is absent or inaccessible.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "409": { "description": "Review version or idempotency conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "413": { "description": "Request body too large.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "422": { "description": "Invalid arguments.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "429": { "description": "Rate limit exceeded; wait for Retry-After.", "headers": { "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "500": { "description": "The request could not be completed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "502": { "description": "Invalid upstream response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } }, "503": { "description": "VoiceStudio is temporarily unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "title": { "type": "string" }, "requestId": { "type": "string" } }, "required": ["code", "requestId"] } } } } } } } } }