Delete Twitter post monitor & metric history

{
  "deletionStatus": "deleting",
  "statusUrl": "/api/v1/monitors/42",
  "success": true
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

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

{
  "error": "forbidden",
  "message": "This API key calls paid X read routes only, such as GET /api/v1/x/tweets/search. Create a Full access key at dashboard.xquik.com/account?tab=api-keys to call this route."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

DELETE

monitors

posts

{id}

Delete Twitter post monitor & metric history

curl --request DELETE \
  --url https://xquik.com/api/v1/monitors/posts/{id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'DELETE', headers: {'x-api-key': '<api-key>'}};

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

package main

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

func main() {

	url := "https://xquik.com/api/v1/monitors/posts/{id}"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "deletionStatus": "<string>",
  "statusUrl": "<string>",
  "success": true
}

Delete a post monitor only when you no longer need the post’s events or metrics. Pause it instead when you might resume.

Free. This endpoint does not consume credits.

curl -X DELETE https://xquik.com/api/v1/monitors/posts/31 \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

const monitorId = "31";
const response = await fetch(`https://xquik.com/api/v1/monitors/posts/${monitorId}`, {
  method: "DELETE",
  headers: { "x-api-key": "xq_YOUR_KEY_HERE" },
});
const result = await response.json();
const receipt = {
  post_monitor_id: monitorId,
  success: result.success === true,
  verify_endpoint: result.statusUrl,
};
process.stdout.write(`${JSON.stringify(receipt)}\n`);

import json
import requests

monitor_id = "31"
response = requests.delete(
    f"https://xquik.com/api/v1/monitors/posts/{monitor_id}",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
)
result = response.json()
receipt = {
    "post_monitor_id": monitor_id,
    "success": result["success"] is True,
    "verify_endpoint": result["statusUrl"],
}
print(json.dumps(receipt))

Poll verify_endpoint while it answers 200. Deletion is done when it answers 404. Wait for Retry-After between requests.

Before you delete

Export the events & metrics you need first. Deletion removes the monitor’s stored events & hourly metric history. A monitor that Xquik paused for a deleted post costs nothing. Delete it to tidy your list.

Path parameters

string

required

The post monitor ID.

Headers

string

required

Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.

Response

202 Accepted

string

Returns deleting while cleanup runs.

string

Poll this URL until it answers 404.

boolean

Returns true when deletion starts.

{
  "deletionStatus": "deleting",
  "statusUrl": "/api/v1/monitors/posts/31",
  "success": true
}

The response also has Location & Retry-After headers.

400 Invalid input

The monitor ID is not valid.

401 Unauthenticated

Missing or invalid API key.

403 Forbidden

This API key can’t change monitors. Use a Full access key.

404 Not found

No post monitor has this ID on your account.

429 Rate limited

Too many requests. Wait for the Retry-After header before retrying.

Related. List Post Monitors to check removal, or Create Post Monitor to track a new post.

{
  "deletionStatus": "deleting",
  "statusUrl": "/api/v1/monitors/42",
  "success": true
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

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

{
  "error": "forbidden",
  "message": "This API key calls paid X read routes only, such as GET /api/v1/x/tweets/search. Create a Full access key at dashboard.xquik.com/account?tab=api-keys to call this route."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

Delete Twitter post monitor & metric history

curl --request DELETE \
  --url https://xquik.com/api/v1/monitors/posts/{id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'DELETE', headers: {'x-api-key': '<api-key>'}};

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

package main

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

func main() {

	url := "https://xquik.com/api/v1/monitors/posts/{id}"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "deletionStatus": "<string>",
  "statusUrl": "<string>",
  "success": true
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Delete Twitter post monitor & metric history

Before you delete

Path parameters

Headers

Response

202 Accepted

400 Invalid input

401 Unauthenticated

403 Forbidden

404 Not found

429 Rate limited

​Before you delete

​Path parameters

​Headers

​Response

​202 Accepted

​400 Invalid input

​401 Unauthenticated

​403 Forbidden

​404 Not found

​429 Rate limited

Before you delete

Path parameters

Headers

Response

202 Accepted

400 Invalid input

401 Unauthenticated

403 Forbidden

404 Not found

429 Rate limited