---
title: "Test platform connection health"
method: POST
path: "/test-connection/{platformId}"
tags: ["Connections"]
---

# Test platform connection health

`POST /test-connection/{platformId}`

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

## Path parameters

- `platformId` string, required

## Response `200`

Connection test result

- object
  - `platform` string
  - `platformId` string
  - `username` string
  - `status` 'ok' | 'error'
  - `message` string
  - `permissions` string[]
  - `tokenExpiresIn` string, nullable
  - `lastSuccessfulPost` string, date-time, nullable
  - `lastError` ConnectionLastError, nullable — Last connection error, or null
    - `message` string
    - `occurredAt` string, date-time

## Other responses

- `400` — Invalid platformId format
- `404` — Connection not found
- `500` — Server error

---

[API](https://skmtc.dev/publora/apis/publora-api.md) · [All operations](https://skmtc.dev/publora/apis/publora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/publora/publora-api/revisions/a1534a88d80a/schema)