PostMantis
API ReferenceProfiles

Get a single profile

Returns one profile by id, including connection status and publish history. Returns 404 if the profile is not visible to the caller's API-key scope.

GET
/api/v1/profiles/{id}

Returns one profile by id, including connection status and publish history. Returns 404 if the profile is not visible to the caller's API-key scope.

Authorization

BearerAuth
AuthorizationBearer <token>

PostMantis API key from the dashboard. Include as Authorization: Bearer <key>.

In: header

Path Parameters

id*string

Profile UUID

Formatuuid

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://loading/api/v1/profiles/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "data": {    "id": "4339a6bc-9cd3-455e-8f91-df8bc63f12d7",    "name": "PostMantis on X",    "provider": "x",    "status": "active",    "username": "postmantis",    "pictureUrl": "https://example.com/avatar.png",    "postsCount": 12,    "createdAt": "2026-05-05T10:00:00.000Z",    "updatedAt": "2026-05-05T10:00:00.000Z"  }}
{  "type": "https://postmantis.com/problems/unauthorized",  "title": "Unauthorized",  "status": 401,  "detail": "Authentication required.",  "code": "unauthorized"}
{  "type": "https://postmantis.com/problems/not-found",  "title": "Not found",  "status": 404,  "detail": "Resource not found.",  "code": "notFound"}
{  "type": "https://postmantis.com/problems/rate-limited",  "title": "Too many requests",  "status": 429,  "detail": "Too many requests.",  "code": "rateLimited"}

List connected profiles GET

Returns all active publishing profiles visible to the authenticated API key. Use the returned profile ids when creating posts. Results are filtered by API-key scope if one is in use.

Disconnect a profile POST

Permanently disconnects a social profile. Existing scheduled posts targeting this profile will fail at delivery time. Requires write permission.