Download raw Optimizely content synchronously
Download raw content from Optimizely without any connector-side conversion. The returned
payload is Optimizely’s native representation of the content items selected by path and
configuration.
Use this when you want the original, untranslated content (e.g. to build a custom
preview, snapshot a project, or feed an analytics pipeline). For translation-ready
content, use download-xliff-file instead.
Choosing sync vs async
/sync/download-raw-fileblocks until the connector finishes. Use for small payloads and interactive callers. Subject to gateway timeouts (~60 s)./async/download-raw-filereturns immediately with arequestIdand posts the result to the URL inX-Webhookwhen ready. Required for large payloads.
Response shape (sync only) is controlled by X-ResponseType:
ID(default) — JSON{ "storageId": "..." }. The caller fetches the content from Phrase file storage later. Recommended for any non-trivial payload.OBJECT— rawapplication/octet-stream. Faster for tiny payloads, but holds the file in memory.
Authorizations
IDM-issued JWT. Obtain via the IDM authentication flow and pass as: Bearer
Headers
A logging ID of the request. It is propagated through Phrase systems, making it easier to connect logs from various services. If no ActionId is sent with a request, one will be generated by Bifrost and returned with the response.
Specify if the response should contain the processed object itself in an application/octet-stream body, or a application/json body with an ID that can be then used to retrieve the object using a /load-content endpoint. Note that for larger files (> 1 MB), it is advised to use the ID option which is also default. (ID => JSON with storageId, OBJECT => binary stream).
ID, OBJECT Body
Request body for downloading raw Optimizely content. Authenticate by supplying connectorUuid; the connector loads its stored credentials from TMS.
UUID of a connector instance configured in TMS.
"4282fec0-d2e9-4266-8733-3e634feb7b59"
Optimizely-specific behavior knobs.
Selector inside the Optimizely project — content item, folder, or ROOT.
Source locale of the content being downloaded (Optimizely locale code).
"en"
Response
OK — JSON storageId envelope (returned when X-ResponseType=ID).