Access tokens

Refresh the calling token: a new secret and a fresh 30-day expiry

Tokens expire after at most 30 days. Refreshing keeps the same token (id, name, and any apps an agent connected with it) but returns a new secret in token — the only time it is shown — and a new expires_at. The previous secret keeps working for 5 minutes so in-flight requests don't fail; store the new one straight away. An expired or revoked token can't refresh.

post/v1/access_token/refresh

Request

  • Base URL: https://api.topkey.io
  • URL: https://api.topkey.io/v1/access_token/refresh
  • Auth: HTTP bearer

Response

Refreshed.

Changes

No recorded changes to this operation across all 1 revision of this API.