integrations

Refresh the OAuth access token for a saved integration host-side and persist the new tokens on the connection.

Refresh the OAuth access token for a saved integration host-side and persist the new tokens on the connection. Connections whose provider issued neither a refresh token nor an access-token expiry at connect (for example GitHub OAuth Apps with token expiration off) are skipped with refreshed: false instead of failing. Returns metadata only — token values never appear in the output. createAuthenticatedFetch refreshes through this path for every integration; it is the only refresh path for platform (built-in) integrations, whose shared client secret stays server-side.

Org permission: integration:use.

post/v1/integrations/{name}/refresh

Request

  • Base URL: https://api.kody.codes
  • URL: https://api.kody.codes/v1/integrations/{name}/refresh
  • Auth: HTTP bearer

Path parameters

namestring required

Integration (connection) name whose tokens should refresh.

Request body

object required

Response

Success.

oktrue required
refreshedboolean required
skippedReason'refresh_not_applicable' nullable required
refreshedAtstring nullable required
refreshTokenRotatedboolean required

Changes

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