> ## Documentation Index > Fetch the complete documentation index at: https://www.renderjuice.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Start render > Start rendering a job. ## Workflow 1. Ensure job status is `validated` (poll `GET /jobs/{id}` after starting validation) 2. Call this endpoint with your render configuration 3. Poll `GET /jobs/{id}` until status is `completed` 4. Retrieve outputs via `GET /jobs/{id}/downloads` ## Idempotency This endpoint is idempotent for duplicate start requests. If a render was already started for the job, the API returns `200 OK` with the current job payload and sets header `X-Idempotent-Replay: true`. `colorManagementPreset` is required. Use `default` in most cases, or `aces` if your project uses ACES color management. All other fields are optional and will use values detected during validation. ## OpenAPI ````yaml https://www.renderjuice.com/docs/reference/renderjuice-api-sample.json post /jobs/{id}/render openapi: 3.0.0 info: title: Renderjuice External API version: 0.0.1 description: External API surface generated from the /api/external/v1 manifest. servers: - url: https://api.renderjuice.com/api/external/v1 security: - ApiKeyAuth: [] paths: /jobs/{id}/render: post: tags: - Jobs summary: Start render description: Start rendering a job. parameters: - schema: type: string format: uuid example: 123e4567-e89b-12d3-a456-426614174000 description: Unique identifier of the job required: true description: Unique identifier (UUID) of the job name: id in: path requestBody: content: application/json: schema: type: object properties: requestedRenderConfig: type: object properties: frameRanges: type: array items: type: string notes: type: string colorManagementPreset: type: string enum: - aces - default renderEngine: type: string enum: - CYCLES - BLENDER_EEVEE - BLENDER_EEVEE_NEXT - BLENDER_WORKBENCH compositorDevice: type: string enum: - CPU - GPU computeDeviceType: type: string enum: - CUDA - OPTIX gpuCount: type: integer minimum: 0 exclusiveMinimum: true sampleCount: type: integer nullable: true minimum: 0 exclusiveMinimum: true denoisingEnabled: type: boolean denoiserType: type: string enum: - OPTIX - OPENIMAGEDENOISE resolution: type: array items: type: integer minimum: 0 exclusiveMinimum: true minItems: 2 maxItems: 2 resolutionPercentage: type: number minimum: 1 maximum: 32767 outputFormat: type: string enum: - PNG - TIFF - JPEG - AVIJPEG - AVIRAW - TARGA - TARGA_RAW - BMP - HDR - IRIS - OPEN_EXR - OPEN_EXR_MULTILAYER - FFMPEG - CINEON - DPX - JPEG2000 - WEBP outputMediaType: type: string enum: - IMAGE - MULTI_LAYER_IMAGE - VIDEO fps: type: number minimum: 0 exclusiveMinimum: true videoOutput: type: boolean description: Enable MP4 video output generation. useTiling: type: boolean tileSize: type: integer minimum: 0 exclusiveMinimum: true outputSettings: type: object properties: colorMode: type: string nullable: true enum: - BW - RGB - RGBA colorDepth: type: string nullable: true enum: - '8' - '10' - '12' - '16' - '32' exrCodec: type: string nullable: true enum: - NONE - PIZ - RLE - PXR24 - ZIP - ZIPS - B44 - B44A - DWAA - DWAB tiffCodec: type: string nullable: true enum: - NONE - DEFLATE - LZW - PACKBITS compression: type: number nullable: true quality: type: number nullable: true minimumRam: type: number minimum: 0 exclusiveMinimum: true activeCamera: type: string activeViewLayer: type: string required: - colorManagementPreset description: >- Configuration specifying how the job should be rendered, including output settings, frame ranges, and rendering options. required: - requestedRenderConfig responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/Job' security: - ApiKeyAuth: [] components: schemas: Job: type: object properties: id: type: string format: uuid example: 123e4567-e89b-12d3-a456-426614174000 description: Unique identifier of the job status: type: string enum: - created - validating - validated - debugging - rendering - finalizing - completed - failed - canceled - booting - suspended example: completed description: Current status of the job userId: type: string format: uuid description: ID of the user who created the job workspaceId: type: string format: uuid description: ID of the workspace this job belongs to rootFolderId: type: string nullable: true format: uuid description: ID of the root folder containing the job files createdAt: type: string format: date-time description: ISO 8601 timestamp when the job was created updatedAt: type: string format: date-time description: ISO 8601 timestamp when the job was last updated normalizedSeconds: type: number description: Normalized rendering time in seconds (adjusted for GPU performance) previewUrl: type: string nullable: true format: uri description: URL to a preview image of the rendered output, if available failedReason: type: object nullable: true properties: name: type: string description: Name of the error that caused the failure type: type: string description: Type or category of the error required: - name - type description: Details about why the job failed, if applicable requestedConfig: nullable: true description: Override configuration that was requested for this job finalConfig: nullable: true description: >- Final configuration that was used for rendering (may differ from requested) output: type: object properties: isDeletedForClient: type: boolean description: >- Whether the output files have been deleted from client-accessible storage required: - isDeletedForClient description: Information about the job output files isAnalysisSkipped: type: boolean description: Whether scene file analysis was skipped for this job analysisId: type: string nullable: true format: uuid description: ID of the analysis associated with this job analysis: nullable: true description: Analysis results for the scene file sceneFile: nullable: true description: Information about the scene file used for rendering required: - id - status - workspaceId - createdAt - updatedAt securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: RJ-XXX... description: >- API key authentication. Format: `Bearer RJ-XXX...`. Get your API key from the Renderjuice dashboard. ````