JustGains

JustGains Exercise API

The Exercise API from JustGains — 10 operation(s) for exercise.

GitHub OpenAPI

Operations 18

GET /api/exercise Get api exercise #
POST /api/exercise Create api exercise #
GET /api/exercise/{exerciseCode} Get api exercise by exercise code #
PUT /api/exercise/{exerciseCode} Replace api exercise by exercise code #
DELETE /api/exercise/{exerciseCode} Delete api exercise by exercise code #
POST /api/exercise/upload Create api exercise upload #
GET /api/exercise/{exerciseCode}/muscle-groups Get api exercise by exercise code muscle groups #
GET /api/exercise/{exerciseCode}/translations Get api exercise by exercise code translations #
GET /api/exercise/{exerciseCode}/videos Get api exercise by exercise code videos #
POST /api/exercise/{exerciseCode}/videos Create api exercise by exercise code videos #
GET /api/exercise/{exerciseCode}/videos/{userId} Get api exercise by exercise code videos by user id #
PUT /api/exercise/{exerciseCode}/videos/{userId}/{exerciseVideoId} Replace api exercise by exercise code videos by user id by exercise video id #
DELETE /api/exercise/{exerciseCode}/videos/{userId}/{exerciseVideoId} Delete api exercise by exercise code videos by user id by exercise video id #
GET /api/exercise/{exerciseCode}/instructions Get api exercise by exercise code instructions #
POST /api/exercise/{exerciseCode}/instructions Create api exercise by exercise code instructions #
GET /api/exercise/{exerciseCode}/instructions/{localeCode}/{userId} Get api exercise by exercise code instructions by locale code by user id #
PUT /api/exercise/{exerciseCode}/instructions/{localeCode}/{userId} Replace api exercise by exercise code instructions by locale code by user id #
DELETE /api/exercise/{exerciseCode}/instructions/{localeCode}/{userId} Delete api exercise by exercise code instructions by locale code by user id #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/justgains-com/openapi/justgains-com-exercise-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/justgains-com/json-schema/justgains-com-user-schema.json
📊
JSONSchema
https://artifacts.apis.io/justgains-com/json-schema/justgains-com-exercise-dto-schema.json
📊
JSONSchema
https://artifacts.apis.io/justgains-com/json-schema/justgains-com-exercise-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/justgains-com/json-schema/justgains-com-workout-schema.json
📊
JSONSchema
https://artifacts.apis.io/justgains-com/json-schema/justgains-com-media-asset-schema.json
📊
JSONSchema
https://artifacts.apis.io/justgains-com/json-schema/justgains-com-workout-data-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/justgains-com:justgains-com-exercise-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

justgains-com-exercise-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: JustGains Exercise API
  version: '1.0'
security:
- Bearer: []
tags:
- name: Exercise
paths:
  /api/exercise:
    get:
      tags:
      - Exercise
      parameters:
      - name: exerciseCategoryCodes
        in: query
        schema:
          type: array
          items:
            type: string
      - name: exerciseTypes
        in: query
        schema:
          type: array
          items:
            type: string
      - name: exerciseMetrics
        in: query
        schema:
          type: array
          items:
            type: string
      - name: publishedStatus
        in: query
        schema:
          type: array
          items:
            type: string
      - name: muscleCodes
        in: query
        schema:
          type: array
          items:
            type: string
      - name: nameSearch
        in: query
        schema:
          type: string
      - name: localeCode
        in: query
        schema:
          type: string
          default: en-US
      - name: pageIndex
        in: query
        schema:
          type: integer
          format: int32
          default: 1
      - name: pageSize
        in: query
        schema:
          type: integer
          format: int32
          default: 100
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ExercisePreviewPaginatedApiResponse'
            application/json:
              schema:
                $ref: '#/components/schemas/ExercisePreviewPaginatedApiResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/ExercisePreviewPaginatedApiResponse'
      summary: Get api exercise
      x-summary-source: derived
      operationId: getApiExercise
      x-operation-id-source: derived
    post:
      tags:
      - Exercise
      parameters:
      - name: localeCode
        in: query
        schema:
          type: string
          default: en-US
      requestBody:
        content:
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/ExerciseRequest'
          application/json:
            schema:
              $ref: '#/components/schemas/ExerciseRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/ExerciseRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/ExerciseRequest'
      responses:
        '200':
          description: OK
      summary: Create api exercise
      x-summary-source: derived
      operationId: postApiExercise
      x-operation-id-source: derived
  /api/exercise/{exerciseCode}:
    get:
      tags:
      - Exercise
      parameters:
      - name: exerciseCode
        in: path
        required: true
        schema:
          type: string
      - name: localeCode
        in: query
        schema:
          type: string
          default: en-US
      responses:
        '200':
          description: OK
      summary: Get api exercise by exercise code
      x-summary-source: derived
      operationId: getApiExerciseByExerciseCode
      x-operation-id-source: derived
    put:
      tags:
      - Exercise
      parameters:
      - name: exerciseCode
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/ExerciseRequest'
          application/json:
            schema:
              $ref: '#/components/schemas/ExerciseRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/ExerciseRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/ExerciseRequest'
      responses:
        '200':
          description: OK
      summary: Replace api exercise by exercise code
      x-summary-source: derived
      operationId: putApiExerciseByExerciseCode
      x-operation-id-source: derived
    delete:
      tags:
      - Exercise
      parameters:
      - name: exerciseCode
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
      summary: Delete api exercise by exercise code
      x-summary-source: derived
      operationId: deleteApiExerciseByExerciseCode
      x-operation-id-source: derived
  /api/exercise/upload:
    post:
      tags:
      - Exercise
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
            encoding:
              file:
                style: form
      responses:
        '200':
          description: OK
      summary: Create api exercise upload
      x-summary-source: derived
      operationId: postApiExerciseUpload
      x-operation-id-source: derived
  /api/exercise/{exerciseCode}/muscle-groups:
    get:
      tags:
      - Exercise
      parameters:
      - name: exerciseCode
        in: path
        required: true
        schema:
          type: string
      - name: localeCode
        in: query
        schema:
          type: string
          default: en-US
      responses:
        '200':
          description: OK
      summary: Get api exercise by exercise code muscle groups
      x-summary-source: derived
      operationId: getApiExerciseByExerciseCodeMuscleGroups
      x-operation-id-source: derived
  /api/exercise/{exerciseCode}/translations:
    get:
      tags:
      - Exercise
      parameters:
      - name: exerciseCode
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
      summary: Get api exercise by exercise code translations
      x-summary-source: derived
      operationId: getApiExerciseByExerciseCodeTranslations
      x-operation-id-source: derived
  /api/exercise/{exerciseCode}/videos:
    get:
      tags:
      - Exercise
      parameters:
      - name: exerciseCode
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
      summary: Get api exercise by exercise code videos
      x-summary-source: derived
      operationId: getApiExerciseByExerciseCodeVideos
      x-operation-id-source: derived
    post:
      tags:
      - Exercise
      parameters:
      - name: exerciseCode
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/ExerciseVideoDto'
          application/json:
            schema:
              $ref: '#/components/schemas/ExerciseVideoDto'
          text/json:
            schema:
              $ref: '#/components/schemas/ExerciseVideoDto'
          application/*+json:
            schema:
              $ref: '#/components/schemas/ExerciseVideoDto'
      responses:
        '200':
          description: OK
      summary: Create api exercise by exercise code videos
      x-summary-source: derived
      operationId: postApiExerciseByExerciseCodeVideos
      x-operation-id-source: derived
  /api/exercise/{exerciseCode}/videos/{userId}:
    get:
      tags:
      - Exercise
      parameters:
      - name: exerciseCode
        in: path
        required: true
        schema:
          type: string
      - name: userId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: OK
      summary: Get api exercise by exercise code videos by user id
      x-summary-source: derived
      operationId: getApiExerciseByExerciseCodeVideosByUserId
      x-operation-id-source: derived
  /api/exercise/{exerciseCode}/videos/{userId}/{exerciseVideoId}:
    put:
      tags:
      - Exercise
      parameters:
      - name: exerciseCode
        in: path
        required: true
        schema:
          type: string
      - name: userId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: exerciseVideoId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        content:
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/ExerciseVideoDto'
          application/json:
            schema:
              $ref: '#/components/schemas/ExerciseVideoDto'
          text/json:
            schema:
              $ref: '#/components/schemas/ExerciseVideoDto'
          application/*+json:
            schema:
              $ref: '#/components/schemas/ExerciseVideoDto'
      responses:
        '200':
          description: OK
      summary: Replace api exercise by exercise code videos by user id by exercise video id
      x-summary-source: derived
      operationId: putApiExerciseByExerciseCodeVideosByUserIdByExerciseVideoId
      x-operation-id-source: derived
    delete:
      tags:
      - Exercise
      parameters:
      - name: exerciseCode
        in: path
        required: true
        schema:
          type: string
      - name: userId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: exerciseVideoId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: OK
      summary: Delete api exercise by exercise code videos by user id by exercise video id
      x-summary-source: derived
      operationId: deleteApiExerciseByExerciseCodeVideosByUserIdByExerciseVideoId
      x-operation-id-source: derived
  /api/exercise/{exerciseCode}/instructions:
    get:
      tags:
      - Exercise
      parameters:
      - name: exerciseCode
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
      summary: Get api exercise by exercise code instructions
      x-summary-source: derived
      operationId: getApiExerciseByExerciseCodeInstructions
      x-operation-id-source: derived
    post:
      tags:
      - Exercise
      parameters:
      - name: exerciseCode
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/ExerciseInstructionRequest'
          application/json:
            schema:
              $ref: '#/components/schemas/ExerciseInstructionRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/ExerciseInstructionRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/ExerciseInstructionRequest'
      responses:
        '200':
          description: OK
      summary: Create api exercise by exercise code instructions
      x-summary-source: derived
      operationId: postApiExerciseByExerciseCodeInstructions
      x-operation-id-source: derived
  /api/exercise/{exerciseCode}/instructions/{localeCode}/{userId}:
    get:
      tags:
      - Exercise
      parameters:
      - name: exerciseCode
        in: path
        required: true
        schema:
          type: string
      - name: userId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: localeCode
        in: path
        required: true
        schema:
          type: string
          default: en-US
      responses:
        '200':
          description: OK
      summary: Get api exercise by exercise code instructions by locale code by user id
      x-summary-source: derived
      operationId: getApiExerciseByExerciseCodeInstructionsByLocaleCodeByUserId
      x-operation-id-source: derived
    put:
      tags:
      - Exercise
      parameters:
      - name: exerciseCode
        in: path
        required: true
        schema:
          type: string
      - name: localeCode
        in: path
        required: true
        schema:
          type: string
      - name: userId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        content:
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/ExerciseInstructionUpdateRequest'
          application/json:
            schema:
              $ref: '#/components/schemas/ExerciseInstructionUpdateRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/ExerciseInstructionUpdateRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/ExerciseInstructionUpdateRequest'
      responses:
        '200':
          description: OK
      summary: Replace api exercise by exercise code instructions by locale code by user id
      x-summary-source: derived
      operationId: putApiExerciseByExerciseCodeInstructionsByLocaleCodeByUserId
      x-operation-id-source: derived
    delete:
      tags:
      - Exercise
      parameters:
      - name: exerciseCode
        in: path
        required: true
        schema:
          type: string
      - name: userId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: localeCode
        in: path
        required: true
        schema:
          type: string
          default: en-US
      responses:
        '200':
          description: OK
      summary: Delete api exercise by exercise code instructions by locale code by user id
      x-summary-source: derived
      operationId: deleteApiExerciseByExerciseCodeInstructionsByLocaleCodeByUserId
      x-operation-id-source: derived
components:
  schemas:
    ExerciseTranslationDto:
      type: object
      properties:
        LocaleCode:
          type:
          - string
          - 'null'
        ExerciseName:
          type:
          - string
          - 'null'
        IsPrimary:
          type: boolean
      additionalProperties: false
    ExercisePreviewPaginatedApiResponse:
      type: object
      properties:
        Status:
          type:
          - string
          - 'null'
        Message:
          type:
          - string
          - 'null'
        Errors:
          type:
          - array
          - 'null'
          items:
            type: string
        Data:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ExercisePreview'
        Pagination:
          $ref: '#/components/schemas/PaginationInfo'
      additionalProperties: false
    MediaAssetDto:
      required:
      - FileName
      - FilePath
      type: object
      properties:
        MediaAssetId:
          type:
          - string
          - 'null'
          format: uuid
        FileName:
          type:
          - string
          - 'null'
        FilePath:
          type:
          - string
          - 'null'
        FileSize:
          type:
          - string
          - 'null'
        FileFormat:
          type:
          - string
          - 'null'
        Description:
          type:
          - string
          - 'null'
      additionalProperties: false
    ExerciseInstructionData:
      type: object
      properties:
        Time:
          type:
          - integer
          - 'null'
          format: int64
        Version:
          type:
          - string
          - 'null'
        Blocks:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/Block'
      additionalProperties: false
    ExerciseInstructionRequest:
      required:
      - LocaleCode
      type: object
      properties:
        LocaleCode:
          type:
          - string
          - 'null'
        InstructionJSON:
          $ref: '#/components/schemas/ExerciseInstructionData'
      additionalProperties: false
    PaginationInfo:
      type: object
      properties:
        CurrentPage:
          type: integer
          format: int32
        TotalPages:
          type: integer
          format: int32
        PageSize:
          type: integer
          format: int32
        TotalCount:
          type: integer
          format: int32
        HasPrevious:
          type: boolean
          readOnly: true
        HasNext:
          type: boolean
          readOnly: true
      additionalProperties: false
    ExerciseRequest:
      required:
      - ExerciseCode
      type: object
      properties:
        ExerciseCode:
          type:
          - string
          - 'null'
        ExerciseTypeCode:
          type:
          - string
          - 'null'
        PublishStatusCode:
          type:
          - string
          - 'null'
        Difficulty:
          type:
          - integer
          - 'null'
          format: int32
        TechnicalComplexity:
          type:
          - integer
          - 'null'
          format: int32
        MetabolicEquivalent:
          type:
          - number
          - 'null'
          format: float
        IsPlateloaded:
          type: boolean
        IsCardio:
          type: boolean
        OlympicRating:
          type:
          - integer
          - 'null'
          format: int32
        PowerLifterRating:
          type:
          - integer
          - 'null'
          format: int32
        CalisthenicRating:
          type:
          - integer
          - 'null'
          format: int32
        PopularityRating:
          type:
          - integer
          - 'null'
          format: int32
        MuscleStimulus:
          type:
          - number
          - 'null'
          format: float
        IsPlyometric:
          type: boolean
        IsIsometric:
          type: boolean
        IsCalisthenic:
          type: boolean
        IsWeighted:
          type: boolean
        IsUnilateral:
          type: boolean
        IsBodyweight:
          type: boolean
        AdminNotes:
          type:
          - string
          - 'null'
        ExerciseTranslations:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ExerciseTranslationDto'
        ExerciseEquipment:
          $ref: '#/components/schemas/ExerciseEquipmentDto'
        ExerciseVideos:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ExerciseVideoDto'
        ExerciseInstructions:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ExerciseInstructionRequest'
        ExerciseMuscles:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ExerciseMuscleDto'
      additionalProperties: false
    ExerciseEquipmentDto:
      type: object
      properties:
        Required:
          type:
          - array
          - 'null'
          items:
            type: string
        Optional:
          type:
          - array
          - 'null'
          items:
            type: string
      additionalProperties: false
    ExerciseVideoDto:
      type: object
      properties:
        MediaElement:
          $ref: '#/components/schemas/MediaAssetDto'
        SortOrder:
          type: integer
          format: int32
      additionalProperties: false
    ExerciseInstructionUpdateRequest:
      type: object
      properties:
        InstructionJSON:
          $ref: '#/components/schemas/ExerciseInstructionData'
      additionalProperties: false
    ExercisePreview:
      required:
      - ExerciseCode
      type: object
      properties:
        ExerciseCode:
          type:
          - string
          - 'null'
        ExerciseName:
          maxLength: 255
          type:
          - string
          - 'null'
        ExerciseTypeCode:
          maxLength: 255
          type:
          - string
          - 'null'
        ExerciseMuscles:
          type:
          - array
          - 'null'
          items:
            type: string
        ExerciseThumbnail:
          $ref: '#/components/schemas/MediaAsset'
        ExerciseMetrics:
          type:
          - array
          - 'null'
          items:
            type: string
        RecentOrder:
          type:
          - integer
          - 'null'
          format: int32
      additionalProperties: false
    Block:
      type: object
      properties:
        Id:
          type:
          - string
          - 'null'
        Type:
          type:
          - string
          - 'null'
        Data:
          $ref: '#/components/schemas/Data'
      additionalProperties: false
    MediaAsset:
      required:
      - FileName
      - FilePath
      type: object
      properties:
        CreatedAt:
          type:
          - string
          - 'null'
          format: date-time
        CreatedBy:
          type:
          - string
          - 'null'
          format: uuid
        UpdatedAt:
          type:
          - string
          - 'null'
          format: date-time
        UpdatedBy:
          type:
          - string
          - 'null'
          format: uuid
        DeletedAt:
          type:
          - string
          - 'null'
          format: date-time
        DeletedBy:
          type:
          - string
          - 'null'
          format: uuid
        MediaId:
          type: string
          format: uuid
        MediaType:
          maxLength: 255
          type:
          - string
          - 'null'
        FileName:
          maxLength: 255
          minLength: 1
          type: string
        FilePath:
          maxLength: 255
          minLength: 1
          type: string
        FileSize:
          maxLength: 255
          type:
          - string
          - 'null'
        FileFormat:
          maxLength: 255
          type:
          - string
          - 'null'
        Description:
          maxLength: 255
          type:
          - string
          - 'null'
      additionalProperties: false
    Data:
      type: object
      properties:
        Text:
          type:
          - string
          - 'null'
      additionalProperties: false
    ExerciseMuscleDto:
      required:
      - MuscleCode
      type: object
      properties:
        MuscleCode:
          type:
          - string
          - 'null'
        IsPrimary:
          type: boolean
        TargetPercentage:
          type: number
          format: double
      additionalProperties: false
  securitySchemes:
    Bearer:
      type: http
      description: Put **_ONLY_** your JWT Bearer token on the textbox below!
      scheme: Bearer
      bearerFormat: JWT