How to uplad Perfect Match files to the cloud?

We recently started using the Trados Cloud platform. I am trying to upload the Perfect Match files (.sdlxliff) via the REST API. Creating a project and uploading the files (via API) works, but Perfect Match is then skipped in the workflow for the files.

Unfortunately, the API reference does not provide quite as much information as it should for the whole thing to work.

I upload the files using the “Add Source File” endpoint: api.eu.cloud.trados.com/.../v1/projects/{projectId}/source-files

The question is, what exactly should the properties look like? Currently, they look like this:

var bilingualUploadProps = Newtonsoft.Json.JsonConvert.SerializeObject(new
{
  name = sdlxliffname,
  role = "reference",
  type = "sdlxliff",
  language = sourceLanguageShort
});

Are role and type correct?

Unfortunately, that doesn't seem to be enough.
Do I now have to create a “PerfectMatch Mapping” using the API? If so, how do I do that for the .sdlxliff files? By default the PerfectMatch Mapping want to have "matchingProjects" but we don't have these yet. We want to use the older sdlxliff files.

Thanks for the help.



Removed AI Suggestion
[edited by: André at 3:04 PM (GMT 0) on 26 Jan 2026]
emoji
Parents Reply
  • Hi Rares,

    thanks for your reply.

    My first attempt was to upload the sdlxliff files for PerfectMatch via the Add Source File endpoint. But I think this is the wrong way.

    After that I tried to create a Perfect Match Mapping.

    My body looks like this:

    {
      "projectId": "6970fa5993d3cd12124d7bbe",
      "matchingProjects": [
        "6970e3e69e57314fefbc15b5"
      ]
    }
    I also tried it without matchingProjects (because I dont want to use other projects for Perfect Match) but I always get this as response:
    {
        "errorCode": "invalid",
        "message": "Input validation error occurred. No further details available.",
        "details": []
    }
    The project with id 6970fa5993d3cd12124d7bbe is not started. Without mappingid I cannot use any of the other Perfect Match endpoints. So right now, I am stuck. 
    What am I doing wrong?
Children
No Data