Check account health

Checks whether the stored access token for a social account is still valid by calling the network's identity endpoint.

Checks whether the stored access token for a social account is still valid by calling the network's identity endpoint.

If the token is expired (401), one automatic refresh is attempted and the new tokens are persisted before re-checking.

Supported networks: X, LinkedIn, Facebook, Instagram, Threads, TikTok, YouTube, Pinterest, Bluesky, Google Business, Vimeo, Reddit

Permissions: Requires accounts:read. Access is limited by the API key creator's current organization membership and stored key ceiling. See Organization permissions.

GET
/v1/social-accounts/{id}/health

Path Parameters

id*string

Response Body

Health check result (may be healthy: false)

application/json
  1. response

Account health response

success*boolean
data*

Health status of the social account

Example Request
curl -X GET 'https://api.outstand.so/v1/social-accounts/string/health'
Example Response
{  "success": true,  "data": {    "id": "string",    "network": "string",    "healthy": true,    "checkedAt": "string",    "details": {      "property1": null,      "property2": null    },    "error": "string",    "errorCode": "unauthorized"  }}