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
  • Hi, 

    The Perfect Match Mapping flows are detailed in the official documentation.

    When working with the Trados Cloud API, you may use the Create Perfect Match Mapping endpoint to create a new one, then Perfect Match should work automatically if conditions above are met.

    If you need to provide your own files as sources to match against, you can use this endpoint to upload your files.

    If your project is already started, and you upload new source files, that is considered a new Batch, so creating a new Perfect Match Batch Mapping associated with your project is a must.

    Can you please provide more details about your specific use-case? It will help us provide the correct assistance.

    Thank you,

    Rares.

  • 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?
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