---
title: "Disconnect account"
method: DELETE
path: "/v1/accounts/{id}"
---

# Disconnect account

`DELETE /v1/accounts/{id}`

## Request

- Base URL: `https://postonce.to/api/public`
- URL: `https://postonce.to/api/public/v1/accounts/{id}`
- Auth: HTTP bearer

Removes PostOnce access to an owned social account. The account is disconnected with its credentials cleared (the response returns deleted=false and disconnected=true); its posts and history are kept, and reconnecting the same account restores posting. Farcaster, Nostr, and Telegram records are also disabled. Farcaster signer revocation requires a separate provider step; Nostr remote-signer logout is best effort; @PostOnceBot leaves a Telegram channel on a best-effort basis when no other PostOnce account uses it. This does not delete published social content.

## Path parameters

- `id` string, required

## Response `200`

Account disconnected.

- DeleteResponse
  - `data` object
    - `deleted` boolean
    - `id` string
    - `provider_revocation_required` boolean, nullable: True when local PostOnce access is removed but the provider requires the user to revoke the remote signer separately.
    - `provider_revocation_url` string, nullable
    - `message` string, nullable

## Other responses

- `401`: Missing, invalid, revoked, or expired API key.
- `404`: Account not found.

---

[API](https://skmtc.dev/postonce/apis/postonce-public-api.md) · [All operations](https://skmtc.dev/postonce/apis/postonce-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postonce/apis/postonce-public-api/revisions/ca9dca40a543?raw)