Get the latest export and its download URL

GET/v1/exports/latest

Authorization

AuthorizationBearer token (OAuth access token or teakapi_ API key) · headerrequired

Bearer token. Accepts either an OAuth 2.0 access token (obtained via browser sign-in; expires after 1 hour and is refreshable) or a teakapi_ API key.

Responses

200

Latest export, or null if there has never been one

jobExportJob | nullrequired

Show properties

One of:

ExportJob

idstringrequired

statusstringrequired

Allowed:pendingrunningreadyfailedcanceledexpired

stagestring | null

Allowed:snapshottingarchivingnull

processedCountnumber | null

cardCountnumber | null

filesIncludednumber | null

filesOmittednumber | null

sizeBytesnumber | null

failureClassstring | null

createdAtnumberrequired

updatedAtnumberrequired

completedAtnumber | null

expiresAtnumber | null

downloadUrlstring | nullrequired

Short-lived signed URL for the ZIP, present while the export is ready and not expired.

null

null

canStartNewbooleanrequired

nextAvailableAtnumber | nullrequired

When the next export can start, or null if one can start now

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (OAuth access token or teakapi_ API key)Remember on this deviceInclude my values in samples

Request

curl -X GET 'https://teakvault.com/api/v1/exports/latest' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch("https://teakvault.com/api/v1/exports/latest", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
  }
});

const response: Response = await fetch("https://teakvault.com/api/v1/exports/latest", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://teakvault.com/api/v1/exports/latest",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json"
    },
)

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://teakvault.com/api/v1/exports/latest", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_TOKEN")
	req.Header.Set("Accept", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

require "net/http"

uri = URI("https://teakvault.com/api/v1/exports/latest")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer YOUR_TOKEN"
request["Accept"] = "application/json"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://teakvault.com/api/v1/exports/latest',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer YOUR_TOKEN',
    'Accept: application/json',
  ],
]);

$response = curl_exec($curl);

Response

{
  "job": {
    "id": "string",
    "status": "pending",
    "stage": "snapshotting",
    "processedCount": 0,
    "cardCount": 0,
    "filesIncluded": 0,
    "filesOmitted": 0,
    "sizeBytes": 0,
    "failureClass": "string",
    "createdAt": 0,
    "updatedAt": 0,
    "completedAt": 0,
    "expiresAt": 0,
    "downloadUrl": "string"
  },
  "canStartNew": true,
  "nextAvailableAt": 0
}