POST
/
contentful
/
v1
/
async
/
convert-to-xliff
Convert raw content from Contentful to XLIFF asynchronously
curl --request POST \
  --url https://eu.phrase.com/bifrost/contentful/v1/async/convert-to-xliff \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "rawFiles": [
    {
      "fileStorageId": "<string>",
      "data": {
        "locale": "AA"
      },
      "additionalData": {
        "remoteContentType": "CONTENTFUL_ENTRY_COLLECTION"
      }
    }
  ],
  "sourceLocale": "AA"
}'
{
  "requestId": "e48eda63-928c-4155-bez9-fdbsaadc15f3",
  "webHookUrl": "https://example.tld/my-webhook"
}

Authorizations

​
Authorization
string
header
required

Authorization token. The value is received by using the /authenticate endpoint. Example: OLi6jKa0VVyJqC5Ojv5LH2myTckP5N8Eb0rrWvdTOxCkJjT14E1AEj63bvzZ7CKM5

Headers

​
X-ActionId
string

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.

​
X-ResponseType
enum<string>
default:ID

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.

Available options:
ID,
OBJECT
​
X-Webhook
string

Webhook URL is used in asynchronous endpoints. Once the request is processed, the response will be sent to this URL in a POST request. If this value not sent, an ID will be returned in the response and later used to retrieve the response using a GET call on the endpoint.

Body

application/json

Response

200 - application/json

Successful operation. If X-ResponseType is set to 'ID' or no value is sent in the header, the file is saved and can be retrieved by sending a GET request to this endpoint. If X-ResponseType is set to 'OBJECT', the file is returned as a stream.

The response is of type object.