Premiers pas

Construis sur Gravl.

Tes données d’entraînement, programmables. Une API REST versionnée, à scopes, en lecture seule sur les séances, les records, les mensurations et les stats, plus un serveur MCP qui permet aux assistants IA d’agir sur ton compte Gravl.

Tokens personnels

Tu construis quelque chose pour toi ? Crée un token depuis ton propre compte et commence à lire tes données en une seule requête.

Apps OAuth

Tu construis pour d’autres utilisateurs Gravl ? Demande l’accès avec OAuth 2.0 : les utilisateurs n’accordent que les scopes que tu demandes.

Gravl MCP

Connecte Claude ou n’importe quel client MCP à ton compte : logge tes séances et gère ton entraînement depuis une conversation.

L’API en un coup d’œil

Base URL	`https://api.gravl.ai`
Version	Tous les endpoints vivent sous `/api/v1` : les breaking changes n’arrivent jamais autrement que dans une nouvelle version.
Format	JSON en entrée comme en sortie ; UTF-8 ; dates en UTC ISO 8601.
Auth	Tokens Bearer (`gat_…`) issus d’un token personnel ou d’une autorisation OAuth.
Accès	Lecture seule aujourd’hui. Les scopes d’écriture arriveront de façon délibérée, jamais implicite.
CORS	Ouvert (sans credentials) sur `/api/v1` et `/oauth` : les apps navigateur peuvent appeler l’API directement.
Statut	Bêta : la surface est stable. Tu enregistres toi-même tes apps OAuth depuis les réglages de ton compte ; après validation, elles s’ouvrent à tous les utilisateurs Gravl.

Ta première requête

Récupère un token personnel et tu es à un curl de ton historique d’entraînement :

Liste tes séances

curl "https://api.gravl.ai/api/v1/workouts?page=1&pageSize=2" \
  -H "Authorization: Bearer gat_…"

{
  "items": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "Push Day",
      "notes": null,
      "startDate": "2026-07-12T17:03:00Z",
      "endDate": "2026-07-12T18:05:00Z",
      "durationMinutes": 62,
      "type": "custom",
      "volume": 24150,
      "calories": 410,
      "personalRecordCount": 1,
      "exerciseCount": 6
    }
  ],
  "pageNumber": 1,
  "totalPages": 87,
  "totalCount": 174,
  "hasPreviousPage": false,
  "hasNextPage": true
}

Chaque token, personnel ou OAuth, est lié à un seul utilisateur et à un ensemble de scopes. Aucun scope ne donne accès aux données de quelqu’un d’autre.