Post Twitter

Publish a tweet — plain text, reply, quote, poll, or with media — on behalf of the authenticated source user. Also supports editing an existing tweet within X’s edit window.

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

cURL

default

curl --request POST \
  --url https://api.aisa.one/apis/v1/twitter/post_twitter \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "",
  "in_reply_to_tweet_id": ""
}
'

200

{
  "code": 123,
  "msg": "<string>",
  "data": {}
}

Publish a tweet on behalf of the authenticated source user. Proxies the official X v2 POST /2/tweets endpoint, routed through the AIsa gateway at https://api.aisa.one/apis/v1/twitter/post_twitter.

One endpoint covers every variant:

Plain text

{ "text": "Hello, World!" }

Reply

Set reply.in_reply_to_tweet_id.

Quote tweet

Set quote_tweet_id.

With a poll

Set poll.options + poll.duration_minutes.

With media

Set media.media_ids (1–4 IDs).

Edit a tweet

Set edit_options.previous_post_id (within X’s edit window).

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 tweet.read, tweet.write, users.read.

Mutually exclusive fields

At most one of these may appear in a single request:

• media
• poll
• quote_tweet_id
• card_uri

X will reject the request (400 invalid-request) if more than one is set.

Response

On success the endpoint returns 201 Created:

{
  "data": {
    "id": "1346889436626259968",
    "text": "Hello, World!"
  }
}

The returned text reflects what X actually stored (e.g., shortened URLs). Use data.id to reference this tweet in subsequent calls (reply, quote, like, edit, delete).

Editing tweets

Pass edit_options.previous_post_id to edit an existing tweet instead of creating a new one. Edits are subject to X’s edit window and edit count limits; the endpoint returns 409 conflict if the window has passed or the edit quota is exhausted.

Reply settings

Restrict who can reply with reply_settings:

Value	Who can reply
following	People you follow
mentionedUsers	Users explicitly mentioned in the tweet
subscribers	Your X Premium subscribers
verified	Verified accounts

Omit the field for the default (everyone).

Common 4xx causes

• 400 invalid-request — set two mutually-exclusive fields, text too long, invalid poll duration, etc.
• 403 client-forbidden — OAuth session missing the tweet.write scope. Re-link via auth_twitter.
• 404 resource-not-found — referenced in_reply_to_tweet_id, quote_tweet_id, or previous_post_id doesn’t exist or isn’t visible to the source user.
• 409 conflict — duplicate content, or edit outside the allowed window.

See the full list on Error Codes and Rate Limits for tier caps.

Related

Link an X Account

Start the OAuth flow this endpoint requires.

Follow a User

Another write endpoint using the same OAuth session.

Twitter Autopilot skill

Agent skill that wraps the full Twitter surface.

Request contract

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

Complete OpenAPI definition

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

{
  "operationId": "postTwitter",
  "method": "POST",
  "path": "/apis/v1/twitter/post_twitter",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "examples": {
          "default": {
            "value": {
              "content": "",
              "in_reply_to_tweet_id": ""
            }
          },
          "minimal": {
            "value": {}
          }
        },
        "schema": {
          "additionalProperties": false,
          "allOf": [
            {
              "anyOf": [
                {
                  "anyOf": [
                    {
                      "allOf": [
                        {
                          "properties": {
                            "content": {
                              "not": {
                                "const": ""
                              }
                            }
                          },
                          "required": [
                            "content"
                          ]
                        },
                        {
                          "properties": {
                            "content": {
                              "default": "",
                              "maxLength": 280,
                              "type": "string"
                            }
                          },
                          "required": [
                            "content"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "content": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "content"
                            ]
                          }
                        },
                        {
                          "properties": {
                            "text": {
                              "not": {
                                "const": ""
                              }
                            }
                          },
                          "required": [
                            "text"
                          ]
                        },
                        {
                          "properties": {
                            "text": {
                              "default": "",
                              "maxLength": 280,
                              "type": "string"
                            }
                          },
                          "required": [
                            "text"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "content": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "content"
                            ]
                          }
                        },
                        {
                          "not": {
                            "properties": {
                              "text": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "text"
                            ]
                          }
                        },
                        {
                          "anyOf": [
                            {
                              "properties": {
                                "content": {
                                  "allOf": [
                                    {
                                      "default": "",
                                      "maxLength": 280,
                                      "type": "string"
                                    },
                                    {
                                      "const": ""
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "content"
                              ]
                            },
                            {
                              "properties": {
                                "text": {
                                  "allOf": [
                                    {
                                      "default": "",
                                      "maxLength": 280,
                                      "type": "string"
                                    },
                                    {
                                      "const": ""
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "text"
                              ]
                            }
                          ]
                        }
                      ]
                    }
                  ]
                },
                {
                  "not": {
                    "anyOf": [
                      {
                        "properties": {
                          "content": {}
                        },
                        "required": [
                          "content"
                        ]
                      },
                      {
                        "properties": {
                          "text": {}
                        },
                        "required": [
                          "text"
                        ]
                      }
                    ]
                  }
                }
              ]
            },
            {
              "anyOf": [
                {
                  "anyOf": [
                    {
                      "allOf": [
                        {
                          "properties": {
                            "in_reply_to_tweet_id": {
                              "not": {
                                "const": ""
                              }
                            }
                          },
                          "required": [
                            "in_reply_to_tweet_id"
                          ]
                        },
                        {
                          "properties": {
                            "in_reply_to_tweet_id": {
                              "default": "",
                              "maxLength": 64,
                              "type": "string"
                            }
                          },
                          "required": [
                            "in_reply_to_tweet_id"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "in_reply_to_tweet_id": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "in_reply_to_tweet_id"
                            ]
                          }
                        },
                        {
                          "properties": {
                            "reply": {
                              "properties": {
                                "in_reply_to_tweet_id": {
                                  "not": {
                                    "const": ""
                                  }
                                }
                              },
                              "required": [
                                "in_reply_to_tweet_id"
                              ]
                            }
                          },
                          "required": [
                            "reply"
                          ]
                        },
                        {
                          "properties": {
                            "reply": {
                              "properties": {
                                "in_reply_to_tweet_id": {
                                  "default": "",
                                  "maxLength": 64,
                                  "type": "string"
                                }
                              },
                              "required": [
                                "in_reply_to_tweet_id"
                              ]
                            }
                          },
                          "required": [
                            "reply"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "in_reply_to_tweet_id": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "in_reply_to_tweet_id"
                            ]
                          }
                        },
                        {
                          "not": {
                            "properties": {
                              "reply": {
                                "properties": {
                                  "in_reply_to_tweet_id": {
                                    "not": {
                                      "const": ""
                                    }
                                  }
                                },
                                "required": [
                                  "in_reply_to_tweet_id"
                                ]
                              }
                            },
                            "required": [
                              "reply"
                            ]
                          }
                        },
                        {
                          "anyOf": [
                            {
                              "properties": {
                                "in_reply_to_tweet_id": {
                                  "allOf": [
                                    {
                                      "default": "",
                                      "maxLength": 64,
                                      "type": "string"
                                    },
                                    {
                                      "const": ""
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "in_reply_to_tweet_id"
                              ]
                            },
                            {
                              "properties": {
                                "reply": {
                                  "properties": {
                                    "in_reply_to_tweet_id": {
                                      "allOf": [
                                        {
                                          "default": "",
                                          "maxLength": 64,
                                          "type": "string"
                                        },
                                        {
                                          "const": ""
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "in_reply_to_tweet_id"
                                  ]
                                }
                              },
                              "required": [
                                "reply"
                              ]
                            }
                          ]
                        }
                      ]
                    }
                  ]
                },
                {
                  "not": {
                    "anyOf": [
                      {
                        "properties": {
                          "in_reply_to_tweet_id": {}
                        },
                        "required": [
                          "in_reply_to_tweet_id"
                        ]
                      },
                      {
                        "properties": {
                          "reply": {
                            "properties": {
                              "in_reply_to_tweet_id": {}
                            },
                            "required": [
                              "in_reply_to_tweet_id"
                            ]
                          }
                        },
                        "required": [
                          "reply"
                        ]
                      }
                    ]
                  }
                }
              ]
            },
            {
              "anyOf": [
                {
                  "anyOf": [
                    {
                      "allOf": [
                        {
                          "properties": {
                            "media_ids": {
                              "not": {
                                "const": ""
                              }
                            }
                          },
                          "required": [
                            "media_ids"
                          ]
                        },
                        {
                          "properties": {
                            "media_ids": {
                              "items": {
                                "type": "string"
                              },
                              "type": "array"
                            }
                          },
                          "required": [
                            "media_ids"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "media_ids": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "media_ids"
                            ]
                          }
                        },
                        {
                          "properties": {
                            "media": {
                              "properties": {
                                "media_ids": {
                                  "not": {
                                    "const": ""
                                  }
                                }
                              },
                              "required": [
                                "media_ids"
                              ]
                            }
                          },
                          "required": [
                            "media"
                          ]
                        },
                        {
                          "properties": {
                            "media": {
                              "properties": {
                                "media_ids": {
                                  "items": {
                                    "type": "string"
                                  },
                                  "type": "array"
                                }
                              },
                              "required": [
                                "media_ids"
                              ]
                            }
                          },
                          "required": [
                            "media"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "media_ids": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "media_ids"
                            ]
                          }
                        },
                        {
                          "not": {
                            "properties": {
                              "media": {
                                "properties": {
                                  "media_ids": {
                                    "not": {
                                      "const": ""
                                    }
                                  }
                                },
                                "required": [
                                  "media_ids"
                                ]
                              }
                            },
                            "required": [
                              "media"
                            ]
                          }
                        },
                        {
                          "anyOf": [
                            {
                              "properties": {
                                "media_ids": {
                                  "allOf": [
                                    {
                                      "items": {
                                        "type": "string"
                                      },
                                      "type": "array"
                                    },
                                    {
                                      "const": ""
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "media_ids"
                              ]
                            },
                            {
                              "properties": {
                                "media": {
                                  "properties": {
                                    "media_ids": {
                                      "allOf": [
                                        {
                                          "items": {
                                            "type": "string"
                                          },
                                          "type": "array"
                                        },
                                        {
                                          "const": ""
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "media_ids"
                                  ]
                                }
                              },
                              "required": [
                                "media"
                              ]
                            }
                          ]
                        }
                      ]
                    }
                  ]
                },
                {
                  "not": {
                    "anyOf": [
                      {
                        "properties": {
                          "media_ids": {}
                        },
                        "required": [
                          "media_ids"
                        ]
                      },
                      {
                        "properties": {
                          "media": {
                            "properties": {
                              "media_ids": {}
                            },
                            "required": [
                              "media_ids"
                            ]
                          }
                        },
                        "required": [
                          "media"
                        ]
                      }
                    ]
                  }
                }
              ]
            }
          ],
          "properties": {
            "aisa_api_key": {
              "maxLength": 64,
              "type": "string"
            },
            "card_uri": {
              "maxLength": 256,
              "type": "string"
            },
            "content": {
              "anyOf": [
                {
                  "default": "",
                  "maxLength": 280,
                  "type": "string"
                },
                {
                  "const": ""
                }
              ]
            },
            "in_reply_to_tweet_id": {
              "anyOf": [
                {
                  "default": "",
                  "maxLength": 64,
                  "type": "string"
                },
                {
                  "const": ""
                }
              ]
            },
            "media": {
              "additionalProperties": false,
              "properties": {
                "media_ids": {
                  "description": "Alternate spelling for /media_ids; ignored when the canonical value is present and nonempty.",
                  "x-aisa-alias-target": "/media_ids"
                },
                "tagged_user_ids": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "type": "object"
            },
            "media_files": {
              "type": "string"
            },
            "media_ids": {
              "anyOf": [
                {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                {
                  "const": ""
                }
              ]
            },
            "poll": {
              "additionalProperties": false,
              "properties": {
                "duration_minutes": {
                  "type": "integer"
                },
                "options": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "type": "object"
            },
            "quote_tweet_id": {
              "maxLength": 64,
              "type": "string"
            },
            "reply": {
              "additionalProperties": false,
              "properties": {
                "auto_populate_reply_metadata": {
                  "type": "boolean"
                },
                "exclude_reply_user_ids": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "in_reply_to_tweet_id": {
                  "description": "Alternate spelling for /in_reply_to_tweet_id; ignored when the canonical value is present and nonempty.",
                  "x-aisa-alias-target": "/in_reply_to_tweet_id"
                }
              },
              "type": "object"
            },
            "reply_settings": {
              "maxLength": 32,
              "type": "string"
            },
            "text": {
              "description": "Alternate spelling for /content; ignored when the canonical value is present and nonempty.",
              "x-aisa-alias-target": "/content"
            }
          },
          "type": "object"
        }
      },
      "application/x-www-form-urlencoded": {
        "schema": {
          "additionalProperties": false,
          "allOf": [
            {
              "anyOf": [
                {
                  "anyOf": [
                    {
                      "allOf": [
                        {
                          "properties": {
                            "content": {
                              "not": {
                                "const": ""
                              }
                            }
                          },
                          "required": [
                            "content"
                          ]
                        },
                        {
                          "properties": {
                            "content": {
                              "default": "",
                              "maxLength": 280,
                              "type": "string"
                            }
                          },
                          "required": [
                            "content"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "content": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "content"
                            ]
                          }
                        },
                        {
                          "properties": {
                            "text": {
                              "not": {
                                "const": ""
                              }
                            }
                          },
                          "required": [
                            "text"
                          ]
                        },
                        {
                          "properties": {
                            "text": {
                              "default": "",
                              "maxLength": 280,
                              "type": "string"
                            }
                          },
                          "required": [
                            "text"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "content": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "content"
                            ]
                          }
                        },
                        {
                          "not": {
                            "properties": {
                              "text": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "text"
                            ]
                          }
                        },
                        {
                          "anyOf": [
                            {
                              "properties": {
                                "content": {
                                  "allOf": [
                                    {
                                      "default": "",
                                      "maxLength": 280,
                                      "type": "string"
                                    },
                                    {
                                      "const": ""
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "content"
                              ]
                            },
                            {
                              "properties": {
                                "text": {
                                  "allOf": [
                                    {
                                      "default": "",
                                      "maxLength": 280,
                                      "type": "string"
                                    },
                                    {
                                      "const": ""
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "text"
                              ]
                            }
                          ]
                        }
                      ]
                    }
                  ]
                },
                {
                  "not": {
                    "anyOf": [
                      {
                        "properties": {
                          "content": {}
                        },
                        "required": [
                          "content"
                        ]
                      },
                      {
                        "properties": {
                          "text": {}
                        },
                        "required": [
                          "text"
                        ]
                      }
                    ]
                  }
                }
              ]
            },
            {
              "anyOf": [
                {
                  "anyOf": [
                    {
                      "allOf": [
                        {
                          "properties": {
                            "in_reply_to_tweet_id": {
                              "not": {
                                "const": ""
                              }
                            }
                          },
                          "required": [
                            "in_reply_to_tweet_id"
                          ]
                        },
                        {
                          "properties": {
                            "in_reply_to_tweet_id": {
                              "default": "",
                              "maxLength": 64,
                              "type": "string"
                            }
                          },
                          "required": [
                            "in_reply_to_tweet_id"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "in_reply_to_tweet_id": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "in_reply_to_tweet_id"
                            ]
                          }
                        },
                        {
                          "properties": {
                            "reply": {
                              "properties": {
                                "in_reply_to_tweet_id": {
                                  "not": {
                                    "const": ""
                                  }
                                }
                              },
                              "required": [
                                "in_reply_to_tweet_id"
                              ]
                            }
                          },
                          "required": [
                            "reply"
                          ]
                        },
                        {
                          "properties": {
                            "reply": {
                              "properties": {
                                "in_reply_to_tweet_id": {
                                  "default": "",
                                  "maxLength": 64,
                                  "type": "string"
                                }
                              },
                              "required": [
                                "in_reply_to_tweet_id"
                              ]
                            }
                          },
                          "required": [
                            "reply"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "in_reply_to_tweet_id": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "in_reply_to_tweet_id"
                            ]
                          }
                        },
                        {
                          "not": {
                            "properties": {
                              "reply": {
                                "properties": {
                                  "in_reply_to_tweet_id": {
                                    "not": {
                                      "const": ""
                                    }
                                  }
                                },
                                "required": [
                                  "in_reply_to_tweet_id"
                                ]
                              }
                            },
                            "required": [
                              "reply"
                            ]
                          }
                        },
                        {
                          "anyOf": [
                            {
                              "properties": {
                                "in_reply_to_tweet_id": {
                                  "allOf": [
                                    {
                                      "default": "",
                                      "maxLength": 64,
                                      "type": "string"
                                    },
                                    {
                                      "const": ""
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "in_reply_to_tweet_id"
                              ]
                            },
                            {
                              "properties": {
                                "reply": {
                                  "properties": {
                                    "in_reply_to_tweet_id": {
                                      "allOf": [
                                        {
                                          "default": "",
                                          "maxLength": 64,
                                          "type": "string"
                                        },
                                        {
                                          "const": ""
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "in_reply_to_tweet_id"
                                  ]
                                }
                              },
                              "required": [
                                "reply"
                              ]
                            }
                          ]
                        }
                      ]
                    }
                  ]
                },
                {
                  "not": {
                    "anyOf": [
                      {
                        "properties": {
                          "in_reply_to_tweet_id": {}
                        },
                        "required": [
                          "in_reply_to_tweet_id"
                        ]
                      },
                      {
                        "properties": {
                          "reply": {
                            "properties": {
                              "in_reply_to_tweet_id": {}
                            },
                            "required": [
                              "in_reply_to_tweet_id"
                            ]
                          }
                        },
                        "required": [
                          "reply"
                        ]
                      }
                    ]
                  }
                }
              ]
            },
            {
              "anyOf": [
                {
                  "anyOf": [
                    {
                      "allOf": [
                        {
                          "properties": {
                            "media_ids": {
                              "not": {
                                "const": ""
                              }
                            }
                          },
                          "required": [
                            "media_ids"
                          ]
                        },
                        {
                          "properties": {
                            "media_ids": {
                              "items": {
                                "type": "string"
                              },
                              "type": "array"
                            }
                          },
                          "required": [
                            "media_ids"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "media_ids": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "media_ids"
                            ]
                          }
                        },
                        {
                          "properties": {
                            "media": {
                              "properties": {
                                "media_ids": {
                                  "not": {
                                    "const": ""
                                  }
                                }
                              },
                              "required": [
                                "media_ids"
                              ]
                            }
                          },
                          "required": [
                            "media"
                          ]
                        },
                        {
                          "properties": {
                            "media": {
                              "properties": {
                                "media_ids": {
                                  "items": {
                                    "type": "string"
                                  },
                                  "type": "array"
                                }
                              },
                              "required": [
                                "media_ids"
                              ]
                            }
                          },
                          "required": [
                            "media"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "media_ids": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "media_ids"
                            ]
                          }
                        },
                        {
                          "not": {
                            "properties": {
                              "media": {
                                "properties": {
                                  "media_ids": {
                                    "not": {
                                      "const": ""
                                    }
                                  }
                                },
                                "required": [
                                  "media_ids"
                                ]
                              }
                            },
                            "required": [
                              "media"
                            ]
                          }
                        },
                        {
                          "anyOf": [
                            {
                              "properties": {
                                "media_ids": {
                                  "allOf": [
                                    {
                                      "items": {
                                        "type": "string"
                                      },
                                      "type": "array"
                                    },
                                    {
                                      "const": ""
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "media_ids"
                              ]
                            },
                            {
                              "properties": {
                                "media": {
                                  "properties": {
                                    "media_ids": {
                                      "allOf": [
                                        {
                                          "items": {
                                            "type": "string"
                                          },
                                          "type": "array"
                                        },
                                        {
                                          "const": ""
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "media_ids"
                                  ]
                                }
                              },
                              "required": [
                                "media"
                              ]
                            }
                          ]
                        }
                      ]
                    }
                  ]
                },
                {
                  "not": {
                    "anyOf": [
                      {
                        "properties": {
                          "media_ids": {}
                        },
                        "required": [
                          "media_ids"
                        ]
                      },
                      {
                        "properties": {
                          "media": {
                            "properties": {
                              "media_ids": {}
                            },
                            "required": [
                              "media_ids"
                            ]
                          }
                        },
                        "required": [
                          "media"
                        ]
                      }
                    ]
                  }
                }
              ]
            }
          ],
          "properties": {
            "aisa_api_key": {
              "maxLength": 64,
              "type": "string"
            },
            "card_uri": {
              "maxLength": 256,
              "type": "string"
            },
            "content": {
              "anyOf": [
                {
                  "default": "",
                  "maxLength": 280,
                  "type": "string"
                },
                {
                  "const": ""
                }
              ]
            },
            "in_reply_to_tweet_id": {
              "anyOf": [
                {
                  "default": "",
                  "maxLength": 64,
                  "type": "string"
                },
                {
                  "const": ""
                }
              ]
            },
            "media": {
              "additionalProperties": false,
              "properties": {
                "media_ids": {
                  "description": "Alternate spelling for /media_ids; ignored when the canonical value is present and nonempty.",
                  "x-aisa-alias-target": "/media_ids"
                },
                "tagged_user_ids": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "type": "object"
            },
            "media_files": {
              "type": "string"
            },
            "media_ids": {
              "anyOf": [
                {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                {
                  "const": ""
                }
              ]
            },
            "poll": {
              "additionalProperties": false,
              "properties": {
                "duration_minutes": {
                  "type": "integer"
                },
                "options": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "type": "object"
            },
            "quote_tweet_id": {
              "maxLength": 64,
              "type": "string"
            },
            "reply": {
              "additionalProperties": false,
              "properties": {
                "auto_populate_reply_metadata": {
                  "type": "boolean"
                },
                "exclude_reply_user_ids": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "in_reply_to_tweet_id": {
                  "description": "Alternate spelling for /in_reply_to_tweet_id; ignored when the canonical value is present and nonempty.",
                  "x-aisa-alias-target": "/in_reply_to_tweet_id"
                }
              },
              "type": "object"
            },
            "reply_settings": {
              "maxLength": 32,
              "type": "string"
            },
            "text": {
              "description": "Alternate spelling for /content; ignored when the canonical value is present and nonempty.",
              "x-aisa-alias-target": "/content"
            }
          },
          "type": "object"
        }
      },
      "multipart/form-data": {
        "encoding": {
          "aisa_api_key": {
            "contentType": "text/plain"
          },
          "card_uri": {
            "contentType": "text/plain"
          },
          "content": {
            "contentType": "text/plain"
          },
          "in_reply_to_tweet_id": {
            "contentType": "text/plain"
          },
          "media_files": {
            "contentType": "text/plain"
          },
          "quote_tweet_id": {
            "contentType": "text/plain"
          },
          "reply_settings": {
            "contentType": "text/plain"
          },
          "text": {
            "contentType": "text/plain"
          }
        },
        "schema": {
          "additionalProperties": false,
          "allOf": [
            {
              "anyOf": [
                {
                  "anyOf": [
                    {
                      "allOf": [
                        {
                          "properties": {
                            "content": {
                              "not": {
                                "const": ""
                              }
                            }
                          },
                          "required": [
                            "content"
                          ]
                        },
                        {
                          "properties": {
                            "content": {
                              "default": "",
                              "maxLength": 280,
                              "type": "string"
                            }
                          },
                          "required": [
                            "content"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "content": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "content"
                            ]
                          }
                        },
                        {
                          "properties": {
                            "text": {
                              "not": {
                                "const": ""
                              }
                            }
                          },
                          "required": [
                            "text"
                          ]
                        },
                        {
                          "properties": {
                            "text": {
                              "default": "",
                              "maxLength": 280,
                              "type": "string"
                            }
                          },
                          "required": [
                            "text"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "content": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "content"
                            ]
                          }
                        },
                        {
                          "not": {
                            "properties": {
                              "text": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "text"
                            ]
                          }
                        },
                        {
                          "anyOf": [
                            {
                              "properties": {
                                "content": {
                                  "allOf": [
                                    {
                                      "default": "",
                                      "maxLength": 280,
                                      "type": "string"
                                    },
                                    {
                                      "const": ""
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "content"
                              ]
                            },
                            {
                              "properties": {
                                "text": {
                                  "allOf": [
                                    {
                                      "default": "",
                                      "maxLength": 280,
                                      "type": "string"
                                    },
                                    {
                                      "const": ""
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "text"
                              ]
                            }
                          ]
                        }
                      ]
                    }
                  ]
                },
                {
                  "not": {
                    "anyOf": [
                      {
                        "properties": {
                          "content": {}
                        },
                        "required": [
                          "content"
                        ]
                      },
                      {
                        "properties": {
                          "text": {}
                        },
                        "required": [
                          "text"
                        ]
                      }
                    ]
                  }
                }
              ]
            },
            {
              "anyOf": [
                {
                  "anyOf": [
                    {
                      "allOf": [
                        {
                          "properties": {
                            "in_reply_to_tweet_id": {
                              "not": {
                                "const": ""
                              }
                            }
                          },
                          "required": [
                            "in_reply_to_tweet_id"
                          ]
                        },
                        {
                          "properties": {
                            "in_reply_to_tweet_id": {
                              "default": "",
                              "maxLength": 64,
                              "type": "string"
                            }
                          },
                          "required": [
                            "in_reply_to_tweet_id"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "in_reply_to_tweet_id": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "in_reply_to_tweet_id"
                            ]
                          }
                        },
                        {
                          "properties": {
                            "reply": {
                              "properties": {
                                "in_reply_to_tweet_id": {
                                  "not": {
                                    "const": ""
                                  }
                                }
                              },
                              "required": [
                                "in_reply_to_tweet_id"
                              ]
                            }
                          },
                          "required": [
                            "reply"
                          ]
                        },
                        {
                          "properties": {
                            "reply": {
                              "properties": {
                                "in_reply_to_tweet_id": {
                                  "default": "",
                                  "maxLength": 64,
                                  "type": "string"
                                }
                              },
                              "required": [
                                "in_reply_to_tweet_id"
                              ]
                            }
                          },
                          "required": [
                            "reply"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "in_reply_to_tweet_id": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "in_reply_to_tweet_id"
                            ]
                          }
                        },
                        {
                          "not": {
                            "properties": {
                              "reply": {
                                "properties": {
                                  "in_reply_to_tweet_id": {
                                    "not": {
                                      "const": ""
                                    }
                                  }
                                },
                                "required": [
                                  "in_reply_to_tweet_id"
                                ]
                              }
                            },
                            "required": [
                              "reply"
                            ]
                          }
                        },
                        {
                          "anyOf": [
                            {
                              "properties": {
                                "in_reply_to_tweet_id": {
                                  "allOf": [
                                    {
                                      "default": "",
                                      "maxLength": 64,
                                      "type": "string"
                                    },
                                    {
                                      "const": ""
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "in_reply_to_tweet_id"
                              ]
                            },
                            {
                              "properties": {
                                "reply": {
                                  "properties": {
                                    "in_reply_to_tweet_id": {
                                      "allOf": [
                                        {
                                          "default": "",
                                          "maxLength": 64,
                                          "type": "string"
                                        },
                                        {
                                          "const": ""
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "in_reply_to_tweet_id"
                                  ]
                                }
                              },
                              "required": [
                                "reply"
                              ]
                            }
                          ]
                        }
                      ]
                    }
                  ]
                },
                {
                  "not": {
                    "anyOf": [
                      {
                        "properties": {
                          "in_reply_to_tweet_id": {}
                        },
                        "required": [
                          "in_reply_to_tweet_id"
                        ]
                      },
                      {
                        "properties": {
                          "reply": {
                            "properties": {
                              "in_reply_to_tweet_id": {}
                            },
                            "required": [
                              "in_reply_to_tweet_id"
                            ]
                          }
                        },
                        "required": [
                          "reply"
                        ]
                      }
                    ]
                  }
                }
              ]
            },
            {
              "anyOf": [
                {
                  "anyOf": [
                    {
                      "allOf": [
                        {
                          "properties": {
                            "media_ids": {
                              "not": {
                                "const": ""
                              }
                            }
                          },
                          "required": [
                            "media_ids"
                          ]
                        },
                        {
                          "properties": {
                            "media_ids": {
                              "items": {
                                "type": "string"
                              },
                              "type": "array"
                            }
                          },
                          "required": [
                            "media_ids"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "media_ids": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "media_ids"
                            ]
                          }
                        },
                        {
                          "properties": {
                            "media": {
                              "properties": {
                                "media_ids": {
                                  "not": {
                                    "const": ""
                                  }
                                }
                              },
                              "required": [
                                "media_ids"
                              ]
                            }
                          },
                          "required": [
                            "media"
                          ]
                        },
                        {
                          "properties": {
                            "media": {
                              "properties": {
                                "media_ids": {
                                  "items": {
                                    "type": "string"
                                  },
                                  "type": "array"
                                }
                              },
                              "required": [
                                "media_ids"
                              ]
                            }
                          },
                          "required": [
                            "media"
                          ]
                        }
                      ]
                    },
                    {
                      "allOf": [
                        {
                          "not": {
                            "properties": {
                              "media_ids": {
                                "not": {
                                  "const": ""
                                }
                              }
                            },
                            "required": [
                              "media_ids"
                            ]
                          }
                        },
                        {
                          "not": {
                            "properties": {
                              "media": {
                                "properties": {
                                  "media_ids": {
                                    "not": {
                                      "const": ""
                                    }
                                  }
                                },
                                "required": [
                                  "media_ids"
                                ]
                              }
                            },
                            "required": [
                              "media"
                            ]
                          }
                        },
                        {
                          "anyOf": [
                            {
                              "properties": {
                                "media_ids": {
                                  "allOf": [
                                    {
                                      "items": {
                                        "type": "string"
                                      },
                                      "type": "array"
                                    },
                                    {
                                      "const": ""
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "media_ids"
                              ]
                            },
                            {
                              "properties": {
                                "media": {
                                  "properties": {
                                    "media_ids": {
                                      "allOf": [
                                        {
                                          "items": {
                                            "type": "string"
                                          },
                                          "type": "array"
                                        },
                                        {
                                          "const": ""
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "media_ids"
                                  ]
                                }
                              },
                              "required": [
                                "media"
                              ]
                            }
                          ]
                        }
                      ]
                    }
                  ]
                },
                {
                  "not": {
                    "anyOf": [
                      {
                        "properties": {
                          "media_ids": {}
                        },
                        "required": [
                          "media_ids"
                        ]
                      },
                      {
                        "properties": {
                          "media": {
                            "properties": {
                              "media_ids": {}
                            },
                            "required": [
                              "media_ids"
                            ]
                          }
                        },
                        "required": [
                          "media"
                        ]
                      }
                    ]
                  }
                }
              ]
            }
          ],
          "description": "Each field is a single text/plain part; repeated fields and JSON object/array parts are not supported.",
          "properties": {
            "aisa_api_key": {
              "maxLength": 64,
              "type": "string"
            },
            "card_uri": {
              "maxLength": 256,
              "type": "string"
            },
            "content": {
              "anyOf": [
                {
                  "default": "",
                  "maxLength": 280,
                  "type": "string"
                },
                {
                  "const": ""
                }
              ]
            },
            "in_reply_to_tweet_id": {
              "anyOf": [
                {
                  "default": "",
                  "maxLength": 64,
                  "type": "string"
                },
                {
                  "const": ""
                }
              ]
            },
            "media": {
              "not": {}
            },
            "media_files": {
              "type": "string"
            },
            "media_ids": {
              "not": {}
            },
            "poll": {
              "not": {}
            },
            "quote_tweet_id": {
              "maxLength": 64,
              "type": "string"
            },
            "reply": {
              "not": {}
            },
            "reply_settings": {
              "maxLength": 32,
              "type": "string"
            },
            "text": {
              "description": "Alternate spelling for /content; ignored when the canonical value is present and nonempty.",
              "x-aisa-alias-target": "/content"
            }
          },
          "type": "object"
        }
      }
    },
    "required": false
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "request_formula",
    "customer_multiplier": 1.0,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 0.015,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Usage-based billing; Default request estimate: $0.015 USD (not a fixed price). 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.015
• Cost contract: request_formula
• 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/jsonapplication/x-www-form-urlencodedmultipart/form-data

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Option 11

Option 12

Option 13

Option 14

Option 15

Option 16

Option 17

Option 18

Option 19

Option 20

Option 21

Option 22

Option 23

Option 24

Option 25

Option 26

Option 27

Option 28

Option 29

Option 30

Option 31

Option 32

Option 33

Option 34

Option 35

Option 36

Option 37

Option 38

Option 39

Option 40

Option 41

Option 42

Option 43

Option 44

Option 45

Option 46

Option 47

Option 48

Option 49

Option 50

Option 51

Option 52

Option 53

Option 54

Option 55

Option 56

Option 57

Option 58

Option 59

Option 60

Option 61

Option 62

Option 63

Option 64

Option 65

Option 66

Option 67

Option 68

Option 69

Option 70

Option 71

Option 72

Option 73

Option 74

Option 75

Option 76

Option 77

Option 78

Option 79

Option 80

Option 81

Option 82

Option 83

Option 84

Option 85

Option 86

Option 87

Option 88

Option 89

Option 90

Option 91

Option 92

Option 93

Option 94

Option 95

Option 96

Option 97

Option 98

Option 99

Option 100

Option 101

Option 102

Option 103

Option 104

Option 105

Option 106

Option 107

Option 108

Option 109

Option 110

Option 111

Option 112

Option 113

Option 114

Option 115

Option 116

Option 117

Option 118

Option 119

Option 120

Option 121

Option 122

Option 123

Option 124

Option 125

content · Option 1 · string Option 2 · string · default: "" · required

Maximum string length: 280

in_reply_to_tweet_id · Option 1 · string Option 2 · string · default: "" · required

Maximum string length: 64

media_ids · Option 1 · string[] Option 2 · string[] · required

aisa_api_key · string

Maximum string length: 64

card_uri · string

Maximum string length: 256

media · object

Show child attributes

media_files · string

poll · object

Show child attributes

quote_tweet_id · string

Maximum string length: 64

reply · object

Show child attributes

reply_settings · string

Maximum string length: 32

text · any

Alternate spelling for /content; ignored when the canonical value is present and nonempty.

Response

200

application/json

Successful ApiResponse serialized by the owning service.

code · integer · required

msg · string · required

data · object | null

The owning service explicitly declares an optional dictionary of arbitrary values; nested Twitter result fields are opaque.