Get upload users signed url for a segment.

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

{
  "url": "<string>"
}

Segments Service

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

segment-service

segments

{segment-id}

signed-url

Get upload users signed url for a segment.

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

{
  "url": "<string>"
}

Autorisations

Authorization

string

header

requis

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.

Paramètres de chemin

segment-id

string

requis

The ID of the segment.

Paramètres de requête

action

enum<string>

défaut: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.

Options disponibles:

add,

remove,

replace

Réponse

Successful Response

url

string<uri>

requis

The presigned URL.

Required string length: 1 - 2083

Delete a segment.Upload users to a segment.

⌘I