> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amply-app.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gérer les événements et les séances avec l’API REST

> Créez, listez, consultez, modifiez et supprimez les événements de l’agenda avec l’API REST Amply : catégories, lieux et horaires.

La ressource Events permet de gérer les séances de votre agenda par programmation. Utilisez-la pour synchroniser une billetterie ou un outil de planification, importer une programmation en masse ou automatiser les mises à jour.

## Points de terminaison

| Méthode | Chemin | Description |
| - | - | - |
| `GET` | `/events` | Lister les événements |
| `POST` | `/events` | Créer un événement |
| `GET` | `/events/{id}` | Consulter un événement |
| `PUT` | `/events/{id}` | Modifier un événement |
| `DELETE` | `/events/{id}` | Supprimer un événement |

***

## GET /events — Lister les événements

Renvoie la liste paginée des événements du projet.

### Paramètres de requête

<ParamField query="category" type="string">
  Filtre les résultats selon l’identifiant textuel de la catégorie. Seuls les événements de cette catégorie sont renvoyés.
</ParamField>

<ParamField query="date_from" type="string">
  Date au format ISO 8601. Renvoie uniquement les événements commençant à cette date ou après.
</ParamField>

<ParamField query="date_to" type="string">
  Date au format ISO 8601. Renvoie uniquement les événements se terminant à cette date ou avant.
</ParamField>

<ParamField query="limit" type="integer">
  Nombre maximal de résultats par page. Valeur par défaut : `50`. Maximum : `200`.
</ParamField>

<ParamField query="offset" type="integer">
  Nombre de résultats à ignorer pour la pagination. Valeur par défaut : `0`.
</ParamField>

### Exemple de requête

```bash theme={null}
curl https://api.amply-app.com/v1/events \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Exemple de réponse

```json theme={null}
{
  "data": [
    {
      "id": "evt_abc123",
      "title": "Yoga au sommet",
      "start_time": "2024-07-20T09:30:00Z",
      "end_time": "2024-07-20T10:15:00Z",
      "category": "sport",
      "place_id": "plc_xyz789",
      "description": "Morning yoga session at the summit terrace.",
      "created_at": "2024-06-01T12:00:00Z",
      "updated_at": "2024-06-01T12:00:00Z"
    }
  ],
  "total": 42,
  "limit": 50,
  "offset": 0
}
```

***

## POST /events — Créer un événement

Crée un événement dans l’agenda du projet.

### Paramètres du corps

<ParamField body="title" type="string" required>
  Titre de l’événement affiché au public.
</ParamField>

<ParamField body="start_time" type="string" required>
  Date et heure de début au format ISO 8601.
</ParamField>

<ParamField body="end_time" type="string" required>
  Date et heure de fin au format ISO 8601.
</ParamField>

<ParamField body="category" type="string">
  Identifiant textuel de la catégorie de l’événement, par exemple `music` ou `sport`.
</ParamField>

<ParamField body="place_id" type="string">
  Identifiant du lieu à associer à l’événement. Il doit correspondre à un `id` valide de la ressource [Lieux](/api-reference/places).
</ParamField>

<ParamField body="description" type="string">
  Description textuelle de l’événement.
</ParamField>

### Exemple de requête

```bash theme={null}
curl -X POST https://api.amply-app.com/v1/events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Concert en altitude",
    "start_time": "2024-07-21T14:00:00Z",
    "end_time": "2024-07-21T15:30:00Z",
    "category": "music",
    "description": "Live outdoor concert at the mountain stage."
  }'
```

***

## GET /events/{id} — Consulter un événement

Renvoie un événement à partir de son identifiant.

### Exemple de requête

```bash theme={null}
curl https://api.amply-app.com/v1/events/evt_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"
```

***

## PUT /events/{id} — Modifier un événement

Modifie un événement existant. Incluez uniquement les champs à modifier. Les autres conservent leur valeur.

### Paramètres du corps

La requête `PUT` accepte les mêmes champs que `POST /events`. Tous les champs sont facultatifs.

### Exemple de requête

```bash theme={null}
curl -X PUT https://api.amply-app.com/v1/events/evt_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Concert en altitude (Updated)"
  }'
```

***

## DELETE /events/{id} — Supprimer un événement

Supprime définitivement un événement. Cette action est irréversible.

### Exemple de requête

```bash theme={null}
curl -X DELETE https://api.amply-app.com/v1/events/evt_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Renvoie `204 No Content` en cas de succès.


## Related topics

- [Gérer les lieux et les points d’intérêt avec l’API REST](/api-reference/places.md)
- [Gérer les articles du blog avec l’API REST Amply](/api-reference/articles.md)
- [Gérer vos contenus avec l’API REST Amply](/api-reference/introduction.md)
- [Lister et enregistrer des webhooks avec l’API REST](/api-reference/webhooks.md)
- [Créer un programme avec le module Agenda](/modules/agenda.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.