[BETA] Get upload users signed url for a segment.

Retrieve a signed URL for uploading a segment user file.

This endpoint returns a pre-signed URL that allows you to securely upload a segment user file.

File requirements:

• The file must be in plain text format (“.txt”).
• It should not contain headers.
• Each line must represent a single opaque user ID.

The signed URL can be used to upload the file directly via an HTTP PUT request. For more information, see the AWS documentation on uploading objects using presigned URLs.

Returns

dict: A dictionary containing the signed URL and any additional metadata required for upload.

GET /public/v1/segment-service/segments/{segment-id}/signed-url

[BETA] Get upload users signed url for a segment.

cURL

curl --request GET \
  --url https://api.topsort.com/public/v1/segment-service/segments/{segment-id}/signed-url \
  --header 'Authorization: Bearer <token>'

200

{
  "url": "<string>"
}

Authorizations

Authorization · string · header · required

A valid API key generated in Topsort's UI. Use the TSE API key if calling auctions or events API, otherwise use the TSC API key.

Path Parameters

segment-id · string · required

The ID of the segment.

Query Parameters

action · enum<string> · default: add

The action to perform on the segment. Possible values are 'add', 'remove', or 'replace'. The 'replace' action will first remove all existing users from the segment before adding the new ones.

Available options: add, remove, replace

Response

200

application/json

Successful Response

url · string<uri> · required

The presigned URL.

Required string length: 1 - 2083