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

# Signets

> Enregistrer et gérer les Publications mises en signet pour l'utilisateur authentifié

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

Les endpoints Bookmarks vous permettent d’afficher, d’ajouter et de supprimer les Publications ajoutées aux favoris pour l’utilisateur authentifié. Les Bookmarks sont privés et ne sont visibles que par l’utilisateur qui les a créés.

<div id="overview">
  ## Vue d’ensemble
</div>

<CardGroup cols={2}>
  <Card title="Afficher les signets" icon="bookmark">
    Récupérer l’ensemble des Publications ajoutées aux signets
  </Card>

  <Card title="Ajouter un signet" icon="plus">
    Ajouter une Publication aux signets
  </Card>

  <Card title="Supprimer un signet" icon="minus">
    Supprimer une Publication des signets
  </Card>

  <Card title="Dossiers de signets" icon="folder">
    Organiser les signets en dossiers
  </Card>
</CardGroup>

***

<div id="endpoints">
  ## Endpoints
</div>

| Méthode | Endpoint                                                                                  | Description                           |
| :------ | :---------------------------------------------------------------------------------------- | :------------------------------------ |
| GET     | [`/2/users/:id/bookmarks`](/fr/x-api/users/get-bookmarks)                                 | Obtenir les signets de l’utilisateur  |
| POST    | [`/2/users/:id/bookmarks`](/fr/x-api/users/create-bookmark)                               | Ajouter une Publication aux signets   |
| DELETE  | [`/2/users/:id/bookmarks/:tweet_id`](/fr/x-api/users/delete-bookmark)                     | Supprimer un signet                   |
| GET     | [`/2/users/:id/bookmarks/folders`](/fr/x-api/users/get-bookmark-folders)                  | Obtenir les dossiers de signets       |
| GET     | [`/2/users/:id/bookmarks/folders/:folder_id`](/fr/x-api/users/get-bookmarks-by-folder-id) | Obtenir les Publications d’un dossier |

***

<div id="example-get-bookmarks">
  ## Exemple : Obtenir les signets
</div>

```bash theme={null}
curl "https://api.x.com/2/users/123456789/bookmarks?\
tweet.fields=created_at,author_id,public_metrics" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"
```

<div id="example-add-bookmark">
  ## Exemple : Ajouter un signet
</div>

```bash theme={null}
curl -X POST "https://api.x.com/2/users/123456789/bookmarks" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "1234567890"}'
```

***

<div id="getting-started">
  ## Pour commencer
</div>

<Note>
  **Prérequis**

  * Un [compte développeur](https://developer.x.com/en/portal/petition/essential/basic-info) approuvé
  * Un [Project and App](/fr/resources/fundamentals/developer-apps) dans la Console de développement
  * Des jetons d'accès utilisateur via [OAuth 2.0 PKCE](/fr/resources/fundamentals/authentication#oauth-2-0-authorization-code-flow-with-pkce-2) ou [OAuth à 3 volets](/fr/resources/fundamentals/authentication#obtaining-access-tokens-using-3-legged-oauth-flow)
</Note>

<CardGroup cols={2}>
  <Card title="Démarrage rapide : recherche" icon="bookmark" href="/fr/x-api/posts/bookmarks/quickstart/bookmarks-lookup">
    Obtenez les signets d’un utilisateur
  </Card>

  <Card title="Démarrage rapide : gestion" icon="plus" href="/fr/x-api/posts/bookmarks/quickstart/manage-bookmarks">
    Ajoutez et supprimez des signets
  </Card>

  <Card title="Guide d’intégration" icon="book" href="/fr/x-api/posts/bookmarks/integrate">
    Concepts clés et bonnes pratiques
  </Card>

  <Card title="Référence de l’API" icon="code" href="/fr/x-api/posts/bookmarks-lookup">
    Documentation complète de l’endpoint
  </Card>
</CardGroup>