Retrieve temporary data token

Overview

Retrieve the temporary token details after reserving token space. This provides the token identifier and streaming authentication needed for data exchange.

Retrieve Temporary Data Token

Endpoint: GET /data-token/retrieve-temporary-data-token/{token_space_request_id}

Authentication: Required (Authorization token obtained from the step)

Path Parameters

Parameter	Type	Required	Description
`token_space_request_id`	string	Yes	The request ID returned from reserve token space

Response

The response contains the temporary token details including the token identifier and streaming authentication credentials.

Use Case

After reserving token space, use this endpoint to retrieve the temporary token details. The response provides two paths for data exchange:

Plain text exchange: Use the token with /data-token/exchange-data-for-token for direct data upload

Stream upload: Use the streaming server details and authentication token to upload large files via authenticated streaming to {stream_server_id}:{stream_server_port}?auth={stream}

Retrieve the token details before the reservation TTL expires
Choose between direct exchange or stream upload based on data size and requirements
The stream authentication token is single-use and tied to this specific token reservation

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Example

{
    "uuid": "example_uuid",
    "createdAt": "2025-02-10T10:03:06+00:00",
    "token": "example_token",
    "stream": "auth=asjdf3kajsdkfj2123",
    "context": "example_context",
    "meta": [
        {
            "information_security_risk": {
                "classification": "top-secret",
                "label": "example-label",
                "handling": "example-handling"
            },
            "file": {
                "fileName": "exampleFileName",
                "context": "exampleContext",
                "extension": "pdf",
                "size": 123123,
                "path": "example/path"
            },
            "data": {
                "type": "cloud-drive"
            }
        }
    ]
}

🟠401401

🟠403403

🟠404404

🟠422422

Retrieve temporary data token

Overview#