Unlike Tweet

Remove the source user’s like from a tweet. Proxies the official X v2 unlike-post endpoint through the AIsa gateway.

POST https://api.aisa.one/apis/v1/twitter/unlike_twitter

Reference example

text

# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
  --url https://api.aisa.one/apis/v1/twitter/unlike_twitter \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "tweet_id": "1346889436626259968"
}'

200

{
  "data": {
    "liked": false
  }
}

Remove the source user’s like from a tweet. Proxies the official X v2 DELETE /2/users/{id}/likes/{tweet_id} endpoint, exposed through the AIsa gateway at https://api.aisa.one/apis/v1/twitter/unlike_twitter. AIsa uses POST for consistency with the other Twitter write endpoints.

Prerequisites

• An AIsa API key (Bearer token for every request).
• A one-time OAuth authorization for the source user account. Link your X account by calling POST /apis/v1/twitter/auth_twitter — AIsa stores the session against your API key and uses it automatically on every write call.
• The X session must hold like.write, tweet.read, users.read.

Response fields

Field	Type	Meaning
data.liked	boolean	false once the like has been removed. Returned as false even if the source user hadn’t liked the tweet to begin with — unlike is idempotent.

Idempotency

Unliking a tweet the source user has not liked is a no-op. The endpoint still returns 200 with { "data": { "liked": false } }. Safe to retry.

Common 4xx causes

• 400 invalid-request — missing or non-numeric tweet_id
• 403 client-forbidden — OAuth session missing the like.write scope. Re-link via auth_twitter.
• 404 resource-not-found — tweet doesn’t exist or isn’t visible to the source user.

See Error Codes and Rate Limits for more.

Related

Link an X Account

Start the OAuth flow this endpoint requires.

Like a Tweet

The inverse operation.

Post a Tweet

Another write endpoint using the same OAuth session.

Request contract

• Method and path: POST /apis/v1/twitter/unlike_twitter
• Availability: enabled
• Request URL template: https://api.aisa.one/apis/v1/twitter/unlike_twitter
• Runtime facts: a3adc9187fd943329f04d77651501718ebfb69f2eb47355d287b171db1c09ebc

Complete OpenAPI definition

Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "unlikeTwitter",
  "method": "POST",
  "path": "/apis/v1/twitter/unlike_twitter",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "examples": {
          "unlike_tweet": {
            "summary": "Unlike tweet 1346889436626259968",
            "value": {
              "tweet_id": "1346889436626259968"
            }
          }
        },
        "schema": {
          "properties": {
            "tweet_id": {
              "description": "Numeric ID of the tweet to unlike. Must match X's regex `^[0-9]{1,19}$`.",
              "example": "1346889436626259968",
              "pattern": "^[0-9]{1,19}$",
              "type": "string"
            }
          },
          "required": [
            "tweet_id"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "fixed_success",
    "customer_multiplier": 1.0,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 0.01,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

• Default request reference estimate (USD): 0.01
• Cost contract: fixed_success
• Published reference multiplier: 1.0
• Settlement evidence source: request_snapshot

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

tweet_id · string · required

Numeric ID of the tweet to unlike. Must match X's regex ^[0-9]{1,19}$.

Pattern: ^[0-9]{1,19}$

Example:

"1346889436626259968"

Response

200

application/json

Unlike succeeded (or the source user hadn't liked the tweet to begin with).

data · object

Show child attributes