Unique identifier of custom task types. Null for default task types."
+ "description": "
Unique identifier of custom task types set in the workflow. If no custom id is set, it will return the default identifier for the custom task type."
},
"description": {
"type": "string"
@@ -31011,16 +31824,33 @@
"title": "User",
"type": "object",
"description": "User in the account.",
+ "required": [
+ "id"
+ ],
"properties": {
"id": {
"type": "string",
"description": "User account identifier."
},
+ "description": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "q6s9xj3xbon4k"
+ },
+ "description": "Description of this account user. For Service account users only."
+ },
"email": {
"type": "string",
"description": "
default
The user's email address. Retrieved only for RWS ID (formerly SDL ID) users (not service users) that the authenticated entity is authorized to read.
",
"x-default-field": true
},
+ "name": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "ie6lbdd67taaz"
+ },
+ "description": "
default
The user's name. Retrieved only for Service users (not RWS ID users) that the authenticated entity is authorized to read.
"
+ },
"firstName": {
"type": "string",
"description": "
default
The user's first name. Retrieved only for RWS ID (formerly SDL ID) users (not service users) that the authenticated entity is authorized to read.
",
@@ -31042,6 +31872,13 @@
"description": "
default
Retrieved if the authenticated entity does not have access to read the User.
",
"x-default-field": true
},
+ "account": {
+ "$ref": "#/components/schemas/account",
+ "x-stoplight": {
+ "id": "ssafm4yhc1ukc"
+ },
+ "description": "The account the user is part of."
+ },
"location": {
"$ref": "#/components/schemas/folder-v2"
},
@@ -31050,11 +31887,33 @@
"items": {
"$ref": "#/components/schemas/group"
}
+ },
+ "userType": {
+ "$ref": "#/components/schemas/user-type",
+ "x-stoplight": {
+ "id": "64l4tihoe1yh9"
+ }
+ },
+ "status": {
+ "$ref": "#/components/schemas/user-status",
+ "x-stoplight": {
+ "id": "3qbyvnakw7zbt"
+ }
+ },
+ "invitationLink": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "e8ger14ol8hdd"
+ },
+ "description": "The user's invitation link. Retrieved only for RWS ID (formerly SDL ID) users—not service users. It is available only if the user has not yet accepted the invitation (status is `inactive`)."
+ },
+ "membership": {
+ "$ref": "#/components/schemas/account-membership-type",
+ "x-stoplight": {
+ "id": "rc4aelhf9y7sc"
+ }
}
- },
- "required": [
- "id"
- ]
+ }
},
"user-request": {
"title": "User Request",
@@ -31101,6 +31960,210 @@
"id"
]
},
+ "user-create-request": {
+ "title": "User Create Request",
+ "x-stoplight": {
+ "id": "zj3b0doia6ghv"
+ },
+ "type": "object",
+ "description": "If you need to create a Service User, send only the `serviceUserDetails` object and omit the `userDetails`object, vice-versa for a normal user. ",
+ "properties": {
+ "groups": {
+ "type": "array",
+ "minItems": 1,
+ "x-stoplight": {
+ "id": "gshvzyvunxf3w"
+ },
+ "description": "The identifiers for the user groups. At least one valid group must be provided.",
+ "items": {
+ "x-stoplight": {
+ "id": "clp2f00ulox3r"
+ },
+ "type": "object",
+ "$ref": "#/components/schemas/object-id"
+ }
+ },
+ "location": {
+ "x-stoplight": {
+ "id": "5xm3lbo297i9i"
+ },
+ "type": "string",
+ "description": "The identifier of the parent folder for the account user. If it isn't mentioned, it will be created in the Root folder."
+ },
+ "serviceUserDetails": {
+ "$ref": "#/components/schemas/service-user-details",
+ "x-stoplight": {
+ "id": "0e76umgrb9pce"
+ }
+ },
+ "userDetails": {
+ "$ref": "#/components/schemas/user-details",
+ "x-stoplight": {
+ "id": "mbwjhisfya315"
+ }
+ }
+ },
+ "required": [
+ "groups"
+ ]
+ },
+ "service-user-details": {
+ "title": "Service User Details",
+ "type": "object",
+ "description": "The account details. Provide these to create a Service User.",
+ "required": [
+ "name"
+ ],
+ "properties": {
+ "name": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "ygr9y3n409i2f"
+ },
+ "description": "The Service User name.",
+ "maxLength": 100
+ },
+ "description": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "fw832rlu0cud2"
+ },
+ "description": "The Service User description.",
+ "maxLength": 200
+ }
+ }
+ },
+ "user-details": {
+ "title": "User Details",
+ "type": "object",
+ "description": "The account details. Provide these to invite a user.",
+ "required": [
+ "membership",
+ "email",
+ "firstName",
+ "lastName"
+ ],
+ "properties": {
+ "membership": {
+ "$ref": "#/components/schemas/account-membership-type",
+ "x-stoplight": {
+ "id": "gdhzaa0rfouzh"
+ }
+ },
+ "email": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "sx4ccvzavuwie"
+ },
+ "format": "email",
+ "description": "The user email."
+ },
+ "firstName": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "x4twktxsnfbzo"
+ },
+ "description": "The First Name of the account user.",
+ "maxLength": 50
+ },
+ "lastName": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "syutqsyphrou8"
+ },
+ "description": "The Last Name of the account user.",
+ "maxLength": 50
+ },
+ "invitationMessage": {
+ "type": "string",
+ "description": "A personalized message that will be included in the invitation.",
+ "maxLength": 1000
+ },
+ "sendInvitationEmail": {
+ "type": "boolean",
+ "default": true,
+ "description": "If enabled, the user will receive an email at the specified address containing the invitation details."
+ },
+ "inviteInCustomerPortal": {
+ "type": "boolean",
+ "default": false,
+ "description": "Enable this if the invited user is meant to be a Customer Reviewer or Customer Requester. When enabled, the user will always be redirected to the Customer Portal."
+ }
+ }
+ },
+ "user-update-request": {
+ "title": "User Update Request",
+ "type": "object",
+ "properties": {
+ "name": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "l9tkoiqnkwmtj"
+ },
+ "description": "The account user name. For Service users only.",
+ "maxLength": 100
+ },
+ "description": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "7pnsam33z37hf"
+ },
+ "description": "Description of this account user. For Service account users only.",
+ "maxLength": 200
+ },
+ "firstName": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "d7c847kaukk9e"
+ },
+ "description": "The First Name of this account user. For RWSID account users only.",
+ "maxLength": 50
+ },
+ "lastName": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "3dhda5zhu5wyi"
+ },
+ "description": "The Last Name of this account user. For RWSID account users only.",
+ "maxLength": 50
+ },
+ "groups": {
+ "type": "array",
+ "minItems": 1,
+ "x-stoplight": {
+ "id": "gshvzyvunxf3w"
+ },
+ "description": "The identifiers for the user groups. \r\n\r\nWhen updating a user, observe the rules of [JSON Merge Patch Semantics](https://tools.ietf.org/html/rfc7386) to prevent accidentally removing a user from groups. If provided it must contain at least one valid group id.",
+ "items": {
+ "x-stoplight": {
+ "id": "clp2f00ulox3r"
+ },
+ "type": "object",
+ "$ref": "#/components/schemas/object-id"
+ }
+ }
+ }
+ },
+ "user-type": {
+ "title": "User Type",
+ "type": "string",
+ "enum": [
+ "user",
+ "serviceUser"
+ ],
+ "description": "The type of the account user."
+ },
+ "user-status": {
+ "title": "User Status",
+ "type": "string",
+ "enum": [
+ "inactive",
+ "active",
+ "deleted",
+ "provisioned"
+ ],
+ "description": "Status of this account user."
+ },
"vendor-order": {
"title": "Vendor Order",
"type": "object",
@@ -32109,6 +33172,77 @@
]
}
}
+ },
+ "application": {
+ "title": "Application",
+ "x-stoplight": {
+ "id": "nbgnpvca77n3g"
+ },
+ "type": "object",
+ "required": [
+ "id"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "0cs3dm9xaw3hw"
+ },
+ "description": "The application identifier."
+ },
+ "name": {
+ "type": "string",
+ "description": "
default
The application name.
",
+ "x-default-field": true
+ },
+ "description": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "h5culd7q91b0i"
+ },
+ "description": "The application description."
+ },
+ "enableApiAccess": {
+ "type": "boolean",
+ "x-stoplight": {
+ "id": "o6511ct26m08q"
+ },
+ "description": "Is oAuth 2.0 API access enabled."
+ },
+ "serviceUser": {
+ "$ref": "#/components/schemas/user",
+ "x-stoplight": {
+ "id": "grtccw5o2juqa"
+ },
+ "description": "The Service User associated with this application."
+ },
+ "apiAccess": {
+ "type": "object",
+ "x-stoplight": {
+ "id": "l8uenguxfzqly"
+ },
+ "description": "API Access details.",
+ "required": [
+ "clientId"
+ ],
+ "properties": {
+ "clientId": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "8pqasr46ezn15"
+ },
+ "description": "The client identifier."
+ },
+ "clientSecret": {
+ "type": "string",
+ "x-stoplight": {
+ "id": "scia7h6wxjsp4"
+ },
+ "description": "The client secret."
+ }
+ }
+ }
+ }
}
},
"parameters": {
@@ -32465,6 +33599,15 @@
}
},
"description": "Can provide a list of humanReadableId from entries to filter by."
+ },
+ "applicationId": {
+ "name": "applicationId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "description": "The application identifier."
}
},
"headers": {
diff --git a/articles/LCPublicAPI/docs/Authentication.md b/articles/LCPublicAPI/docs/Authentication.md
index c200560..b96d83c 100644
--- a/articles/LCPublicAPI/docs/Authentication.md
+++ b/articles/LCPublicAPI/docs/Authentication.md
@@ -78,3 +78,13 @@ The application is responsible for getting a fresh token once the token is about
> [!WARNING]
> Please limit the number of requests for the Bearer token to a maximum of 16 per day. It's acceptable to exceed this limit only if you need to deploy multiple versions of your application, in a single day.
+
+### Token caching behavior
+
+Since Auth0 returns tokens with a 24-hour expiry, a well-implemented integration should typically only make a single Auth0 token request per day. However, additional token requests may occur in the following scenarios:
+
+- **Multiple application instances**: Each instance holds its own cache, so multiple instances of the same application will each request their own token.
+- **Application restarts**: Stopping or restarting the application will destroy the cache and the bearer token, resulting in a new call to Auth0 upon restart.
+
+> [!NOTE]
+> The 16 requests per day limit refers specifically to Auth0 token requests, not to API calls. You can make many more API calls (up to the [rate limits](../docs/API-rate-limits.md)) using a single cached token.
diff --git a/articles/LCPublicAPI/docs/Whats-New.md b/articles/LCPublicAPI/docs/Whats-New.md
index 9c1a644..1ab04d2 100644
--- a/articles/LCPublicAPI/docs/Whats-New.md
+++ b/articles/LCPublicAPI/docs/Whats-New.md
@@ -2,6 +2,18 @@
+## 8 December 2025
+- With this release we deliver full management capabilities for both users and applications. The new user endpoints enable [Create](../api/Public-API.v1-fv.html#/operations/CreateUser), [Update](../api/Public-API.v1-fv.html#/operations/UpdateUser), and [Delete](../api/Public-API.v1-fv.html#/operations/DeleteUser) operations, while application management now supports all CRUD operations: [Get](../api/Public-API.v1-fv.html#/operations/GetApplication), [List](../api/Public-API.v1-fv.html#/operations/ListApplications), [Create](../api/Public-API.v1-fv.html#/operations/CreateApplication), [Update](../api/Public-API.v1-fv.html#/operations/UpdateApplication), and [Delete](../api/Public-API.v1-fv.html#/operations/DeleteApplication).
+- As announced in November 2024, the `language` and `targetLanguages` fields in [Add Source File Request](../api/Public-API.v1-fv.html#/schemas/source-file-request) now use the [Language Request](../api/Public-API.v1-fv.html#/schemas/language-request) model.
+- The [Get Task](../api/Public-API.v1-fv.html#/operations/GetTask) endpoint now includes `apiInternalId` in the task type details response.
+- Added a new section on [token management](../docs/Authentication.md#token-management).
+- In early 2026, we will discontinue publishing API documentation at [Trados Cloud Platform API Documentation](https://eu.cloud.trados.com/lc/api-docs).
+ - Our API documentation is currently available in two locations:
+ - [Trados Cloud Platform API Documentation](https://eu.cloud.trados.com/lc/api-docs) - Will be discontinued in early 2026
+ - [Trados Cloud Platform API](https://developers.rws.com/languagecloud-api-docs/articles/LCPublicAPI/docs/Introduction.html) - This will remain as the official documentation site.
+ - We will communicate the exact discontinuation date once finalized.
+- We fixed various bugs.
+
## 29 October 2025
- We've added support for advanced settings for Translation Memory operations, including powerful filter expressions and field update options. See [Translation Memory Advanced Configuration](../docs/translation-memory/Translation-memory-advanced-configuration.md) for more details.
diff --git a/articles/LCPublicAPI/docs/api-clients/java/Java-Client.md b/articles/LCPublicAPI/docs/api-clients/java/Java-Client.md
index 4129c0e..4eae7ea 100644
--- a/articles/LCPublicAPI/docs/api-clients/java/Java-Client.md
+++ b/articles/LCPublicAPI/docs/api-clients/java/Java-Client.md
@@ -50,6 +50,21 @@ LanguageCloudClientProvider languageCloudClientProvider = LanguageCloudClientPro
// instantiate the client
ProjectApi projectApi = languageCloudClientProvider.getProjectClient();
```
+### Token management
+
+The `LanguageCloudClientProvider` handles token management automatically. Here are the key points:
+
+- **Automatic token handling**: You do not need to fetch or manage auth tokens directly. The `LanguageCloudClientProvider` obtains a valid token based on the provided service credentials automatically.
+- **Token caching**: Tokens are cached until expiration minus 1 minute, ensuring that tokens do not expire mid-call even if the API call takes longer. After that, the token is cleaned up from the cache, and a new one is generated automatically.
+- **Singleton cache pattern**: The token cache is implemented with a singleton pattern, so it does not make a difference if a single `LanguageCloudClientProvider` is instantiated or multiple ones—there is always a single cache per application.
+- **No need to recreate instances**: You do not need to destroy and recreate `LanguageCloudClientProvider` or any of the underlying API clients (e.g., `ProjectApi` via `languageCloudClientProvider.getProjectClient()`). One instance per application is sufficient.
+
+> [!NOTE]
+> The [16 requests per day limit](../../../docs/Authentication.md#token-management) mentioned in the Authentication documentation refers to Auth0 token requests, not API calls. Since the Java Client SDK caches tokens automatically, your application typically only makes one Auth0 token request per day (unless the application is restarted).
+
+> [!WARNING]
+> While the SDK handles token management, you still need to handle [API rate limits](../../../docs/API-rate-limits.md) and implement proper handling for HTTP 429 (Too Many Requests) responses. See the [Implementation recommendations](../../../docs/API-rate-limits.md#implementation-recommendations) for guidance.
+
#### 1. Create a new project:
diff --git a/articles/LCPublicAPI/docs/api-clients/net/NET-Client.md b/articles/LCPublicAPI/docs/api-clients/net/NET-Client.md
index 27b9888..ca6e211 100644
--- a/articles/LCPublicAPI/docs/api-clients/net/NET-Client.md
+++ b/articles/LCPublicAPI/docs/api-clients/net/NET-Client.md
@@ -128,6 +128,20 @@ var myProject = await projectClient.GetProjectAsync("YOUR_PROJECT_ID");
var myProject = await projectClient.GetProjectAsync("YOUR_PROJECT_ID", "status,quote.totalAmount");
```
+### Token management
+
+When using `GetProjectClient` with `ServiceCredentials`, the client handles token management automatically:
+
+- **Automatic token handling**: You do not need to fetch or manage auth tokens directly. The implicit authentication handler obtains a valid token based on the provided service credentials automatically.
+- **Token caching**: Tokens are cached until expiration, ensuring efficient reuse without unnecessary Auth0 requests.
+- **Single instance pattern**: To avoid creating multiple `HttpClient` instances (and thus multiple token caches), reuse the same client instance via Dependency Injection or similar mechanisms.
+
+> [!NOTE]
+> The [16 requests per day limit](../../../docs/Authentication.md#token-management) mentioned in the Authentication documentation refers to Auth0 token requests, not API calls. Since the .NET Client SDK caches tokens automatically, your application typically only makes one Auth0 token request per day (unless the application is restarted or multiple instances are running). See [Token caching behavior](../../../docs/Authentication.md#token-caching-behavior) for more details.
+
+> [!WARNING]
+> While the SDK handles token management, you still need to handle [API rate limits](../../../docs/API-rate-limits.md) and implement proper handling for HTTP 429 (Too Many Requests) responses. See the [Implementation recommendations](../../../docs/API-rate-limits.md#implementation-recommendations) for guidance.
+
## Error handling
The SDK may throw the following exceptions: