Documentation menu

Refresh tokens

Refresh the OAuth tokens of every connection in a profile.

POSThttps://app.tryadeli.com/api/v1/profiles/{profileId}/accounts/refresh

AuthorizationBearer <API key>How keys work

Request

curl --fail-with-body -X POST "https://app.tryadeli.com/api/v1/profiles/00000000-0000-4000-8000-000000000001/accounts/refresh" \
  -H "Authorization: Bearer $ADELI_API_KEY"

Response

{
  "status": "partial",
  "accounts": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "accountId": "00000000-0000-0000-0000-000000000000",
      "profileId": "00000000-0000-4000-8000-000000000001",
      "platform": "instagram",
      "refreshed": true,
      "expiresAt": "2026-11-07T12:00:00.000Z"
    }
  ],
  "errors": [
    {
      "platform": "tiktok",
      "accountId": "00000000-0000-0000-0000-000000000001",
      "code": "connection_expired",
      "message": "TikTok requires reconnection"
    }
  ]
}

Attempts an OAuth token refresh for every Instagram, TikTok, Facebook, and YouTube connection in the profile. For YouTube it also re-reads the channel's title, avatar, and counts. Takes no body. Each account appears in the response only after its new token and expiry have been written, so a success here means the credential is durable, not merely fetched.

This response is not a list of accounts

It uses the aggregate envelope with the accounts key, but the elements are a different shape — refresh results, not account records. Code that reuses an account parser here will not find displayName or connectionStatus.

Path parameters

profileIduuidRequired: A profile in your organization. Any other value returns 404 profile_not_found.

Per-account error codes: provider_not_configured, connection_expired, account_not_found, provider_error.

Errors — 401 unauthorized, 400 invalid_request, 404 profile_not_found, 502 database_error.