> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-d5730eee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Usa los endpoints de Articles de la X API para crear borradores de publicaciones largas con texto enriquecido, medios y embebidos, y publicarlos en X.

Los endpoints de Articles permiten a los desarrolladores crear borradores de Articles y publicarlos en X de forma programática. Los Articles son publicaciones de formato largo que admiten formato de texto enriquecido, publicaciones incrustadas, enlaces e imágenes.

Estos endpoints requieren autenticación de usuario mediante OAuth 1.0a u OAuth 2.0 PKCE con los scopes `tweet.read`, `tweet.write` y `users.read`.

Actualmente, la API admite dos endpoints:

## Crear un borrador de Article

Los desarrolladores pueden crear un nuevo borrador de Article usando el endpoint `POST https://api.x.com/2/articles/draft`. El cuerpo de la solicitud contiene el título del artículo, el contenido del cuerpo como un estado de contenido [DraftJS](https://draftjs.org/docs/api-reference-content-state) de bloques de texto y entidades, y, opcionalmente, una imagen de portada cargada mediante los [endpoints de subida de medios](/x-api/media/introduction).

## Publicar un Article

Una vez que el borrador esté listo, los desarrolladores pueden hacerlo visible públicamente usando el endpoint `POST https://api.x.com/2/articles/{article_id}/publish`, donde `article_id` es el ID devuelto cuando se creó el borrador.

## Primeros pasos

Para usar los endpoints, necesitas un token de acceso de usuario. Para obtener más detalles sobre cómo generarlo, consulta la documentación del [flujo de código de autorización OAuth 2.0 con PKCE](/fundamentals/authentication/oauth-2-0/authorization-code).

Una vez que tengas el token de acceso, puedes crear un borrador de Article como se muestra a continuación:

```bash theme={null}
curl --request POST 'https://api.x.com/2/articles/draft' \
  --header 'Authorization: Bearer XXXXX' \
  --header 'Content-Type: application/json' \
  --data '{
    "title": "My first Article",
    "content_state": {
      "blocks": [
        {
          "text": "Hello from the Articles API!",
          "type": "unstyled"
        }
      ],
      "entities": []
    }
  }'
```

Si la solicitud se realiza correctamente, deberías ver la respuesta JSON que se muestra a continuación:

```json theme={null}
{
  "data": {
    "id": "1146654567674912769",
    "title": "My first Article"
  }
}
```

Después puedes publicar el borrador usando el ID de Article devuelto:

```bash theme={null}
curl --request POST 'https://api.x.com/2/articles/1146654567674912769/publish' \
  --header 'Authorization: Bearer XXXXX'
```

Si la solicitud se realiza correctamente, la respuesta contiene el ID de la publicación creada para el Article publicado:

```json theme={null}
{
  "data": {
    "post_id": "1346889436626259968"
  }
}
```