Docs menu: Keys

Keys

The API key a request is made with.

On this page

Revoke the key making this request

Revoke the key making this request #

DELETE /api/v1/api_keys/current

Revokes the API key this request is authenticated with, at once: every later request with it is 401. Any key may revoke itself, a restricted store key included, so an integration can give up its key when it is disconnected or uninstalled. A repeat with the same key is 401, so treat a 401 on a retried revoke as done.

Bearer API key

Request

curl

curl -X DELETE 'https://tallio.dev/api/v1/api_keys/current' \
  -H "Authorization: Bearer $TALLIO_API_KEY"

TypeScript SDK

import { createTallioClient, unwrap } from "@tallio/sdk";

const tallio = createTallioClient({
  apiKey: process.env.TALLIO_API_KEY!,
  baseUrl: "https://tallio.dev",
});

const result = await unwrap(tallio.http.DELETE("/api/v1/api_keys/current"));

Responses
Status	Description
`204`	The key is revoked.
4XX, 5XX	An error: see Errors below.

Response headers

x-request-idstring: The request's correlation id; quote it when reporting a problem. One of: req_ plus a uuid (Tallio made it), client: plus the x-request-id you sent (8-128 of A-Z a-z 0-9 . _ : -), or the hosting platform's id.
With every response
Show patternHide pattern
^(?:req_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|client:[A-Za-z0-9._:-]{8,128}|[A-Za-z0-9._-]{1,16}::[A-Za-z0-9._:-]{6,110})$
ratelimit-limitinteger: Requests allowed in the current window for the bucket this request counted against.
With 204, 429 · At least 1
ratelimit-remaininginteger: Requests left in the current window; 0 means the next one is refused until the window resets.
With 204, 429 · At least 0
ratelimit-resetinteger: Seconds until the current window resets.
With 204, 429 · At least 0
www-authenticatestring: The bearer challenge: send a vendor secret key as Authorization: Bearer <key>.
With 401 · Always Bearer realm="tallio"
retry-afterinteger: Seconds to wait before retrying a request refused with 429 rate_limited.
With 429 · At least 1

Errors
Code	Status	Retryable	Meaning
`unauthorized`	401	No	Authentication is required.
`vendor_suspended`	403	No	This vendor's access to Tallio is suspended. Its owner can contact Tallio to restore it.
`rate_limited`	429	Yes	A rate limit was reached. Retry later.
`internal_error`	500	No	An unexpected server error occurred.