WorldServer Developers forum - Recent Threads

TD missing in API created project package

Christopher Maier — Mon, 02 Mar 2026 11:48:34 GMT

Hello,

I tried to create a project package via the Worldserver REST API in SoapUI. The package was created, but it seems like the TD is not being added to the package. Everything else (including the TM) is there.

In the API documentation I found a value called "tdFilterId" (https://docs.rws.com/de-DE/worldserver-11.7-developer-documentation-860026/export-tasks-645015) Is it necessary to set this value in order to add the TD to the package?

If so, what would be the best way to find out which tdFilterId should be used?

Thanks in advance for your help!

Strange answer oncreating attachment through the REST API

Tamas Meszaros — Tue, 13 Jan 2026 12:32:16 GMT

Hi,

We try to create new attachments at the client (WS 11.8.4.38), but the response from the WS server is invalid. The same operation in our testenvironment (11.8.4.46) works properly.

Request: Method: POST, RequestUri: 'xxxxxx/.../1089, Version: 1.1, Content:

Headers:
{
Accept: application/json
Accept: application/xml
Accept: text/xml
Connection: Keep-Alive
Accept-Encoding: gzip
Accept-Encoding: deflate
Content-Type: multipart/form-data; boundary=-----------------------------xxxxxxxxxxxxxxxxxx
Content-Length: 236435
}
-------------------------------xxxxxxxxxxxxxxxxxx
Content-Disposition: form-data; name=file; filename=a.jpg; filename*=utf-8''a.jpg
Content-Type: application/octet-stream
xxxxxxxxxxxx
-------------------------------xxxxxxxxxxxxxxxxxx--

And the response is this:

StatusCode: 200, ReasonPhrase: '', Version: 1.1, Content: System.Net.Http.HttpConnectionResponseContent, Headers:

{
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
x-permitted-cross-domain-policies: none
Strict-Transport-Security: max-age=7890000 [; includeSubDomains]
Vary: accept-encoding
Transfer-Encoding: chunked
Date: Fri, 12 Dec 2025 10:23:14 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Encoding: gzip
Content-Type: application/json; charset=UTF-8
}
_O 0ſK Q;` -c tL . Y:ڹ Rgf N_} ޓs w I z R Z ]d B 5 B n ľ ֢ \ @ C j z N 4 e-h WV iĊ*M{ߵ 5 䆟; nX:45 Ռ(^ʈ Y#k84L Lۀ`o Q
pT 2
C[ $ b A _ K\Z ( ʜ $ s ׋U 'j ԩϫOc f^ c * n
S 8 yy\y Xą ^ dF I O6 8 щ sv p Nѣ 8O h

So even though the status code is 200 (Success) and the response header says that the response should contain application/json (corresponds to the documentation), it is some binary content that cannot be processed.

Is this maybe a known bug in 11.8.4.38 and has been fixed in .46 ? Or how can we fix / find out the reason for this response?

thank you,

Tamas

RE: Strange answer oncreating attachment through the REST API

Tamas Meszaros — Tue, 24 Feb 2026 13:24:31 GMT

My fault, have not noticed that WS is responding with gzip, and also expressed this in the response header.

REST API to get list of projects having particular Attribute value

Tarakeswar Dubey — Mon, 01 Dec 2025 12:23:25 GMT

There is a project level custom attribute. I am looking for a REST API end point where I can provide this custom attribute and its value in the request body and the response should list down all those projects having this attribute value.

The "Change task assignees" World Server REST API call is failing.

Tarakeswar Dubey — Wed, 03 Sep 2025 11:08:10 GMT

The "Change task assignees" REST API call is not working.

Following are the details:
End-point: xxx.yyy.com/.../changeAssignees
Payload: [{"id":6457980,"assignedRoleIds":[8073],"taskStepIds":[243608648]}]

Response:
{
"status": "ERROR",
"response": [
{
"status": "ERROR",
"errors": [
{
"code": 404,
"type": "NOT_FOUND",
"message": "Resource TASK_STEP ([243608648]) not found."
}
],
"id": 6457980
}
]
}

Note: The TASK_STEP_ID 243608648 exists in the database for the TASK 6457980

Relevant Database record from tasksteps table:
243608648 6457980 304915 1 02-09-25 2 Linguistic Review Human

I referred following World Server REST API document
docs.rws.com/.../change-task-assignees-645027

RE: The "Change task assignees" World Server REST API call is failing.

Tarakeswar Dubey — Thu, 04 Sep 2025 05:36:26 GMT

Thank you so much Adrian. Your response make sense and it works fine,

RE: The "Change task assignees" World Server REST API call is failing.

Adrian Manea — Wed, 03 Sep 2025 17:19:18 GMT

Hi Tarakeswar,

The taskStepIds are actually workflow steps that you need to extract from the database (column WORKFLOWSTEPID).

Also, the taskStepId parameter is optional, and it's easier not to include it, because the system already knows what taskStepId to include based on taskId.

Based on your example you can use this payload: [{"id":6457980,"assignedRoleIds":[8073]}]

RE: Is it possible to tell the current workflow step in a World Server project via API?

Anuj Bhatia — Fri, 22 Aug 2025 13:40:45 GMT

Maybe you can use either of the following:

For all tasks in a project:
- GET /ws-api/v2/projectGroups/search?fields=projects(tasks(currentTaskStep(name,workflowTransitions)))
For a specific task:
- GET /ws-api/v2/tasks/{taskId}?fields=currentTaskStep

Hope this helps.

Is it possible to tell the current workflow step in a World Server project via API?

Cecilia Nistal — Tue, 19 Aug 2025 15:25:02 GMT

We would like to use the REST API to know what workflow step a particular project is at.

Is there a way to Search projects modified in the last X minutes/hours via API?

Cecilia Nistal — Tue, 19 Aug 2025 15:19:51 GMT

We would like to periodically get World Server project information via API to feed our dashboards, however, we would only like to get information about the projects that have been recently modified. While there is a created date property in the project response/filters, we don't see one for last modified date, is this possible?

RE: Is there a way to Search projects modified in the last X minutes/hours via API?

Anuj Bhatia — Fri, 22 Aug 2025 13:35:43 GMT

We had a similar use case and couldn't find a way to query by recently modified date. We ended up using the task history as a proxy for the modification date.

Get projects via /ws-api/v2/projectGroups/search
For each project's tasks, call /ws-api/v1/taskHistory
Use the latest task history date as your modification date

But this requires additional API calls per project, so it performance may not be feasible for you.

ImportKit request under the ExchangeWSExportImportManager wsdl always fails

Joseph Hellebusch — Wed, 23 Apr 2025 13:24:21 GMT

We are developing a python script to make an Upload request to the SOAP API using:

<wsdl:message name="importKit2Request">

<wsdl:part name="token" type="xsd:string"> </wsdl:part>

<wsdl:part name="attachedFile" type="xsd:string"> </wsdl:part>

</wsdl:message>

when we call:

importKit2(token=WSTOKEN, attachedFile=file_contents)

if file_contents points to an xliff or zip on the server such as "c:\temp\tasks_250199_-_MyCompany-Test_-_testing_5_126627_ja_JP_xliff.zip" the function creates an upload file but that file is always blank and we get the error "java.lang.RuntimeException: Too many/few attachments sent [0] Please limit to 1".

Even when we call the function using a literal string of the contents of the xliff or a bytestream/octet encoded file the procedure give the too many/few error or a "com.idiominc.ws.WSRuntimeException: The filename, directory name, or volume label syntax is incorrect (covers java.io.IOException: The filename, directory name, or volume label syntax is incorrect)" error.

I need to know how the "Attached file" need to be referenced or the data type needed for it. It is clear that the system has access to the file but can't properly create the upload file for some reason.

Error Making Parallel Calls for TM Insert – StorageResourceBusyException

Damanjyot Singh — Fri, 31 Jan 2025 09:06:05 GMT

Description:
I have developed a custom servlet that updates or inserts entries into a Translation Memory (TM).

Issue:
When two concurrent requests were made to the servlet, both attempting to update the same TM, one of the requests failed with the following error, halting execution:

com.idiominc.ws.sql.ConnectionLease: non SQLException caught in storage


com.idiominc.ws.storage.StorageResourceBusyException: A required SQL resource was unavailable. Please, retry the operation later.

Below are the lines of code responsible for updating the TM:

// Fetch the TM
WSTm tmToUpdate = wsContext.getTmManager().getTm(TmName);

// Insert or update entry

tmEntry = tmToUpdate.insert(coreString, humanTranslatedString, sourceLanguage, targetLanguage);

The error specifically occurred at the insert operation (tmToUpdate.insert(...)).

Environment:

WorldServer Version: 11.7.3.328

Question:

Is there a recommended way to handle concurrent inserts into the same TM to avoid this error?
Does WorldServer provide any locking mechanisms or best practices for handling parallel TM updates?

Any insights or recommendations would be greatly appreciated.

Mismatch between API response and UI (re Tasks and Projects)

Cecilia Nistal — Mon, 16 Dec 2024 14:40:59 GMT

When listing project via the endpoint Get projects (<protocol>://<ws-host>:<ws-port>/ws-api/v2/projects?token=<sessionId>) we receive 9 records but in the UI we can see only 8 (see sample images below)

In Postman, there are some project IDs not displayed on the UI

When selecting an ID of any project in the UI (1069 for example) and try to get the tasks that are comprised in said project, we receive an empty body as response while on the UI we can clearly see that there are two active tasks

Could you help us understand this mismatch? Our goal is to get all tasks within a project for a same language direction via API.

RE: Mismatch between API response and UI (re Tasks and Projects)

Anca Gicoveanu — Mon, 16 Dec 2024 19:27:49 GMT

Hi Cecilia Nistal ,

For the get projects API call, you might have some information in the database that was not yet cleaned up by the Garbage Collector. Run the Garbage Collector cleaners and check again if you have the same results as in the UI. If you still face the same issue after the cleaners ran, you can further investigate the additional project returned by the API for more details and gather more information about it: is the project an old one, does it have any tasks assigned to it, does it have a completion date, etc.

For the get tasks API call, WorldServer does not provide a GET method with a search function based on projectId. If you want to search in tasks by different criteria, you should use this API call: https://docs.rws.com/en-US/worldserver-11.8-developer-documentation-994354/search-for-tasks-645242

The call should look like this:

However, if your purpose is to get all the tasks within a project for a language direction, I think it is better to use the get projects API call, which will return the tasks of the projects as well. You can then filter the model based on your required languages to reduce results:

https://docs.rws.com/en-US/worldserver-11.8-developer-documentation-994354/get-information-about-a-specific-project-642529

Or you can use the search projects API call: https://docs.rws.com/en-US/worldserver-11.8-developer-documentation-994354/search-for-projects-652273

Thank you,

Anca

RE: Search Projects endpoint returns 500 error

Adrian Manea — Mon, 09 Sep 2024 13:04:48 GMT

Hi Cecilia,

These are examples that you can paste in request body:

//all projects with name containing the string "test"

{"operator":"and","filters":[{"field":"projects(name)","value":"test","operator":"like"}]}

//all projects with name containing the string "test" that have between 2 and 5 tasks

{"operator":"and","filters":[{"field":"projects(name)","value":"test","operator":"like"},{"field":"projects(totalTasks)","value":"2,5","operator":"between"}]}

If you want the result to display only the project ID and project name, you can specify only those fields in the URL (http://hostname/ws-api/v2/projectGroups/search?fields=id,name)

Alternatively, if you want to identify various filtering options, you can:

log in the WSXI UI
open the browser developer tools (F12), go to network tab
in WorldServer Projects page open the filters menu (screenshot #1 below)
apply your filtering parameters
in developer tools select the search API call and go to Payload tab
click on "View Source" near Request Payload (screenshot #2)

screenshot #1:

screenshot #2:

Best regards,

Adrian

Search Projects endpoint returns 500 error

Cecilia Nistal — Wed, 04 Sep 2024 14:12:21 GMT

Hello! When trying to use the search projects endpoint for the API, we get a 500 "Unsupported search request filter" error. The same happens if we delete the filter. Any ideas what we may be doing wrong?

/tasks/import and /tasks/export endpoints always stay in "STILL IN PROGRESS" status

Cecilia Nistal — Wed, 04 Sep 2024 14:29:06 GMT

/tasks/import and /tasks/export never finish and always stay in "STILL IN PROGRESS" status (same for UI and API). Is there a prerequisite for using these that we may be missing?

RE: /tasks/import and /tasks/export endpoints always stay in "STILL IN PROGRESS" status

Adrian Manea — Thu, 05 Sep 2024 17:14:31 GMT

Hi Cecilia,

The export completion time is depending on the package size and also the availability of background engines.

The fact that it never completes could indicate issues with the environment, or the allocated number of background.

It is relatively easy to check: in the UI, go to Assignment -> Background jobs; in the dropdown select "all active jobs" and see if other tasks are being processed (if yes, approximate how many).

The task you want to export should be present in that list with the Job ID like in the API call (example from your screenshot: 1049).

Also check "all completed and cancelled jobs" if there are tasks with Failed status, and see the execution log for details.

If the list is of items to be processed is too long, but you notice that some of them advance, then you'll probably want to increase the number of background engines.

If none of the items is processed, there is a possibility that no background engine is configured for the WSXI UI. The documentation here: https://docs.rws.com/binary/975503/1067030/worldserver-11-8-user-documentation/worldserver-v11-8-0-install-guide should be useful (page 51 - worth checking even if it's not a clustered environment)

Best regards,

Adrian

RE: How to match segments between custom automatic actions?

Anca Gicoveanu — Tue, 16 Jul 2024 14:54:33 GMT

Hi Robert,

I am sorry for my late response on this, it was a quite busy month.

Most probably you already moved on with this approach, which I think will work for your needs.

You can also log/check the correctness of your code by following the segment.getIdProperty() value for segments.

I also suggest to make a few tests with split and merged segments to validate your code for this actions as well.

Hope your implementation works as expected, let me know otherwise.

Thank you,

Anca

How to match segments between custom automatic actions?

Robert Minasyan — Mon, 03 Jun 2024 15:53:35 GMT

Hi! I am implementing some automatic actions using WorldServer SDK 11.7.3 and I need to create a mapping between segments and other entities to use across automatic actions.

I was thinking of using indices of the segments as their identifiers. Is their order guaranteed to be the same in different automatic actions? And is there another way to achieve this if not?

The code looks something like this:

```

WSAssetTranslation translation = assetTask.getAssetTranslation();

Iterator segments = translation.textSegmentIterator();

int index = 0;

while (segments.hasNext()) {

WSTextSegmentTranslation segment = (WSTextSegmentTranslation) segments.next();

// do stuff with segment <index> which is supposedly the same in both automatic actions

index++;

}

```

SOAP API TM lookups not returning correct results

Joseph Hellebusch — Mon, 01 Apr 2024 16:24:46 GMT

Hi,

We are trying to do some TM look ups using the SOAP API and are getting some odd results.

For example when we are calling exactLookupByTarget_ with information for the TM, search text, source and target we will often get back a blank array "[ ]" for searches we can confirm in the UI that have 100% matches. Then when we perform the same search using the more general lookupByTarget_ we get results but with match scores that do not make much sense.

Is there a way to force these calls to behave closer to the UI search matching?

For example on a call searching for "Beschreibung" in the target German for the call "lookupByTarget_(token=Token, wSTm=TMName, searchText='Beschreibung', sourceLanguage='English (United States)', targetLanguage='German (Germany)')" along with a lot of other information we get:

[{'token': '*************', 'id': None, 'displayString': None, 'target': 'Beschreibung', "rawTarget': 'Beschreibung',
'source': 'Description',
'tmDatabaseId': ####,
'score': 25.0,
'isRepaired': False,
'rawSource': 'Description',
'isReversedHit': False}

and the call with the same TM and search information for exactLookupByTarget_ returns:

[]

What I can't tell is why 1. the match score is only 25.0 on the look up call and why the text being exact does not register over the SOAP call.

Any advice on how to resolve would be appreciated.

RE: SOAP API TM lookups not returning correct results

Joseph Hellebusch — Tue, 16 Apr 2024 19:54:29 GMT

Hi Anca,

Thank you for your help. It does seem like this is returning more accurate results that are closer to what we would see from the UI lookups.

We will test out and see if we have any other issues but this solves the main problem at least!

Best,

Joe

RE: SOAP API TM lookups not returning correct results

Anca Gicoveanu — Tue, 16 Apr 2024 15:24:10 GMT

Hi Joseph,

The SOAP call lookupSubstringByTarget_ can be used to get similar results with the UI (the results for Translation Memory search page): search type standard, search in target, minimum score equal with the one returned in UI.

Example of the parameters:

<searchText xsi:type="xsd:string">Genauigkeit</searchText>

<sourceLanguage xsi:type="xsd:string">English (United Kingdom)</sourceLanguage>

<targetLanguage xsi:type="xsd:string">German (Germany)</targetLanguage>

Please try it out and let me know if this works for you.

Thank you,

Anca

Creating a project in Trados studio from the WorldServer (wsxz) package via the Trados studio automation API

Vladimír Oberreiter — Wed, 20 Mar 2024 11:39:53 GMT

Hi, we are using Trados studio and now we have a lot of packages from WorldServer. We use the Trados studio automation API to automate our work with Trados studio.

I would like to create a Trados studio project from a WorldServer .wsxz package and then create a return package for WorldServer via the Trados studio automation API.

Are there any plugins for Trados studio automation API, which can I use for it? If no. Are there any other options to automate this?

Thanks a lot.

Best regards, Vladimir