cURL

curl -X PUT "https://api.fitsociety.io/public/v1/workout/performance/sessions/{sessionId}/exercises/{exerciseId}" \
  -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({})
};

fetch('https://api.fitsociety.io/public/v1/workout/performance/sessions/{sessionId}/exercises/{exerciseId}', 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/sessions/{sessionId}/exercises/{exerciseId}"

payload = {}
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

Upsert exercise performance for a workout v2 session

The response includes resolved machine-setting definitions and historical values. Omitted machine-setting fields remain unchanged; an explicit empty string clears that setting without restoring its previous value. Response targets and RPE visibility use the freshly loaded plan after any saved prescription updates.

addedSets returns the saved sets in the SAME shape the day / WOD / freestyle GET screens use — including the per-set previous column and the placeholder fields below — so the client can re-render straight off this response without re-fetching. (sets remains the stored rows.)

Per-set placeholders. Every sets[] row carries twelve extra fields: repsPlaceholderCoach, weightPlaceholderCoach, timeSecondsPlaceholderCoach, distanceMetersPlaceholderCoach, rpePlaceholderCoach, restSecondsPlaceholderCoach, and the same six without the Coach suffix. A placeholder is the greyed hint an EMPTY input shows. · *PlaceholderCoach is the coach’s prescription for that set index (WorkoutPlan setsData). null for a metric this exercise type does not track (a time exercise has no reps hint), for a set beyond the prescribed count, for a metric the coach left blank, and for freestyle, which has no prescription at all. · *Placeholder is the hint to actually show. The coach wins: it is the *PlaceholderCoach value whenever there is one, and falls back to the client’s own stored placeholder only where the coach prescribed nothing. So it is identical to *PlaceholderCoach on any prescribed set, and always reflects the CURRENT prescription — a coach editing 8 reps to 12 changes the hint immediately, with no stale client copy able to outlive it. · The client’s stored placeholder (sent per set on PUT /app/v1/workout/performance/sessions/{sessionId}/exercises/{exerciseId}) is therefore a FALLBACK for sets the coach never prescribed, not an override. Send one only where *PlaceholderCoach is null; sending it elsewhere is accepted but ignored. · Placeholders are never logged work — excluded from every total, volume, PR and completion check — so a hint left showing after a value is cleared does not make the set count. They are emitted on logged rows too, because clearing a logged value is exactly when the hint has to reappear. · Committing a hint. When the athlete marks a set completed without typing, send the shown NUMERIC hint as the real value ({ reps: 22, completed: true }); it then counts as their performance. A RANGE hint ("8-12") must NOT be submitted on a completed set — the client should prompt the athlete to enter a value and skip the call, because a range reaching a completed set is stored as its MINIMUM ("12-24" → 12 reps, 120 volume), silently under-crediting them. An unticked set sends its metric as null with completed: false and simply keeps showing the hint.

Requires the workout_sessions:write scope. This operation maps to /app/v1/workout/performance/sessions/:sessionId/exercises/:exerciseId 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

sessions

{sessionId}

exercises

{exerciseId}

cURL

curl -X PUT "https://api.fitsociety.io/public/v1/workout/performance/sessions/{sessionId}/exercises/{exerciseId}" \
  -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({})
};

fetch('https://api.fitsociety.io/public/v1/workout/performance/sessions/{sessionId}/exercises/{exerciseId}', 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/sessions/{sessionId}/exercises/{exerciseId}"

payload = {}
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

sessionId

string

required

Workout session id.

Example:

"67f1234567890abcdef1234"

exerciseId

string

required

Exercise id to upsert within the session.

Example:

"67f1234567890abcdef1234"

Body

application/json

All fields optional — send only what changes (e.g. just notes or restSeconds). When sets are sent, isCompleted is auto-derived (true only when every set is completed) and overrides any isCompleted in the body; an explicit isCompleted is honored only when no sets are sent.

performanceId

string | null

Existing server performance id to update. A valid id that does not match an active performance in the authorized company, client, and session scope returns 404. For transitional mobile compatibility, a value equal to the URL exerciseId is treated as a catalog-id create fallback and is never adopted as the new performance id.

Example:

"67f1234567890abcdef1234"

sets

object[]

Show child attributes

notes

string

Client's own exercise note (this session).

Example:

"Last set was slow."

restSeconds

number | null

Client's own exercise-level rest ("Rest time : 30 sec"). null/"" clears it.

Example:

30

isCompleted

boolean

Auto-derived from sets when they are sent; only honored explicitly when no sets are present.

Example:

true

planId

string

Example:

"67f1234567890abcdef1234"

planMomentId

string

Example:

"67f1234567890abcdef1234"

planExerciseId

string

Example:

"67f1234567890abcdef1234"

order

number

Example:

0

nextSessionTarget

object

Show child attributes

setupFields

object[]

Maximum array length: 8

Show child attributes

setupValues

object

nextSetupValues

object

Response

Created or updated performance payload.

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

Upsert exercise performance for a workout v2 session

Authorizations

Headers

Path Parameters

Body

Response