Primeros pasos

Construye sobre Gravl.

Tus datos de entrenamiento, programables. Una API REST versionada, con scopes y de solo lectura sobre entrenamientos, récords, medidas y estadísticas; además, un servidor MCP que permite a los asistentes de IA actuar sobre tu cuenta de Gravl.

Tokens personales

¿Construyes algo para ti? Crea un token desde tu propia cuenta y empieza a leer tus datos en una sola petición.

Apps OAuth

¿Construyes para otros usuarios de Gravl? Solicita acceso con OAuth 2.0: los usuarios conceden solo los scopes que pides.

Gravl MCP

Conecta Claude o cualquier cliente MCP a tu cuenta: registra entrenamientos y gestiona tu entrenamiento desde una conversación.

La API de un vistazo


URL base	`https://api.gravl.ai`
Versión	Todos los endpoints viven bajo `/api/v1`; los cambios incompatibles solo llegan como una versión nueva.
Formato	JSON de entrada y de salida; UTF-8; las fechas son UTC ISO 8601.
Autenticación	Tokens bearer (`gat_…`) de un token personal o de un grant OAuth.
Acceso	Solo lectura por ahora. Los scopes de escritura se introducirán de forma deliberada, no implícita.
CORS	Abierto (sin credenciales) en `/api/v1` y `/oauth`; las apps de navegador pueden llamar a la API directamente.
Estado	Beta: la superficie es estable, pero el registro de apps OAuth es manual.

Tu primera petición

Consigue un token personal y estás a un curl de tu historial de entrenamiento:

Lista tus entrenamientos

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
}

Cada token, personal o de OAuth, está ligado a un usuario y a un conjunto de scopes. No existe ningún scope que dé acceso a los datos de otra persona.

¿Dudas o ideas?

La plataforma de desarrolladores es joven y la moldea lo que la gente construye. Para registrar una app OAuth, resolver dudas o proponer funcionalidades, escribe a developers@gravl.ai.