PostMantis
API ReferenceProfiles

Disconnect a profile

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

POST
/api/v1/profiles/{id}/disconnect

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

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/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://loading/api/v1/profiles/497f6eca-6276-4993-bfeb-53cbbbba6f08/disconnect"
Empty
{  "type": "https://postmantis.com/problems/unauthorized",  "title": "Unauthorized",  "status": 401,  "detail": "Authentication required.",  "code": "unauthorized"}
{  "type": "https://postmantis.com/problems/forbidden",  "title": "Forbidden",  "status": 403,  "detail": "The authenticated API key is not allowed to perform this action.",  "code": "forbidden"}
{  "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"}

Get a single profile GET

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.

Request an upload URL POST

Starts a two-phase upload. Returns reserved artifact id and presigned PUT URL. Caller uploads bytes directly to storage, then calls `POST /uploads/complete` with artifact id. Max file size is 150 MB.