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.
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 PostMantis API key from the dashboard. Include as Authorization: Bearer <key>.
In: header
Path Parameters
Profile UUID
uuidResponse Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/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" }}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.