curl --request POST \
--url https://eu.phrase.com/connectors/google-drive/v1/sync/upload-raw-file \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"connectorUuid": "4282fec0-d2e9-4266-8733-3e634feb7b59",
"configuration": {},
"path": {
"pathType": "FOLDER",
"folderId": "1A2b3C4d5E6f7G8h9I0jK",
"drive": {
"driveType": "MY_DRIVE"
}
},
"storageId": "e48eda63928c4155bez9fdbsaadc15f3",
"name": "translated-report.pdf"
}
'{
"uploadUrl": "https://bifrost-host/google-drive/v1/sync/upload-raw-file/stream/550e8400-e29b-41d4-a716-446655440000",
"streamToken": "eyJhbGciOiJIUzI1NiJ9.ey...",
"expiresAt": "2026-01-16T12:00:00Z",
"maxBytes": 10857600
}""Upload raw content to Google Drive synchronously
Upload a raw binary file to Google Drive. Two delivery modes are supported via
X-Upload-Mode:
- STORAGE (default) — the request body references a file already in Phrase file
storage by
storageId. The connector pulls the bytes itself and writes them to the target Drive location. Returns the standardUploadResponseenvelope. - STREAM — initialize a two-phase streaming upload (recommended for large files).
storageIdmust be omitted. The response carries{ uploadUrl, streamToken, expiresAt, maxBytes }. The caller then PUTs the raw bytes touploadUrlwith the matchingX-Stream-Tokenheader — seePUT /google-drive/v1/sync/upload-raw-file/stream/{streamId}.
For async uploads, only STORAGE mode is supported and storageId is required.
curl --request POST \
--url https://eu.phrase.com/connectors/google-drive/v1/sync/upload-raw-file \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"connectorUuid": "4282fec0-d2e9-4266-8733-3e634feb7b59",
"configuration": {},
"path": {
"pathType": "FOLDER",
"folderId": "1A2b3C4d5E6f7G8h9I0jK",
"drive": {
"driveType": "MY_DRIVE"
}
},
"storageId": "e48eda63928c4155bez9fdbsaadc15f3",
"name": "translated-report.pdf"
}
'{
"uploadUrl": "https://bifrost-host/google-drive/v1/sync/upload-raw-file/stream/550e8400-e29b-41d4-a716-446655440000",
"streamToken": "eyJhbGciOiJIUzI1NiJ9.ey...",
"expiresAt": "2026-01-16T12:00:00Z",
"maxBytes": 10857600
}""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.
Controls how the upload payload is delivered to the connector.
- STORAGE (default): the request body references a file already in Phrase file storage by
storageId. The connector pulls the bytes itself. - STREAM: initialize a two-phase streaming upload. Phase 1 returns a relative
uploadUrl, anX-Stream-Token, and anexpiresAttimestamp. Phase 2 PUTs the raw bytes to that URL with the matchingX-Stream-Tokenand aContent-Typereflecting the file. STREAM mode is currently supported by Google Drive. Other connectors ignore the header and behave as STORAGE.
STORAGE, STREAM Body
Request payload for uploading raw content to Google Drive.
When X-Upload-Mode=STORAGE, storageId refers to content previously persisted in the connector's file storage. When X-Upload-Mode=STREAM, storageId must be omitted and the request registers a stream ticket. If X-Upload-Mode is omitted, STORAGE is used. For async uploads, storageId is required.
The path defines the Drive location where the file should be created or updated.
UUID of a configured connector that holds stored Google Drive credentials.
"b9c06f76-4a44-4d2e-8a26-3d1e4b47e123"
Connector configuration for this request. Currently unused, but reserved for future configuration flags.
{}
- Option 1
- Option 2
- Option 3
- Option 4
Show child attributes
Show child attributes
Locale code associated with the raw content being uploaded, if applicable. Optional. Use a BCP 47 or Phrase locale code (for example, "en", "de", "cs").
"en"
Storage ID of the raw file to upload to Google Drive. Must reference content previously stored in the connector's file storage.
Required when X-Upload-Mode=STORAGE. Must be omitted when X-Upload-Mode=STREAM.
"fs_5f1d2a4c-0e89-4af7-9e4b-3b4a2d1e9c01"
Name of the file to be uploaded. Used in STREAM mode.
"large_file.zip"
Size of the file in bytes. Used in STREAM mode.
10857600
Response
STREAM mode — streaming upload session initialized. The response carries uploadUrl, streamToken, expiresAt, and maxBytes. PUT the raw bytes to uploadUrl with header X-Stream-Token: <streamToken> before expiresAt.
Response for a registered streaming upload.
Publicly reachable URL for the data plane (Step 2).
One-time stream token for authentication in Step 2.
Timestamp when the stream token expires.
Maximum allowed payload size in bytes.
Was this page helpful?