Trados Business Manager
Language Weaver Connectors
Language Weaver Edge
Tridion Docs Developers
RWS User Experience
Internal Trados Ideas Community
RWS Community Internal Group
RWS Training & Certification
RWS Enterprise Technology Partners
Trados Approved Trainers
ETUG (European Trados User Group) Public Information
Nordic Tridion Docs User Group
Tridion West Coast User Group
Trados Studio Ideas
Trados GroupShare Ideas
Trados Team Ideas
Trados Team Terminology Ideas
Trados Enterprise Ideas
Trados Business Manager Ideas
RWS Appstore Ideas
Tridion Docs Ideas
Tridion Sites Ideas
Language Weaver Ideas
Language Weaver Edge Ideas
Managed Translation - Enterprise Ideas
LiveContent S1000D Ideas
Events & Webinars
To RWS Support
Detecting language please wait for.......
As part of the Tridion Sites 9.6 release, we introduce Core Service.REST as a public API for use with Content Manager.
Core Service.REST is a RESTful web service that is the preferred API for interacting with Content Manager. Core Service.REST is used by the Experience Space user interface and it provides native support for Translation Manager and External Content Library.
History moment for reasoning why REST API was born.
First of all WCF technology is not going to be actively supported for .NET Core, and .NET Full Framework 4.8 is the last one
So we needed to start thinking about migration to .NET Core.
Another reason is a plan to revamp Tridion Sites UI with a more modern, web-friendly API and REST API is a golden standard here.
This marriage introduced Tridion Sites REST API to the world and @Vladyslav Antoneko was a happy (or not J) babysitter.
We also should say thank you to @Raimond Kempees and @Likhan Siddiquee that at the current stage are active community members.
Core Service.REST provides many benefits over the WCF-based Core Service, including the following:
Probably the main question you would like to ask is how mature is that to start using.
There is no full API parity with WCF Core Service. Although take a look at Experience Space UI to get the complexity of the application you can build using a new API. Also taking into account that unlike Content Manager Explorer, which has its server-side business logic since not all data can be provided by WCF Core Service in the required format, new Experience Space gets all required data through REST API.
API coverage by area
A dropped category is related to methods that were related to legacy, like XML support.
Additionally, you can take a look at REST API coverage by following available online resource https://developers.rws.com/TridionSitesSwaggerUi/
As well there you can download specification file to generate your client https://developers.rws.com/TridionSitesSwaggerUi/openapi.json
The swagger spec is our default public documentation. Download it, pick the client generation tool, and generate the client.
Escaped URL paths for item URIs
When using item URIs as part of a URL, Core Service.REST requires that you escape the colon by replacing it with an underscore. For example, tcm:0-1-1 becomes tcm_0-1-1. This is to prevent ASP.NET validation from falsely evaluating the URLs as insecure.
Content Manager uses a single URI (Uniform Resource Identifiers) for each identifiable Content Manager object. This format presents a challenge to the Core Service.REST API wherever you want to include the URI as part of a URL path. URIs that are part of a URL path are called escaped URI in the Swagger definition, and you should use an escaped form of the URI there.
You can integrate the following code snippet into your client to transform unescaped URIs into escaped ones:
internal static class TcmUtils
internal static string EscapeUri(this string tcmUri)
=> string.IsNullOrEmpty(tcmUri) ? tcmUri : tcmUri.Replace(":", "_");
Although we are working on the possibility to re-introduce the colon symbol back to URI in future versions.
New Tridion Sites REST API can power your cross-platform application. As an example take a look at the example of building a mobile app by @Oleksii Shapovalov that was not possible to implement previously with WCF Core Service.