Skip to main content
POST
/
api
/
v1
/
workspaces
/
{workspace_id}
/
sync
/
checkpoint-upload-url
Get Checkpoint Upload Urls
curl --request POST \
  --url https://api.example.com/api/v1/workspaces/{workspace_id}/sync/checkpoint-upload-url \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "head_sha": "<string>",
  "checkpoint_id": "<string>"
}
'
{
  "head_url": "<string>",
  "checkpoint_url": "<string>",
  "head_storage_key": "<string>",
  "checkpoint_storage_key": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
workspace_id
string
required

Body

application/json

Request for presigned upload URLs for a checkpoint.

Returns 1-2 URLs:

  • head_url: Only if HEAD bundle doesn't exist yet (deduplicated by SHA)
  • checkpoint_url: Always returned for the checkpoint bundle
​
head_sha
string
required
​
checkpoint_id
string
required

Response

Successful Response

Response containing presigned upload URLs for checkpoint sync.

head_url is null if the HEAD bundle already exists (deduplicated). checkpoint_url is always provided.

​
head_url
string | null
required
​
checkpoint_url
string
required
​
head_storage_key
string | null
required
​
checkpoint_storage_key
string
required