> ## 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.
# Administrar Bookmarks
> Esta guía te muestra cómo agregar y eliminar bookmarks usando la X API. Referencia del nivel estándar de X API v2 sobre quickstart.
export const Button = ({href, children}) => {
return ;
};
Esta guía te muestra cómo agregar y eliminar bookmarks usando la X API.
**Requisitos previos**
Antes de comenzar, necesitarás:
* Una [cuenta de desarrollador](https://developer.x.com/en/portal/petition/essential/basic-info) con una App aprobada
* Un User Access Token con el scope `bookmark.write` (OAuth 2.0 PKCE)
***
## Agregar un bookmark
Necesitas el ID de tu usuario autenticado. Puedes encontrarlo usando el endpoint `/2/users/me` o el [endpoint de user lookup](/x-api/users/lookup/introduction).
Encuentra el ID del Post en la URL cuando visualizas un Post:
```
https://x.com/XDevelopers/status/1460323737035677698
└── Este es el ID del Post
```
```bash cURL theme={null}
curl -X POST "https://api.x.com/2/users/2244994945/bookmarks" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"tweet_id": "1460323737035677698"}'
```
```python Python SDK theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# Agrega un bookmark
response = client.bookmarks.create(
user_id="2244994945",
tweet_id="1460323737035677698"
)
print(f"Bookmarked: {response.data.bookmarked}")
```
```javascript JavaScript SDK theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// Agrega un bookmark
const response = await client.bookmarks.create("2244994945", {
tweetId: "1460323737035677698",
});
console.log(`Bookmarked: ${response.data?.bookmarked}`);
```
```json theme={null}
{
"data": {
"bookmarked": true
}
}
```
***
## Eliminar un bookmark
Elimina un Post de tus bookmarks:
```bash cURL theme={null}
curl -X DELETE "https://api.x.com/2/users/2244994945/bookmarks/1460323737035677698" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
```
```python Python SDK theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# Elimina un bookmark
response = client.bookmarks.delete(
user_id="2244994945",
tweet_id="1460323737035677698"
)
print(f"Bookmarked: {response.data.bookmarked}")
```
```javascript JavaScript SDK theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// Elimina un bookmark
const response = await client.bookmarks.delete("2244994945", "1460323737035677698");
console.log(`Bookmarked: ${response.data?.bookmarked}`);
```
**Respuesta:**
```json theme={null}
{
"data": {
"bookmarked": false
}
}
```
***
## Scopes requeridos
Al usar OAuth 2.0 PKCE, tu access token debe tener estos scopes:
| Scope | Description |
| :--------------- | :--------------------------- |
| `bookmark.write` | Agregar y eliminar bookmarks |
| `tweet.read` | Leer datos de Posts |
| `users.read` | Leer datos de usuarios |
***
## Próximos pasos
Obtén tus Posts guardados como bookmarks
Documentación completa del endpoint