Coach Watts Recommendations API

The Recommendations API from Coach Watts — 9 operation(s) for recommendations.

GitHub OpenAPI

Operations 10

GET /api/recommendations/{id} Get recommendation details #
POST /api/recommendations/{id}/accept Accept recommendation #
POST /api/recommendations/{id}/guide Generate implementation guide #
GET /api/recommendations/categories List unique recommendation categories #
DELETE /api/recommendations/clear Clear all recommendations #
POST /api/recommendations/generate Generate recommendations #
GET /api/recommendations List recommendations #
GET /api/recommendations/status Get recommendation generation status #
GET /api/recommendations/today Get today's recommendation #
POST /api/recommendations/today Generate recommendation #

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/coachwatts-com:coachwatts-com-recommendations-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.

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

OpenAPI Specification

coachwatts-com-recommendations-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Coachwatts Com Recommendations API
  version: 0.5.25
  description: 'Operations tagged Recommendations across 2 of this provider''s published API definitions: coachwatts-com-openapi.json, coachwatts-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://coachwatts.com
  description: Local Development Server
  variables: {}
tags:
- name: Recommendations
paths:
  /api/recommendations/{id}:
    get:
      tags:
      - Recommendations
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '401':
          description: Unauthorized
        '404':
          description: Not found
      summary: Get recommendation details
      description: Get details of a specific recommendation.
      operationId: getApiRecommendationsById
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/recommendations/{id}/accept:
    post:
      tags:
      - Recommendations
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
        '400':
          description: Invalid recommendation state
        '401':
          description: Unauthorized
        '404':
          description: Recommendation not found
      summary: Accept recommendation
      description: Accepts the suggested modifications and updates the planned workout.
      operationId: postApiRecommendationsByIdAccept
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/recommendations/{id}/guide:
    post:
      tags:
      - Recommendations
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  jobId:
                    type: string
        '401':
          description: Unauthorized
      summary: Generate implementation guide
      description: Triggers AI generation of a structured implementation guide for a recommendation.
      operationId: postApiRecommendationsByIdGuide
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/recommendations/categories:
    get:
      tags:
      - Recommendations
      parameters: []
      responses:
        '200':
          description: OK
      summary: List unique recommendation categories
      operationId: getApiRecommendationsCategories
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/recommendations/clear:
    delete:
      tags:
      - Recommendations
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  count:
                    type: integer
        '401':
          description: Unauthorized
      summary: Clear all recommendations
      description: Deletes all recommendations for the authenticated user.
      operationId: deleteApiRecommendationsClear
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/recommendations/generate:
    post:
      tags:
      - Recommendations
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  jobId:
                    type: string
        '401':
          description: Unauthorized
      summary: Generate recommendations
      description: Triggers a background job to generate recommendations based on existing score trends.
      operationId: postApiRecommendationsGenerate
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/recommendations:
    get:
      tags:
      - Recommendations
      parameters:
      - name: status
        in: query
        schema:
          type: string
          enum:
          - ACTIVE
          - COMPLETED
          - DISMISSED
          - ALL
      - name: isPinned
        in: query
        schema:
          type: boolean
      - name: metric
        in: query
        schema:
          type: string
      - name: category
        in: query
        schema:
          type: string
      - name: sourceType
        in: query
        schema:
          type: string
      - name: limit
        in: query
        schema:
          type: integer
          default: 50
      responses:
        '200':
          description: OK
      summary: List recommendations
      operationId: getApiRecommendations
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/recommendations/status:
    get:
      tags:
      - Recommendations
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  isRunning:
                    type: boolean
                  task:
                    type: string
                    nullable: true
        '401':
          description: Unauthorized
      summary: Get recommendation generation status
      description: Checks if recommendation generation tasks are currently running.
      inputSchema:
      - in: query
        name: jobId
        schema:
          type: string
        description: Specific Job ID to check
      operationId: getApiRecommendationsStatus
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/recommendations/today:
    get:
      tags:
      - Recommendations
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                nullable: true
                properties:
                  id:
                    type: string
                  date:
                    type: string
                    format: date-time
                  recommendation:
                    type: string
                  confidence:
                    type: number
                  reasoning:
                    type: string
                  status:
                    type: string
                  userAccepted:
                    type: boolean
                  analysisJson:
                    type: object
                  plannedWorkout:
                    type: object
        '401':
          description: Unauthorized
      summary: Get today's recommendation
      description: Returns the daily activity recommendation for the current date.
      operationId: getApiRecommendationsToday
      x-operation-id-source: derived
    post:
      tags:
      - Recommendations
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  jobId:
                    type: string
                  recommendationId:
                    type: string
                  message:
                    type: string
        '401':
          description: Unauthorized
      summary: Generate recommendation
      description: Triggers AI generation of a daily activity recommendation.
      operationId: postApiRecommendationsToday
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
x-refined-from:
- coachwatts-com-openapi.json
- coachwatts-com-openapi.yml