Skip to main content
POST
Create data source upload URL

Authorizations

Authorization
string
header
required

Access token issued by gs.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.

Team-SID
string
header
required

Team scope for tokens that do not carry one. Ignored when the token already names a team.

Body

application/json

Request body of create_data_source_upload_url.

playtable_sid
string
required

Target table (pt_tb_…) the draft feeds; checked at the mint, a missing or foreign one is 422 relation_not_found before any bytes travel.

Required string length: 18
Pattern: ^pt_tb_
object_type
enum<string>

What the rows become: people (default) | company; import_data_source may still override it.

Available options:
people,
company
mode
enum<string>

What the import does with them: create (default) | update; import_data_source may still override it.

Available options:
create,
update
name
string

The draft's name; default: the file name the PUT declares in Content-Disposition, else upload.csv.

Required string length: 1 - 255
tag_sids
string[]

Tags every promoted row gets (cr_tg_…, must exist in the team; checked at the mint).

Required string length: 18
Pattern: ^cr_tg_
qualify
object | null

The source gate, Check on save: {on, criterion}; null or absent = no check. import_data_source may still set it.

on_duplicate
enum<string>

skip (default) | move: what a person already in another table does.

Available options:
skip,
move
add_tags_to_duplicate
boolean

Merge tag_sids onto a matched duplicate; default false.

Response

action success envelope.

success
enum<boolean>
required
Available options:
true
operation
enum<string>
required
Available options:
action
action
string
required

kebab-case verb; matches the route segment.

item
any
required
result
object
required
meta
object
required