cURL

curl -X PUT "https://api.fitsociety.io/public/v1/workout/performance/sessions/{sessionId}/exercises/{performanceId}/setup" \
  -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({
    setupFields: [
      {
        key: 'chest_pad',
        label: 'Chest Pad',
        type: 'number',
        unit: null,
        options: [],
        order: 0,
        required: false,
        enabled: true,
        defaultValue: '0'
      }
    ],
    setupSettingsEnabled: false,
    clientId: '67f1234567890abcdef1234'
  })
};

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

payload = {
    "setupFields": [
        {
            "key": "chest_pad",
            "label": "Chest Pad",
            "type": "number",
            "unit": None,
            "options": [],
            "order": 0,
            "required": False,
            "enabled": True,
            "defaultValue": "0"
        }
    ],
    "setupSettingsEnabled": False,
    "clientId": "67f1234567890abcdef1234"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "data": {
    "performanceId": "67f1234567890abcdef1234",
    "exerciseId": "67f1234567890abcdef1234",
    "setupSettingsEnabled": true,
    "setupFields": [
      {
        "key": "seat",
        "label": "Seat",
        "type": "text",
        "unit": "",
        "options": [
          "1",
          "2",
          "3",
          "4"
        ],
        "order": 1,
        "required": false,
        "enabled": true,
        "defaultValue": 3
      }
    ],
    "setupValues": {},
    "nextSetupValues": {}
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    },
    "idempotency": {
      "replayed": false
    }
  }
}

Sessions and performance

Update a logged performance's machine setup (freestyle)

Freestyle counterpart of the assigned plan’s setup edit (PUT /app/v1/workout/plans/moments/exercises/{planId}/{planMomentId}/{exerciseId}). Assigned plans keep setup on the plan-exercise subdoc; freestyle has no plan, so the machine setup lives on the LOGGED performance — the same setupFields / setupSettingsEnabled that getClientFreestyleSessionDetail / getClientFreestyleWorkout read.

Updates ONE performance in place, targeted by its own performance id (unambiguous even when the same exercise appears more than once in the session).

Body — both optional but AT LEAST ONE is required:

setupFields: array of setup-field definitions (normalized; max 8). Field type ∈ text | number | select | boolean (unknown types fall back to text).
setupSettingsEnabled: boolean toggle.

When setupFields change, the stored setupValues / nextSetupValues are re-scoped to the new field set (stale keys dropped).

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

{performanceId}

setup

cURL

curl -X PUT "https://api.fitsociety.io/public/v1/workout/performance/sessions/{sessionId}/exercises/{performanceId}/setup" \
  -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({
    setupFields: [
      {
        key: 'chest_pad',
        label: 'Chest Pad',
        type: 'number',
        unit: null,
        options: [],
        order: 0,
        required: false,
        enabled: true,
        defaultValue: '0'
      }
    ],
    setupSettingsEnabled: false,
    clientId: '67f1234567890abcdef1234'
  })
};

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

payload = {
    "setupFields": [
        {
            "key": "chest_pad",
            "label": "Chest Pad",
            "type": "number",
            "unit": None,
            "options": [],
            "order": 0,
            "required": False,
            "enabled": True,
            "defaultValue": "0"
        }
    ],
    "setupSettingsEnabled": False,
    "clientId": "67f1234567890abcdef1234"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "data": {
    "performanceId": "67f1234567890abcdef1234",
    "exerciseId": "67f1234567890abcdef1234",
    "setupSettingsEnabled": true,
    "setupFields": [
      {
        "key": "seat",
        "label": "Seat",
        "type": "text",
        "unit": "",
        "options": [
          "1",
          "2",
          "3",
          "4"
        ],
        "order": 1,
        "required": false,
        "enabled": true,
        "defaultValue": 3
      }
    ],
    "setupValues": {},
    "nextSetupValues": {}
  },
  "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 (a freestyle session).

Example:

"67f1234567890abcdef1234"

performanceId

string

required

The WorkoutExercisePerformance document id to update.

Example:

"67f1234567890abcdef1234"

Body

application/json

At least one of setupFields / setupSettingsEnabled must be present.

setupFields

object[]

Setup-field definitions. Omit to leave the existing fields unchanged.

Maximum array length: 8

Show child attributes

setupSettingsEnabled

boolean

Whether the machine/setup-settings panel is enabled for this exercise.

Example:

false

clientId

string

Only when a coach acts on behalf of a client.

Example:

"67f1234567890abcdef1234"

Response

The effective (post-update) setup config for this 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

Update a logged performance's machine setup (freestyle)

Authorizations

Headers

Path Parameters

Body

Response