We are currently working on an integration using the Trados Cloud Public API and have encountered difficulties while attempting to add a new version to an existing source file using the corresponding endpoint (Trados Cloud Platform API Documentation).
Summary of Attempts
We have thoroughly reviewed the documentation and tested the endpoint in multiple scenarios. Some API responses were clear and helped us correct our requests. For instance:
{
"errorCode": "taskCompleted",
"message": "Adding source file version is not allowed when the task is completed."
}
We ensured that the task is in an active state before retrying the request.
{
"errorCode": "noOwner",
"message": "The task has no owner."
}
{
"errorCode": "differentOwner",
"message": "The task has a different owner."
}
We verified and corrected the task ownership to match the user making the request.
Despite these corrections, we are now facing errors that we haven't been able to resolve. The most frequent blocking issue is the following:
{
"errorCode": "invalid",
"message": "The provided source file is not linked to given task.",
"details": [
{
"name": "sourceFileId",
"code": "invalid",
"value": "67f5403c875f471d981cf706"
}
]
}
We confirmed that the sourceFileId we are sending belongs to the project associated with the task. However, the API still rejects it.
As a test, we also tried using a target file ID, which resulted in:
{
"errorCode": "notFound",
"message": "Source file could not be found.",
"details": [
{
"name": "sourceFileId",
"code": "notFound",
"value": "67f5403f06a6263c897e8aac"
}
]
}
Finally, we could not find any option in the Trados Cloud web interface to manually add a new version to an existing source file, which makes it more difficult to validate the behavior of this endpoint.
Questions:
- What are the exact conditions for a source file to be considered "linked" to a task?
- Are there specific criteria or project/task configurations that must be met for the sourceFileId to be accepted?
- Is it possible to identify which source file ID is expected by the task through any other API endpoint?
- If so, what would be the recommended way to fetch this information?
- Is the functionality of adding a new version to a source file available through the Trados Cloud web interface? (We were unable to locate any option that performs this action manually)
Your insights would be greatly appreciated as we are keen to move forward.
.
[edited by: Paul at 8:34 PM (GMT 1) on 14 Apr 2025]
Paul Filkin | RWS Group
________________________
Design your own training!
You've done the courses and still need to go a little further, or still not clear?
Tell us what you need in our Community Solutions Hub