Remove Twitter bookmark API to unsave a tweet by ID

{
  "object": "x_write_action",
  "id": "12345",
  "writeActionId": "12345",
  "action": "unbookmark",
  "status": "success",
  "terminal": true,
  "retryable": false,
  "safeToRetry": false,
  "statusUrl": "/api/v1/x/write-actions/12345",
  "pollAfterMs": null
}

{
  "object": "x_write_action",
  "id": "12346",
  "writeActionId": "12346",
  "action": "unbookmark",
  "status": "dispatching",
  "terminal": false,
  "retryable": false,
  "safeToRetry": false,
  "statusUrl": "/api/v1/x/write-actions/12346",
  "pollAfterMs": 2000
}

{
  "error": "missing_idempotency_key",
  "message": "Idempotency-Key is required. Generate one unique key for this write.",
  "charged": false,
  "chargedCredits": "0",
  "retryable": false,
  "safeToRetry": true
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "api_key_paused",
  "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again."
}

{
  "error": "account_not_found",
  "message": "X account not found. Connect it first at /dashboard/x-accounts."
}

{
  "error": "idempotency_conflict",
  "message": "Idempotency-Key was already used with a different request.",
  "charged": false,
  "chargedCredits": "0",
  "retryable": false,
  "safeToRetry": true
}

{
  "error": "x_rejected",
  "message": "X rejected this request. Check what you sent & the account on x.com before you try again."
}

{
  "error": "x_rate_limited",
  "message": "X rate limited this account. Try again in about 15 minutes. Send fewer requests from this account."
}

{
  "error": "x_write_failed",
  "message": "Write action failed unexpectedly. Contact support if this persists."
}

{
  "error": "write_tracking_unavailable",
  "message": "Write tracking unavailable. Try again.",
  "charged": false,
  "chargedCredits": "0",
  "retryable": true,
  "safeToRetry": true
}

DELETE

tweets

{id}

bookmark

Remove Twitter bookmark API to unsave a tweet by ID

curl --request DELETE \
  --url https://xquik.com/api/v1/x/tweets/{id}/bookmark \
  --header 'Content-Type: <content-type>' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "account": "<string>"
}
'

import requests

url = "https://xquik.com/api/v1/x/tweets/{id}/bookmark"

payload = { "account": "<string>" }
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Content-Type": "<content-type>"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {'Idempotency-Key': '<idempotency-key>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({account: '<string>'})
};

fetch('https://xquik.com/api/v1/x/tweets/{id}/bookmark', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/tweets/{id}/bookmark"

	payload := strings.NewReader("{\n  \"account\": \"<string>\"\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

10 credits per call · All plans from $0.00012/credit

Each request removes 1 bookmark by Tweet ID. Each request uses 1 connected X account. It never deletes the tweet or changes another account’s bookmarks. Create a unique Idempotency-Key for the intended removal. Store the returned write action and poll statusUrl when needed.

curl -X DELETE https://xquik.com/api/v1/x/tweets/1895432178065391234/bookmark \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Idempotency-Key: unbookmark-1895432178065391234" \
  -H "Content-Type: application/json" \
  -d '{"account":"elonmusk"}' | jq '{
    status,
    terminal,
    safe_to_retry: .safeToRetry,
    write_action_id: .id,
    requested_tweet_id: "1895432178065391234",
    confirmed_tweet_id: (.result.id // .targetId),
    charged_credits: .billing.chargedCredits,
    poll_path: (if .terminal then null else .statusUrl end)
  }'

const tweetId = "1895432178065391234";
const response = await fetch(`https://xquik.com/api/v1/x/tweets/${tweetId}/bookmark`, {
  method: "DELETE",
  headers: {
    "x-api-key": "xq_YOUR_KEY_HERE",
    "Idempotency-Key": "unbookmark-1895432178065391234",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ account: "elonmusk" }),
});
const result = await response.json();
if (!response.ok) {
  throw new Error(JSON.stringify(result));
}
const removalRecord = {
  status: result.status,
  terminal: result.terminal,
  safe_to_retry: result.safeToRetry,
  write_action_id: result.id,
  requested_tweet_id: tweetId,
  confirmed_tweet_id: result.result?.id ?? result.targetId ?? null,
  charged_credits: result.billing.chargedCredits,
  poll_path: result.terminal ? null : result.statusUrl,
};
process.stdout.write(`${JSON.stringify(removalRecord)}\n`);

import json
import requests

tweet_id = "1895432178065391234"
response = requests.delete(
    f"https://xquik.com/api/v1/x/tweets/{tweet_id}/bookmark",
    headers={
        "x-api-key": "xq_YOUR_KEY_HERE",
        "Idempotency-Key": "unbookmark-1895432178065391234",
    },
    json={"account": "elonmusk"},
)
result = response.json()
response.raise_for_status()
removal_record = {
    "status": result["status"],
    "terminal": result["terminal"],
    "safe_to_retry": result["safeToRetry"],
    "write_action_id": result["id"],
    "requested_tweet_id": tweet_id,
    "confirmed_tweet_id": (result.get("result") or {}).get("id") or result.get("targetId"),
    "charged_credits": result["billing"]["chargedCredits"],
    "poll_path": None if result["terminal"] else result["statusUrl"],
}
print(json.dumps(removal_record))

Remove one bookmark by Tweet ID

Put the exact Tweet ID in the request path. Put the connected account username or ID in the body. That account loses the bookmark. This endpoint accepts 1 Tweet ID per request. It never deletes the tweet, likes, or reposts.

Clear many bookmarks

Read the saved posts with Bookmarks. Send 1 request per Tweet ID with its own Idempotency-Key. Keep each removal in your ledger before the next request. Show the account owner the posts before the removal starts. Removed bookmarks don’t come back unless the account saves them again.

Save a removal receipt

Removal column	Source	Rule
`acting_account`	Request `account`	Match the account that saved the bookmark.
`tweet_id`	Path `id`	Keep the exact bookmarked Tweet ID.
`idempotency_key`	Request header	Create a fresh key for each removal.
`write_action_id`	Response `id`	Store the removal action.
`terminal`	Response `terminal`	Change the local list only when `true`.
`safe_to_retry`	Response `safeToRetry`	Retry only when this value is `true`.

Twitter remove bookmark API questions

Can an API remove a bookmark by Tweet ID?

Yes. Send the Tweet ID in the path and the connected account in the body.

How do I remove all bookmarks?

Page through Bookmarks, then remove each post with this route. Each removal costs 10 credits.

Handle errors

Never infer failure from a client timeout. Poll a returned action before sending another request.

For 400, correct the Tweet ID or account value.
For 401, replace invalid Xquik authentication.
For 402, add credits before another request.
For 403, reconnect the selected X account.
For 409, keep the original action and payload.
For 422, review the X rejection before retrying.
For 429, wait for Retry-After.
For 500 or 503, follow safeToRetry and terminal.

Headers

string

Send your Xquik API key in this header. Alternatively, send an OAuth 2.1 bearer token.

string

Send Bearer <token> instead of x-api-key when using OAuth 2.1.

string

required

Unique key for this intended write. Reuse it only for an exact network replay.

string

required

Must be application/json.

Path parameters

string

required

Post ID or URL-encoded post URL, such as x.com/nasa/status/20. See path IDs.

Body

string

required

X username or account ID of the connected X account that removes the bookmark. Xquik strips the @ prefix if included.

Response

Durable write recovery

Send one unique Idempotency-Key per intended write. Replay the same account, target, payload, and media after a lost response. Keep the original key for that replay.

Store id, the nested hash in request, billing, and statusUrl.
Poll after Retry-After or pollAfterMs when terminal is false.
Retry only when safeToRetry is true.
Use a new key when nextAction.requiresNewIdempotencyKey is true.

200 terminal or 202 active

After HTTP 200, store the result and settled billing.
After HTTP 202, poll the same action. Never submit another write.
After HTTP 400, fix the named field. Use a new idempotency key.
After HTTP 401, fix authentication. Do not retry unchanged.
After HTTP 402, fund the account before another write.
After HTTP 403, reconnect the account.
After HTTP 409, keep the original action. Use a new key for new input.
After HTTP 422, fix the rejected request before retrying.
After HTTP 429, wait for Retry-After. Follow nextAction.

See Get Write Action Status for every lifecycle field and terminal state. That page also lists every billing field and retry rule.

{
  "object": "x_write_action",
  "id": "12345",
  "writeActionId": "12345",
  "action": "unbookmark",
  "status": "success",
  "terminal": true,
  "retryable": false,
  "safeToRetry": false,
  "statusUrl": "/api/v1/x/write-actions/12345",
  "pollAfterMs": null
}

{
  "object": "x_write_action",
  "id": "12346",
  "writeActionId": "12346",
  "action": "unbookmark",
  "status": "dispatching",
  "terminal": false,
  "retryable": false,
  "safeToRetry": false,
  "statusUrl": "/api/v1/x/write-actions/12346",
  "pollAfterMs": 2000
}

{
  "error": "missing_idempotency_key",
  "message": "Idempotency-Key is required. Generate one unique key for this write.",
  "charged": false,
  "chargedCredits": "0",
  "retryable": false,
  "safeToRetry": true
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "api_key_paused",
  "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again."
}

{
  "error": "account_not_found",
  "message": "X account not found. Connect it first at /dashboard/x-accounts."
}

{
  "error": "idempotency_conflict",
  "message": "Idempotency-Key was already used with a different request.",
  "charged": false,
  "chargedCredits": "0",
  "retryable": false,
  "safeToRetry": true
}

{
  "error": "x_rejected",
  "message": "X rejected this request. Check what you sent & the account on x.com before you try again."
}

{
  "error": "x_rate_limited",
  "message": "X rate limited this account. Try again in about 15 minutes. Send fewer requests from this account."
}

{
  "error": "x_write_failed",
  "message": "Write action failed unexpectedly. Contact support if this persists."
}

{
  "error": "write_tracking_unavailable",
  "message": "Write tracking unavailable. Try again.",
  "charged": false,
  "chargedCredits": "0",
  "retryable": true,
  "safeToRetry": true
}

Remove Twitter bookmark API to unsave a tweet by ID

curl --request DELETE \
  --url https://xquik.com/api/v1/x/tweets/{id}/bookmark \
  --header 'Content-Type: <content-type>' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "account": "<string>"
}
'

import requests

url = "https://xquik.com/api/v1/x/tweets/{id}/bookmark"

payload = { "account": "<string>" }
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Content-Type": "<content-type>"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {'Idempotency-Key': '<idempotency-key>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({account: '<string>'})
};

fetch('https://xquik.com/api/v1/x/tweets/{id}/bookmark', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/tweets/{id}/bookmark"

	payload := strings.NewReader("{\n  \"account\": \"<string>\"\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Overview

X API

X write

Trends

Radar

Account

Activity

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Remove Twitter bookmark API to unsave a tweet by ID

Remove one bookmark by Tweet ID

Clear many bookmarks

Save a removal receipt

Twitter remove bookmark API questions

Can an API remove a bookmark by Tweet ID?

How do I remove all bookmarks?

Handle errors

Headers

Path parameters

Body

Response

Durable write recovery

200 terminal or 202 active

​Remove one bookmark by Tweet ID

​Clear many bookmarks

​Save a removal receipt

​Twitter remove bookmark API questions

​Can an API remove a bookmark by Tweet ID?

​How do I remove all bookmarks?

​Handle errors

​Headers

​Path parameters

​Body

​Response

​Durable write recovery

​200 terminal or 202 active

Remove one bookmark by Tweet ID

Clear many bookmarks

Save a removal receipt

Twitter remove bookmark API questions

Can an API remove a bookmark by Tweet ID?

How do I remove all bookmarks?

Handle errors

Headers

Path parameters

Body

Response

Durable write recovery

200 terminal or 202 active