• Generate JWT for your org at https://cloud.tembo.io/generate-jwt

• You will need your Tembo Organization ID and Tembo Instance ID

  • To find your org_id and instance_id read this

• You will need to use the correct URL for where your instance is deployed to. Set the URL as TEMBO_URL.

  Region	URL
  us-east-1	api.data-1.use1.tembo.io
  us-west-2	api.data-1.usw2.tembo.io
  eu-central-1	api.data-1.euc1.tembo.io
  ap-southeast-1	api.data-1.apse1.tembo.io

• Use curl to kick off the backup process

export TEMBO_TOKEN={jwt}
export TEMBO_ORG={org_id}
export TEMBO_INST={instance_id}
export TEMBO_URL={download_url}

curl -X POST "<https://$>{TEMBO_URL}/api/v1/orgs/${TEMBO_ORG}/instances/${TEMBO_INST}/backup" \\
-H 'Authorization: Bearer ${TEMBO_TOKEN}' \\

• This will return a JSON value with a UUID in the job_id field.

{"job_id":"ed7eed5e-0215-4f3d-8929-1e29e7d34373","status":"processing"}

• Get the status & download URL

export TEMBO_JOBID={job_id}

curl -X GET "<https://$>{TEMBO_URL}/api/v1/orgs/${TEMBO_ORG}/instances/${TEMBO_INST}/backup/${TEMBO_JOBID}" \\
 -H 'Authorization: Bearer ${TEMBO_TOKEN}' \\

• If the backup is still processing there will be a JSON value returned like above

{"job_id":"ed7eed5e-0215-4f3d-8929-1e29e7d34373","status":"processing"}

• Once it’s completed there will be a download URL (download_url) included with the JSON output. Keep in mind that the URL will only be valid for 5 minutes.
  • If you find the URL is expired, just run the GET request via curl again and it will issue a new download_url

{"status":"completed","job_id":"ed7eed5e-0215-4f3d-8929-1e29e7d34373","download_url":"https://...","expires_at":"2025-05-08T19:27:24.640708493+00:00"}

• You can take the URL and either use curl to download it or just simply use your browser.

curl -o file-name.tar.gz "https:..."