> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Gerenciar Posts na X API v2
> Crie e exclua Posts em nome de usuários autenticados com os endpoints de gerenciamento de Posts do tier standard da X API v2, incluindo detalhes de requisição e resposta.
export const Button = ({href, children}) => {
return ;
};
Os endpoints de Gerenciar Posts permitem criar e excluir Posts em nome de usuários autenticados. Crie aplicações que publicam conteúdo, criam threads ou gerenciam Posts do usuário.
## Visão geral
Publique um novo Post
Exclua um Post existente
Responda a outro Post
Cite outro Post
***
## Endpoints
| Método | Endpoint | Descrição |
| :----- | :------------------------------------------ | :----------------- |
| POST | [`/2/tweets`](/x-api/posts/create-post) | Criar um novo Post |
| DELETE | [`/2/tweets/:id`](/x-api/posts/delete-post) | Excluir um Post |
***
## Criando Posts
### Post básico
```bash theme={null}
curl -X POST "https://api.x.com/2/tweets" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"text": "Hello from the API!"}'
```
**Clientes self-serve:** Posts criados via API são limitados a no máximo 1 cashtag por post.
### Responder a um Post
```bash theme={null}
curl -X POST "https://api.x.com/2/tweets" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"text": "This is a reply!",
"reply": {
"in_reply_to_tweet_id": "1234567890"
}
}'
```
**Clientes self-serve:** Replies só são permitidas se o autor do post original tiver explicitamente convocado a conta que responde ao fazer @menção ou ao citar um dos posts dela.
### Citar um Post
```bash theme={null}
curl -X POST "https://api.x.com/2/tweets" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"text": "Check this out!",
"quote_tweet_id": "1234567890"
}'
```
### Post com mídia
```bash theme={null}
curl -X POST "https://api.x.com/2/tweets" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"text": "Photo of the day",
"media": {
"media_ids": ["1234567890123456789"]
}
}'
```
Primeiro faça upload da mídia usando o [endpoint de Media Upload](/x-api/media/quickstart/media-upload-chunked) e, em seguida, referencie o `media_id` no seu Post.
### Post com poll
```bash theme={null}
curl -X POST "https://api.x.com/2/tweets" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"text": "What is your favorite color?",
"poll": {
"options": ["Red", "Blue", "Green", "Yellow"],
"duration_minutes": 1440
}
}'
```
### Post com paid partnership
Use o field `paid_partnership` ao criar um Post para indicar que se trata de uma parceria paga (ou seja, o autor está divulgando que o Post contém promoção paga). Quando definido como `true`, o Post será rotulado como uma promoção paga.
```bash theme={null}
curl -X POST "https://api.x.com/2/tweets" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"text": "Excited to partner with Acme on their latest launch!",
"paid_partnership": true
}'
```
Para recuperar o valor em Posts existentes (incluindo os seus), solicite-o através do parâmetro `tweet.fields`:
```bash theme={null}
curl "https://api.x.com/2/tweets/1234567890?tweet.fields=paid_partnership,created_at" \
-H "Authorization: Bearer $TOKEN"
```
***
## Excluindo Posts
```bash theme={null}
curl -X DELETE "https://api.x.com/2/tweets/1234567890" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
```
Você só pode excluir Posts criados pelo usuário autenticado.
***
## Introdução
**Pré-requisitos**
* Uma [conta de desenvolvedor](https://developer.x.com/en/portal/petition/essential/basic-info) aprovada
* Um [Project e App](/resources/fundamentals/developer-apps) no Developer Console
* User Access Tokens via [OAuth 2.0 PKCE](/resources/fundamentals/authentication#oauth-2-0-authorization-code-flow-with-pkce-2) ou [3-legged OAuth](/resources/fundamentals/authentication#obtaining-access-tokens-using-3-legged-oauth-flow)
Crie seu primeiro Post
Conceitos-chave e melhores práticas
Faça upload de mídia para Posts
Documentação completa do endpoint