Delete an account

DELETEhttps://api.postpress.ai/v1/accounts/{id}

Unlink the given account from your postpress workspace. This permanently removes the account and revokes any cached credentials.

Authorization

X-API-KEYstringrequired

API key from your postpress dashboard. Sent as a request header.

Path parameters

idstringrequired

The id of the account to be deleted.

Response 200 OK

On success the response confirms the account has been deleted.

objectstringAccountDeletedrequired

Example response

{
  "object": "AccountDeleted"
}

Example request

curl --request DELETE \
  --url 'https://api.postpress.ai/api/v1/accounts/acc_01HXYZ4QK3WJ8FN3M6QH7TZ8GR' \
  --header 'X-API-KEY: pp_live_...' \
  --header 'accept: application/json'

Errors

Every error response follows the same envelope:

titlestringrequired

Short error title.

detailstringoptional

Human-readable explanation.

instancestringoptional

Request identifier for support.

typestringrequired

Error type identifier, e.g. `errors/resource_not_found`.

statusnumberrequired

HTTP status code.

400 Bad Request8 types

The request can't be processed because of malformed or invalid input.

errors/invalid_parameters - One or more request parameters are invalid or missing.
errors/missing_parameters - One or more request parameters are missing.
errors/malformed_request - The given request has been rejected by the provider.
errors/content_too_large - The request payload is too large for the provider.
errors/invalid_url - The provided URL is not valid.
errors/too_many_characters - The provided content exceeds the character limit.
errors/unescaped_characters - The request path contains unescaped characters.
errors/limit_too_high - Pagination limit too high. See API reference for details.

401 Unauthorized13 types

Credentials are missing, expired, or invalid.

errors/missing_credentials - Some credentials are necessary to perform the request.
errors/multiple_sessions - LinkedIn limits multiple sessions on certain Recruiter accounts. Use the cookie connection method to avoid this.
errors/invalid_checkpoint_solution - The checkpoint resolution did not pass successfully. Retry.
errors/invalid_proxy_credentials - The provided proxy credentials are invalid.
errors/checkpoint_error - The checkpoint does not appear to be resolvable. Contact support if it persists.
errors/invalid_credentials - The provided credentials are invalid.
errors/expired_credentials - Credentials have expired. Reconnect the account.
errors/insufficient_privileges - This resource is out of your API-key scopes.
errors/disconnected_account - The account is disconnected from the provider service.
errors/disconnected_feature - The service you're trying to reach is disconnected.
errors/invalid_credentials_but_valid_account_imap - IMAP/SMTP credentials are invalid but the account is otherwise valid.
errors/expired_link - This link has expired. Generate a new one.
errors/wrong_account - The provided credentials do not match the correct account.

404 Not Found2 types

The requested account does not exist or is not accessible with this API key.

errors/resource_not_found - The requested resource was not found.
errors/invalid_resource_identifier - The provided resource identifier is invalid.

500 Internal Server Error3 types

Something went wrong on our side or with the upstream provider.

errors/unexpected_error - Something went wrong.
errors/provider_error - The provider is experiencing operational problems. Retry later.
errors/authentication_intent_error - The current authentication intent was killed after failure. Start again from the beginning.

503 Service Unavailable5 types

postpress is temporarily unable to handle the request.

errors/no_client_session - No client session is currently running.
errors/no_channel - No channel to client session.
errors/no_handler - Handler missing for that request.
errors/network_down - Network is down on the server side. Retry shortly.
errors/service_unavailable - Service temporarily unavailable. Retry later.

504 Gateway Timeout1 types

The upstream provider did not respond in time.

errors/request_timeout - Request timed out. Retry, and contact support if it persists.

Updated May 2026