PUpublora
Connections

Test platform connection health

Changed on

Validate that a platform connection is working correctly. Returns token status, permissions, and last error if any.

post/test-connection/{platformId}

Request

  • Base URL
    https://api.publora.com/api/v1
  • Auth
    API key in header x-publora-key

Path parameters

platformIdstring required

Platform connection ID (format: platform-id)

Response

Connection test result

platformstring
platformIdstring
usernamestring nullable

Connected account username. Null for a Telegram channel without a public username.

status'ok' | 'error'
messagestring
permissionsstring[]

YouTube update #490: Google's recorded full scope URIs, without expanding broad scopes. Empty when permissionsKnown is false.

permissionsKnownboolean

YouTube only, added in #490. True when the granted scopes are recorded; false means unknown, not permission denied.

tokenExpiresInstring nullable
lastSuccessfulPoststring date-time nullable

Example response

{
  "platform": "linkedin",
  "platformId": "linkedin-Tz9W5i6ZYG",
  "username": "John Doe",
  "status": "ok",
  "message": "Connection is valid",
  "permissions": [
    "w_member_social",
    "r_basicprofile"
  ],
  "tokenExpiresIn": "29 days"
}

Changes