cURL

curl -X PUT "https://api.fitsociety.io/public/v1/workout/performance/plans/{planId}/moments/{planMomentId}/exercises/{planExerciseId}/next-target" \
  -H "Authorization: Bearer <access_token>" \
  -H "Idempotency-Key: <stable_request_key>" \
  -H "Content-Type: application/json" \
  -d '{}'

const options = {
  method: 'PUT',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    nextSessionTarget: {reps: 8, weight: 60, notes: 'Keep two reps in reserve.'},
    notes: 'Increase only if technique stays clean.'
  })
};

fetch('https://api.fitsociety.io/public/v1/workout/performance/plans/{planId}/moments/{planMomentId}/exercises/{planExerciseId}/next-target', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.fitsociety.io/public/v1/workout/performance/plans/{planId}/moments/{planMomentId}/exercises/{planExerciseId}/next-target"

payload = {
    "nextSessionTarget": {
        "reps": 8,
        "weight": 60,
        "notes": "Keep two reps in reserve."
    },
    "notes": "Increase only if technique stays clean."
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "id": "67f1234567890abcdef1234",
    "exerciseId": "67f1234567890abcdef1234",
    "planExerciseId": null,
    "order": 0,
    "isCompleted": false,
    "date": "2026-04-12T10:00:00.000Z",
    "startedAt": null,
    "endedAt": null,
    "totals": {
      "totalReps": 24,
      "totalTimeSeconds": 0,
      "totalDistanceMeters": 0,
      "totalVolume": 1680,
      "maxWeight": 75,
      "estimated1RM": 95,
      "averageRPE": 8.2
    },
    "sets": [
      {
        "setNumber": 1,
        "setType": "N",
        "displayNumber": 1,
        "displayLabel": "1",
        "targetReps": "8-12",
        "targetWeight": 60,
        "targetTimeSeconds": null,
        "targetDistanceMeters": null,
        "targetRestSeconds": 90,
        "weight": 70,
        "reps": 8,
        "timeSeconds": null,
        "distanceMeters": null,
        "restSeconds": 120,
        "rpe": 8,
        "completed": true,
        "notes": "Felt strong.",
        "isPersonalBest": false,
        "repsPlaceholder": 22,
        "weightPlaceholder": 30,
        "timeSecondsPlaceholder": 55,
        "distanceMetersPlaceholder": 40,
        "rpePlaceholder": 3,
        "restSecondsPlaceholder": 60,
        "repsActual": 30,
        "weightActual": 42,
        "timeSecondsActual": null,
        "distanceMetersActual": null,
        "rpeActual": 8,
        "restSecondsActual": 90
      }
    ],
    "notes": "Last set was slow.",
    "nextSessionTarget": {
      "reps": "5-8",
      "weight": 80,
      "weightUnit": "kg",
      "timeSeconds": null,
      "distanceMeters": null,
      "restSeconds": 120,
      "rpe": 8,
      "notes": "Control the descent.",
      "sets": [
        {}
      ]
    },
    "targetSnapshot": {
      "exerciseType": "reps",
      "todayTarget": {
        "reps": "5-8",
        "weight": 80,
        "weightUnit": "kg",
        "timeSeconds": null,
        "distanceMeters": null,
        "restSeconds": 120,
        "rpe": 8,
        "notes": "Control the descent.",
        "sets": [
          {}
        ]
      },
      "lastSessionTarget": {
        "reps": "5-8",
        "weight": 80,
        "weightUnit": "kg",
        "timeSeconds": null,
        "distanceMeters": null,
        "restSeconds": 120,
        "rpe": 8,
        "notes": "Control the descent.",
        "sets": [
          {}
        ]
      },
      "personalRecord": {
        "metric": "weight",
        "value": 82.5,
        "unit": "kg",
        "reps": 6,
        "performedAt": null,
        "sessionId": null,
        "performanceId": null
      },
      "todaySetupValues": {},
      "lastSetupValues": {},
      "sourceSessionId": null,
      "sourcePerformanceId": null
    },
    "setupFields": [
      {
        "key": "seat",
        "label": "Seat",
        "type": "text",
        "unit": "",
        "options": [
          "1",
          "2",
          "3",
          "4"
        ],
        "order": 1,
        "required": false,
        "enabled": true,
        "defaultValue": 3
      }
    ],
    "setupValues": {},
    "nextSetupValues": {},
    "showSetRpe": true,
    "hasMachineSettings": true,
    "setupSettingsEnabled": true,
    "isMachineSetting": true,
    "provenance": {
      "recordedByActorType": "coach",
      "recordedByClientId": null,
      "recordedByCoachId": null,
      "lastUpdatedByActorType": "coach",
      "lastUpdatedByClientId": null,
      "lastUpdatedByCoachId": null
    },
    "addedSets": [
      {
        "setNumber": 1,
        "setType": "N",
        "displayNumber": 1,
        "displayLabel": "1",
        "previous": "12 × 22kg",
        "reps": 8,
        "weight": 50,
        "timeSeconds": null,
        "distanceMeters": null,
        "rpe": 8,
        "rest": 60,
        "restSeconds": 60,
        "completed": true,
        "targetReps": "8",
        "targetWeight": 50,
        "targetTimeSeconds": null,
        "targetDistanceMeters": null,
        "targetRestSeconds": 60,
        "repsPlaceholderCoach": 12,
        "weightPlaceholderCoach": 40,
        "timeSecondsPlaceholderCoach": null,
        "distanceMetersPlaceholderCoach": null,
        "rpePlaceholderCoach": 7,
        "restSecondsPlaceholderCoach": 90,
        "repsPlaceholder": 12,
        "weightPlaceholder": 40,
        "timeSecondsPlaceholder": null,
        "distanceMetersPlaceholder": null,
        "rpePlaceholder": 7,
        "restSecondsPlaceholder": 90,
        "repsActual": 30,
        "weightActual": 42,
        "timeSecondsActual": null,
        "distanceMetersActual": null,
        "rpeActual": 8,
        "restSecondsActual": 90
      }
    ]
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    },
    "idempotency": {
      "replayed": false
    }
  }
}

Sessions and performance

Set next-target guidance for a prescribed plan-day exercise

Writes next-session guidance and an optional note for a prescribed plan-day exercise before it has been logged. The endpoint resolves or starts the day’s active performance session, creates a placeholder performance when needed, and stores the guidance on that performance. Coaches act for a client by passing clientId in the body or query.

Requires the workout_sessions:write scope. This operation maps to /app/v1/workout/performance/plans/:planId/moments/:planMomentId/exercises/:planExerciseId/next-target and retains its Workout V2 permission, feature-flag, and resource-scope checks.

The clientId path parameter is resolved inside the company bound to the Public API token when present.

PUT

public

workout

performance

plans

{planId}

moments

{planMomentId}

exercises

{planExerciseId}

next-target

cURL

curl -X PUT "https://api.fitsociety.io/public/v1/workout/performance/plans/{planId}/moments/{planMomentId}/exercises/{planExerciseId}/next-target" \
  -H "Authorization: Bearer <access_token>" \
  -H "Idempotency-Key: <stable_request_key>" \
  -H "Content-Type: application/json" \
  -d '{}'

const options = {
  method: 'PUT',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    nextSessionTarget: {reps: 8, weight: 60, notes: 'Keep two reps in reserve.'},
    notes: 'Increase only if technique stays clean.'
  })
};

fetch('https://api.fitsociety.io/public/v1/workout/performance/plans/{planId}/moments/{planMomentId}/exercises/{planExerciseId}/next-target', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.fitsociety.io/public/v1/workout/performance/plans/{planId}/moments/{planMomentId}/exercises/{planExerciseId}/next-target"

payload = {
    "nextSessionTarget": {
        "reps": 8,
        "weight": 60,
        "notes": "Keep two reps in reserve."
    },
    "notes": "Increase only if technique stays clean."
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "id": "67f1234567890abcdef1234",
    "exerciseId": "67f1234567890abcdef1234",
    "planExerciseId": null,
    "order": 0,
    "isCompleted": false,
    "date": "2026-04-12T10:00:00.000Z",
    "startedAt": null,
    "endedAt": null,
    "totals": {
      "totalReps": 24,
      "totalTimeSeconds": 0,
      "totalDistanceMeters": 0,
      "totalVolume": 1680,
      "maxWeight": 75,
      "estimated1RM": 95,
      "averageRPE": 8.2
    },
    "sets": [
      {
        "setNumber": 1,
        "setType": "N",
        "displayNumber": 1,
        "displayLabel": "1",
        "targetReps": "8-12",
        "targetWeight": 60,
        "targetTimeSeconds": null,
        "targetDistanceMeters": null,
        "targetRestSeconds": 90,
        "weight": 70,
        "reps": 8,
        "timeSeconds": null,
        "distanceMeters": null,
        "restSeconds": 120,
        "rpe": 8,
        "completed": true,
        "notes": "Felt strong.",
        "isPersonalBest": false,
        "repsPlaceholder": 22,
        "weightPlaceholder": 30,
        "timeSecondsPlaceholder": 55,
        "distanceMetersPlaceholder": 40,
        "rpePlaceholder": 3,
        "restSecondsPlaceholder": 60,
        "repsActual": 30,
        "weightActual": 42,
        "timeSecondsActual": null,
        "distanceMetersActual": null,
        "rpeActual": 8,
        "restSecondsActual": 90
      }
    ],
    "notes": "Last set was slow.",
    "nextSessionTarget": {
      "reps": "5-8",
      "weight": 80,
      "weightUnit": "kg",
      "timeSeconds": null,
      "distanceMeters": null,
      "restSeconds": 120,
      "rpe": 8,
      "notes": "Control the descent.",
      "sets": [
        {}
      ]
    },
    "targetSnapshot": {
      "exerciseType": "reps",
      "todayTarget": {
        "reps": "5-8",
        "weight": 80,
        "weightUnit": "kg",
        "timeSeconds": null,
        "distanceMeters": null,
        "restSeconds": 120,
        "rpe": 8,
        "notes": "Control the descent.",
        "sets": [
          {}
        ]
      },
      "lastSessionTarget": {
        "reps": "5-8",
        "weight": 80,
        "weightUnit": "kg",
        "timeSeconds": null,
        "distanceMeters": null,
        "restSeconds": 120,
        "rpe": 8,
        "notes": "Control the descent.",
        "sets": [
          {}
        ]
      },
      "personalRecord": {
        "metric": "weight",
        "value": 82.5,
        "unit": "kg",
        "reps": 6,
        "performedAt": null,
        "sessionId": null,
        "performanceId": null
      },
      "todaySetupValues": {},
      "lastSetupValues": {},
      "sourceSessionId": null,
      "sourcePerformanceId": null
    },
    "setupFields": [
      {
        "key": "seat",
        "label": "Seat",
        "type": "text",
        "unit": "",
        "options": [
          "1",
          "2",
          "3",
          "4"
        ],
        "order": 1,
        "required": false,
        "enabled": true,
        "defaultValue": 3
      }
    ],
    "setupValues": {},
    "nextSetupValues": {},
    "showSetRpe": true,
    "hasMachineSettings": true,
    "setupSettingsEnabled": true,
    "isMachineSetting": true,
    "provenance": {
      "recordedByActorType": "coach",
      "recordedByClientId": null,
      "recordedByCoachId": null,
      "lastUpdatedByActorType": "coach",
      "lastUpdatedByClientId": null,
      "lastUpdatedByCoachId": null
    },
    "addedSets": [
      {
        "setNumber": 1,
        "setType": "N",
        "displayNumber": 1,
        "displayLabel": "1",
        "previous": "12 × 22kg",
        "reps": 8,
        "weight": 50,
        "timeSeconds": null,
        "distanceMeters": null,
        "rpe": 8,
        "rest": 60,
        "restSeconds": 60,
        "completed": true,
        "targetReps": "8",
        "targetWeight": 50,
        "targetTimeSeconds": null,
        "targetDistanceMeters": null,
        "targetRestSeconds": 60,
        "repsPlaceholderCoach": 12,
        "weightPlaceholderCoach": 40,
        "timeSecondsPlaceholderCoach": null,
        "distanceMetersPlaceholderCoach": null,
        "rpePlaceholderCoach": 7,
        "restSecondsPlaceholderCoach": 90,
        "repsPlaceholder": 12,
        "weightPlaceholder": 40,
        "timeSecondsPlaceholder": null,
        "distanceMetersPlaceholder": null,
        "rpePlaceholder": 7,
        "restSecondsPlaceholder": 90,
        "repsActual": 30,
        "weightActual": 42,
        "timeSecondsActual": null,
        "distanceMetersActual": null,
        "rpeActual": 8,
        "restSecondsActual": 90
      }
    ]
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    },
    "idempotency": {
      "replayed": false
    }
  }
}

Authorizations

Authorization

string

header

required

Public API access token issued by /public/v1/oauth/token. Example: Authorization: Bearer fspt_.... Each resource request rechecks the token company's current provider access. Disabling access blocks existing tokens with 403 auth.provider_unavailable.

Headers

Idempotency-Key

string

required

Required for Public API write requests. Reusing the same key with the same method, path, and body replays the stored successful response; reusing it with a different request returns 409 idempotency.conflict.

Required string length: 1 - 200

Example:

"booking-create-20260714-001"

Path Parameters

planId

string

required

Assigned plan (template) id.

Example:

"67f1234567890abcdef1234"

planMomentId

string

required

Plan day (moment) id.

Example:

"67f1234567890abcdef1234"

planExerciseId

string

required

The prescribed exercise subdoc id (the plan-day slot) to update.

Example:

"67f1234567890abcdef1234"

Body

application/json

Option 1
Option 2

nextSessionTarget

object

required

Exercise-type-specific next target guidance, such as reps, weight, time, distance, or notes.

notes

string

Optional coach/client note for the exercise.

Example:

"Keep two reps in reserve."

clientId

string

Required only when a coach acts on behalf of a linked client.

Example:

"67f1234567890abcdef1234"

Response

The updated or newly created placeholder performance.

data

object

required

Show child attributes

Workout V2

Health

OAuth

Platform

Company catalog

Clients

Calendar and bookings

Finance

Credits

Progress

Habits

Forms

Documents

Reports

Conversations

Exports

Webhooks

Set next-target guidance for a prescribed plan-day exercise

Authorizations

Headers

Path Parameters

Body

Response