v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-031984301.2 MB
Source File

Add Source File Version

Adds a new version of the source file in BCM or native format. More information about file formats can be found on the File formats page.

The version is added on the task represented by taskId. To successfully execute the add operation the task should already be assigned and accepted by a user. If the task is automatic, it's possible to add a source file version only when the status of task is inProgress.

The file versions added need to respect the output file type declared by the task type of the enclosing task. On the Rules for sequencing tasks correctly page from the official RWS Documentation Center, you can find out what output file type is supported by each task.

For adding a source file version using an extension task, the configuration of the task must declare the scope's value as "file".

If the file type of the new added file is different than the supported source file type, the new fileTypeSettingsId must be specified in the body or an update of file type should be performed after the add operation, using the Update Source File Properties.

The value of fileTypeSettingsId is one of the identifiers listed by the List File Type Settings endpoint.

The List File Type Settings endpoint must be called with the File Processing Configuration identifier of your project.

The File Processing Configuration of your project can be retrieved from Get Project endpoint.

The multipart parameters in the body should respect and strictly follow the order specified in our documentation.

Consider the file and project size limit when adding files.

post/tasks/{taskId}/source-files/{sourceFileId}/versions

Query parameters

fieldsstring

A comma separated list of fields to include in the response. Every value in the list should either consist of a top-level property name (excluding the items envelope for endpoints returning lists) or refer to a property of a top-level property of type object, in the following form: "toplevelpropertyname.subpropertyname". When this query parameter is omitted, default resource representations are returned (excluding fields marked as optional). The same applies to nested objects when just specifying the top-level property name, without explicitly listing sub-property names. When specifying the fields query parameter, only the specified fields are returned. The id property is always returned.

Headers

Authorizationstring required

The bearer access token provided by Auth0.

X-LC-Tenantstring required

The identifier of the account where the request is executed.

Response

Created

idstring required

The source file version identifier.

type'native' | 'bcm'
<div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;">The version type.</div>