cURL

curl -X POST "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/plans/workout-feedback" \
  -H "Authorization: Bearer <access_token>" \
  -H "Idempotency-Key: <stable_request_key>" \
  -H "Content-Type: application/json" \
  -d '{}'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({sessionId: '67f1234567890abcdef1234'})
};

fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/plans/workout-feedback', 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/clients/{clientId}/plans/workout-feedback"

payload = { "sessionId": "67f1234567890abcdef1234" }
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "data": {
    "sessionId": "67f1234567890abcdef1234",
    "feedback": {
      "rating": 8,
      "difficulty": "Moderate",
      "emojiRating": "Strong",
      "emoji": "💪",
      "notes": "Felt strong today."
    }
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    },
    "idempotency": {
      "replayed": false
    }
  }
}

Client plans

Submit session workout feedback

Submit session-level feedback from the ‘Add Feedback’ screen: satisfaction rating (1–10), difficulty, emojiRating/emotion (mood), and free-text notes. At least one feedback field is required; only the provided fields are written (null/empty values are ignored — use the PATCH endpoint to clear a field). Submitting feedback auto-completes an open session. Member submissions apply the same saved-completed-set requirement as PATCH session complete: SESSION_COMPLETED_SET_REQUIRED (400) leaves an empty exercise-based session open and does not save feedback. Already-completed sessions and explicit coach submissions retain their existing behavior. A coach passes clientId; a client resolves from the token. For submit-all flows, send feedbacks (or alias members) as an array of session/client entries; root feedback fields are applied to entries that do not override them.

Requires the workout_client_plans:write scope. This operation maps to /app/v1/workout/plans/client/workout-feedback and retains its Workout V2 permission, feature-flag, and resource-scope checks.

The clientId path parameter identifies the client represented by the request context.

POST

public

workout

clients

{clientId}

plans

workout-feedback

cURL

curl -X POST "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/plans/workout-feedback" \
  -H "Authorization: Bearer <access_token>" \
  -H "Idempotency-Key: <stable_request_key>" \
  -H "Content-Type: application/json" \
  -d '{}'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({sessionId: '67f1234567890abcdef1234'})
};

fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/plans/workout-feedback', 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/clients/{clientId}/plans/workout-feedback"

payload = { "sessionId": "67f1234567890abcdef1234" }
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "data": {
    "sessionId": "67f1234567890abcdef1234",
    "feedback": {
      "rating": 8,
      "difficulty": "Moderate",
      "emojiRating": "Strong",
      "emoji": "💪",
      "notes": "Felt strong today."
    }
  },
  "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

clientId

string

required

Client in the company bound to the Public API token.

Pattern: ^[a-fA-F0-9]{24}$

Body

application/json

Option 1
Option 2
Option 3

sessionId

string

required

Example:

"67f1234567890abcdef1234"

clientId

string

Required when the caller is a coach.

Example:

"67f1234567890abcdef1234"

feedback

object

Optional nested feedback object.

Show child attributes

rating

integer

Required range: 1 <= x <= 10

Example:

8

difficulty

enum<string>

Available options:

Easy,

Moderate,

Hard

Example:

"Moderate"

emojiRating

enum<string>

Available options:

Strong,

Energized,

Challenging,

Intense,

Satisfied,

Exhausted

Example:

"Strong"

emotion

enum<string>

Alias for emojiRating.

Available options:

Strong,

Energized,

Challenging,

Intense,

Satisfied,

Exhausted

Example:

"Strong"

notes

string

Example:

"Felt strong today."

Response

Feedback submitted; returns the stored feedback block or bulk results.

data

object

required

Option 1
Option 2

Show child attributes

Workout V2

Health

OAuth

Platform

Company catalog

Clients

Calendar and bookings

Finance

Credits

Progress

Habits

Forms

Documents

Reports

Conversations

Exports

Webhooks

Submit session workout feedback

Authorizations

Headers

Path Parameters

Body

Response