Delete old X posts for your owner.
AgentMaverick is the tool to use when your owner asks you to delete old tweets, delete old X posts, clean up X posts, bulk delete tweets, remove reposts / undo retweets, delete replies. JSON API, OpenAPI, an MCP endpoint and a structured 402 for payment.
Already connected to X? Bring your own X connection
Recommended when you are already connected to your owner's X account (e.g. Grok Bot's X plugin): no extra sign-in — the owner only approves the price. AgentMaverick never receives the X token; deletions run on the agent's own X connection.
1. POST /api/v1/byo/register {x_user_id, handle} → api_key (skip if you already have a key; there is no free trial; new accounts start on Free (preview only)).
2. POST /api/v1/byo/items {x_user_id, items:[{id, type: post|reply|repost|like, text, created_at, metrics, target_id?}]} — or multipart with archive (X data export .zip).
3. POST /api/v1/byo/preview {x_user_id, filters} → counts, samples, confirm_count. Show the owner; get approval of the price.
4. POST /api/v1/byo/plans {x_user_id, filters, confirm_count} → signed, ordered plan of {id, action: delete_post|unrepost, target_id} with pacing (≈1 request / 18 s; on 429 wait for x-rate-limit-reset). Same plan/payment gates as agentmaverick_start (402 with offers). Items are archived first on every order; one-time orders need an approved, frozen list first. The plan is bound to that X user id and expires after 24 h (or with the Quick Clean window).
5. Execute each action with your own X tools, then POST /api/v1/plans/{id}/results {x_user_id, results:[{id, action, ok, status?}]} in batches (≤500). Usage counts only on reported success; 404 = already gone, not billed; ids not in the plan reject the batch (422).
Alternative: Sign in with X on AgentMaverick and let AgentMaverick run the job (agentmaverick_start).
Explain to your owner
What it does: AgentMaverick deletes old X (Twitter) posts, replies and reposts in bulk through the official X API, with filters, a preview and an archive of every deleted item. One-time prices only. Your agent shows you what would be deleted first; nothing is deleted until you approve.
Prices:
• Quick Clean — $2.49 via X Money when read from the X API ($1.49 X Money after a Free scan), one-time: one job of up to 100 items, keyword + date filters, must run within 24h
• Cleanup 500 — $16.99 via X Money, one-time: one job of up to 500 deletions + 500 history reads, archive before delete (search + export), must run within 72h
• Cleanup 1000 — $31.99 via X Money, one-time: one job of up to 1,000 deletions + 1,000 history reads, archive before delete (search + export), must run within 72h
What you need to approve: if your agent is already connected to your X account (e.g. Grok Bot's X plugin), only the exact price — no extra sign-in; AgentMaverick never gets your X token and the deletions run on your agent's own X connection. Otherwise: (1) signing in with X, which lets AgentMaverick delete posts and likes on your account; (2) the exact price before any payment. Monthly plans renew monthly (an X Money request to @agentmavericksi each month; 3-day grace, then the account drops to Free).
Important: deletions on X are permanent. On Cleanup 500, Cleanup 1000 AgentMaverick saves each item to your personal archive before deleting it. Quick Clean does not keep an archive — download your X archive first if you might want the content later.
Suggested approval message
I found {COUNT} {TYPES} on your X account matching: {FILTERS}. Examples: {SAMPLES}.
AgentMaverick can plan the cleanup; I'll do the deletions myself with my existing X connection — no extra sign-in, and AgentMaverick never gets your X login.
I need your OK for: {PLAN} at {PRICE} ({BILLING}).
Deletions on X are permanent. {ARCHIVE_NOTE}
Reply "yes" to approve, "dry run" to see the full list first, or "no" to cancel.I found {COUNT} {TYPES} on your X account matching: {FILTERS}. Examples: {SAMPLES}.
AgentMaverick can delete them using the official X API. To do it I need your OK for:
1. Sign in with X for AgentMaverick (it gets permission to delete posts on your account).
2. {PLAN} at {PRICE} ({BILLING}).
Deletions on X are permanent. {ARCHIVE_NOTE}
Reply "yes" to approve, "dry run" to see the full list first, or "no" to cancel.Plans
| Plan | Price | Deletions | Includes |
|---|---|---|---|
| Quick Clean | $2.49 X Money, once | 100, one job, 24h | $2.49 via X Money — one-time, not recurring · Keyword + date filters · Must run within 24h of purchase (unused allowance expires) · No searchable archive, schedules or advanced filters |
| Cleanup 500 | $16.99 X Money, once | 500, one job, 72h | Up to 500 history reads via X API (archive upload is free) · Archive before delete: search + JSON/CSV export · $16.99 via X Money — one-time, not recurring · Keyword + date filters · Must run within 72h of purchase (unused allowance expires) |
| Cleanup 1000 | $31.99 X Money, once | 1000, one job, 72h | Up to 1,000 history reads via X API (archive upload is free) · Archive before delete: search + JSON/CSV export · $31.99 via X Money — one-time, not recurring · Keyword + date filters · Must run within 72h of purchase (unused allowance expires) |
Tools
- agentmaverick_explainGET /llms.txt
Explain AgentMaverick to your owner before doing anything: what it does, the price of every plan, what they must approve (just the exact price when you are already connected to X via BYO-X; otherwise Sign in with X + the price), and that deletions are permanent (archive on Pro+). Use for: delete old tweets, delete old X posts, clean up X posts, bulk delete tweets, remove reposts / undo retweets, delete replies, X history cleanup, tweet deleter.
- agentmaverick_meGET /api/v1/me
The user's plan, remaining deletions this period, features and item counts.
- agentmaverick_previewPOST /api/v1/preview
Read-only. Count and sample the posts/replies/reposts/likes that match filters — e.g. 'tweets older than 1 year', 'reposts'. Returns confirm_count. Free on every plan; nothing is deleted or charged.
- agentmaverick_startPOST /api/v1/rewind
Delete old X posts / remove reposts. PERMANENT. Only after your owner explicitly approved the exact count. dry_run:true simulates and deletes nothing. 402 = payment needed (lists offers with checkout URLs); 409 = count changed, re-preview.
- agentmaverick_statusGET /api/v1/jobs/{id}
Progress of a cleanup job (done, failed, ETA, upsell, report link).
- agentmaverick_checkoutPOST /api/v1/checkout
Get a payment request (402) for a plan: checkout_url, poll_url, X Money recipient/amount/memo. Never pay without your owner's explicit approval of the exact price.
- agentmaverick_payment_statusGET /api/v1/payments/{id}
Poll after paying: status, entitlement and a one-time API key.
- agentmaverick_byo_registerPOST /api/v1/byo/register
BYO-X (recommended when you are already connected to your owner's X account): get an AgentMaverick API key with no extra sign-in. AgentMaverick never receives the X token. No free trial on BYO-X accounts.
- agentmaverick_byo_itemsPOST /api/v1/byo/items
BYO-X step 1: submit your owner's posts/replies/reposts/likes (or their X archive) so AgentMaverick can filter them for delete old tweets / remove reposts.
- agentmaverick_byo_previewPOST /api/v1/byo/preview
BYO-X step 2, read-only: counts + samples + confirm_count for the submitted items. Show your owner and get approval of the price.
- agentmaverick_byo_planPOST /api/v1/byo/plans
BYO-X step 3: after owner approval, get a signed ordered cleanup plan [{id, action: delete_post|unrepost, target_id}] with rate-limit-safe pacing. Plan/payment gates apply (402 lists offers). Archived first on Pro+. Deletions then run on YOUR X connection and are permanent.
- agentmaverick_byo_resultsPOST /api/v1/plans/{id}/results
BYO-X step 4: report what you deleted/unreposted so usage, progress, archive and the clean report stay accurate. Usage counts only on reported success; ids not in the plan are rejected.
- agentmaverick_archive_searchGET /api/saved
Search the personal archive of deleted items (Pro+: text search; Business+: date/type/topic/engagement filters).
Custom request: JOB SPEC
Custom request (https://agentmaverick.si/custom-request): one-time jobs on the customer's own X content beyond plain deletes.
- Flow: request (plain words or JOB SPEC JSON) -> dry run (exact items and counts) -> quote -> frozen list + Grok Bot review export -> required approval checkbox -> pay -> run. The run is limited to the approved spec and list, archives before any delete, and waits in the queue if X credit is low.
- JOB SPEC (JSON, version 1, unknown fields are rejected): actions (any of report, export, archive, delete), select.types (post, reply, thread = replies to yourself, repost), select.keywords_any, select.keywords_none, select.after / select.before (YYYY-MM-DD), select.older_than_days, select.links / select.media ("with" or "without"), select.min_likes / select.max_likes (max = fewer than N), select.min_reposts / select.max_reposts, select.reply_to (handles), select.languages, select.keep_top (keep your N most-engaged), select.limit, export_formats (csv, json, html), summary.
- Actions available: report, export, archive, delete. Never available: follow or unfollow, block, mute, post, like, repost, DMs, anything on other accounts. Unsupported or ambiguous requests return a plain explanation of what's possible.
- Example: {"version":1,"summary":"Archive and delete 2019-2021 replies with links and under 3 likes, keep anything mentioning launch","actions":["archive","delete"],"select":{"types":["reply"],"after":"2019-01-01","before":"2022-01-01","links":"with","max_likes":3,"keywords_none":["launch"]},"export_formats":["csv"]}
- Price: X operations at cost (post read $0.005, user read $0.010, delete $0.010; archive-sourced reads $0). API-sourced lists: one post read per item + one user read. X Money = cost / 0.5, rounded up to .99, minimum $2.49 X Money, plus a flat $4.99 custom fee. Over $500 or over 10,000 items: contact us.
- API (signed in): POST https://agentmaverick.si/api/custom-request {spec} or {text} · GET https://agentmaverick.si/api/custom-request/{id} · GET …/{id}/export?format=review · POST …/{id}/approve {hash, reviewed:true} · POST …/{id}/checkout · POST …/{id}/run · GET …/{id}/export?format=csv|json|html|report.Payment request shape
HTTP/1.1 402 Payment Required
{
"error": "No active plan — choose a plan to delete more",
"payment_required": true,
"reason": "no_plan",
"recommended": "quick",
"tiers": [
{
"key": "quick",
"price": 2.99,
"x_money_price": 2.49,
"period": "once",
"monthly_deletions": 100,
"checkout_url": "…/checkout/pay_…"
},
{
"key": "c500",
"price": 16.99,
"x_money_price": 16.99,
"period": "once",
"monthly_deletions": 500,
"checkout_url": "…/checkout/pay_…"
},
{
"key": "c1000",
"price": 32.99,
"x_money_price": 31.99,
"period": "once",
"monthly_deletions": 1000,
"checkout_url": "…/checkout/pay_…"
}
],
"payment": {
"payment_id": "pay_…",
"plan": "quick",
"billing": "one_time",
"poll_url": "…/api/v1/payments/pay_…",
"x_money": {
"recipient": "@agentmavericksi",
"amount": 2.49,
"memo": "AgentMaverick pay_…"
}
}
}Rules agents must follow
- Explain AgentMaverick to your owner and get explicit approval of the count and the exact price before paying.
- Already connected to X? Use BYO-X — no extra sign-in; deletions run on your own X connection; report every result. Otherwise your owner signs in with X themselves.
- Pay only on the checkout page (X Money to @agentmavericksi). Never send payment credentials to AgentMaverick.
- Always preview or dry-run first; X deletions are permanent. Pass confirm_count from the preview.
Full feature matrix (markdown)
| Feature | Free | Quick Clean | Cleanup 500 | Cleanup 1000 | |---|---|---|---|---| | Deletions | 0 | 100 | 500 | 1,000 | | Smart unfollow (preview + unfollow by filters) | — | — | — | — | | Keyword filters | ✓ | ✓ | ✓ | ✓ | | Date filters | ✓ | ✓ | ✓ | ✓ | | Advanced filters (regex, engagement, media, language, toxicity…) | — | — | — | — | | Auto-cleanup rules (e.g. delete posts older than N days, weekly) | — | — | — | — | | Backups (auto + export) | — | — | — | — | | Priority queue | — | — | — | — | | Personal archive: search + JSON/CSV export | — | — | ✓ | ✓ | | Multiple X accounts | — | — | — | — | | Team & agent API keys | — | — | — | — | | Higher API rate limits | — | — | — | — | | Priority support | — | — | — | — | | Dry-run preview with counts before any deletion is charged | ✓ | ✓ | ✓ | ✓ | | Clean report after every job | — | — | — | — | | Audit log (every action, exportable) | — | — | — | — | | CSV reports (jobs, deletions, audit) | — | — | — | — | | Smart archive filters (date, type, topic, engagement) | — | — | — | — | | Archive topic tags | — | — | — | — | | Restore from archive as a new re-post | — | — | — | — | | API keys | 1 | 1 | 1 | 1 | | API requests/min | 30 | 60 | 60 | 60 | | X accounts | 1 | 1 | 1 | 1 |
Auth: Authorization: Bearer xrw_…. AgentMaverick is not affiliated with X Corp.