Update conversation message - FITsociety Developer APIs

cURL

curl -X PATCH "https://api.fitsociety.io/public/v1/conversations/<conversationId>/messages/<messageId>" \
  -H "Authorization: Bearer <access_token>" \
  -H "Idempotency-Key: conversation-message-update-001" \
  -H "Content-Type: application/json" \
  -d '{
    "conversationType": "group",
    "senderCoachId": "66f7b8b1e13c8d25f4d3d90b",
    "message": "Updated text."
  }'

const options = {
  method: 'PATCH',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    senderCoachId: '66f7b8b1e13c8d25f4d3d90b',
    message: 'Hi team, I added the meal-prep notes.'
  })
};

fetch('https://api.fitsociety.io/public/v1/conversations/{conversationId}/messages/{messageId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.fitsociety.io/public/v1/conversations/{conversationId}/messages/{messageId}"

payload = {
    "senderCoachId": "66f7b8b1e13c8d25f4d3d90b",
    "message": "Hi team, I added the meal-prep notes."
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "data": {
    "message": {
      "messageId": "66f7b8b1e13c8d25f4d3d90a",
      "conversationId": "66f7b8b1e13c8d25f4d3d90a",
      "conversationType": "direct",
      "sender": {
        "userId": "66f7b8b1e13c8d25f4d3d90a",
        "role": "Coach",
        "name": "Example name"
      },
      "type": "text",
      "text": "string",
      "hasMedia": true,
      "fileName": "Example name",
      "sentAt": "2026-07-14T10:00:00.000Z",
      "editedAt": "2026-07-14T10:00:00.000Z",
      "isDeleted": true
    }
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    },
    "idempotency": {
      "replayed": false
    }
  }
}

PATCH

/

public

/

v1

/

conversations

/

{conversationId}

/

messages

/

{messageId}

cURL

curl -X PATCH "https://api.fitsociety.io/public/v1/conversations/<conversationId>/messages/<messageId>" \
  -H "Authorization: Bearer <access_token>" \
  -H "Idempotency-Key: conversation-message-update-001" \
  -H "Content-Type: application/json" \
  -d '{
    "conversationType": "group",
    "senderCoachId": "66f7b8b1e13c8d25f4d3d90b",
    "message": "Updated text."
  }'

const options = {
  method: 'PATCH',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    senderCoachId: '66f7b8b1e13c8d25f4d3d90b',
    message: 'Hi team, I added the meal-prep notes.'
  })
};

fetch('https://api.fitsociety.io/public/v1/conversations/{conversationId}/messages/{messageId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.fitsociety.io/public/v1/conversations/{conversationId}/messages/{messageId}"

payload = {
    "senderCoachId": "66f7b8b1e13c8d25f4d3d90b",
    "message": "Hi team, I added the meal-prep notes."
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "data": {
    "message": {
      "messageId": "66f7b8b1e13c8d25f4d3d90a",
      "conversationId": "66f7b8b1e13c8d25f4d3d90a",
      "conversationType": "direct",
      "sender": {
        "userId": "66f7b8b1e13c8d25f4d3d90a",
        "role": "Coach",
        "name": "Example name"
      },
      "type": "text",
      "text": "string",
      "hasMedia": true,
      "fileName": "Example name",
      "sentAt": "2026-07-14T10:00:00.000Z",
      "editedAt": "2026-07-14T10:00:00.000Z",
      "isDeleted": true
    }
  },
  "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

conversationId

string

required

Example:

"66f7b8b1e13c8d25f4d3d90a"

messageId

string

required

Example:

"66f7b8b1e13c8d25f4d3d90a"

Body

application/json

senderCoachId

string

required

Requesting coach ID sending as. Other-coach delegation is not enabled.

Example:

"66f7b8b1e13c8d25f4d3d90b"

message

string

required

Required string length: 1 - 5000

Example:

"Hi team, I added the meal-prep notes."

conversationType

enum<string>

Available options:

direct,

group

Example:

"group"

Response

Conversation message updated

data

object

required

Show child attributes

meta

object

required

Show child attributes