Skip to main content
Murph conversation settings are scoped to the org (account). They control the default sharing behavior for new Murph conversations created within the account.
These endpoints require an admin or super-admin role. Non-admin callers receive 403 FORBIDDEN. The endpoints are available only when Murph is enabled for the caller’s account.

​
Get conversation settings

GET /api/v2/murph/conversation-settings Returns the org’s current conversation settings.
curl

​
Response

​
Set conversation settings

PATCH /api/v2/murph/conversation-settings Sets the org-level default sharing behavior for new Murph conversations. The setting applies only to new conversations. Existing conversations keep their current sharing state.
curl

​
Request body

​
Response

The response returns the full settings object now in effect.

​
How this connects to creating conversations

When you call POST /api/v2/murph/conversations, the sharingEnabled field in the request body follows this precedence:
  1. Explicit value in the request - if sharingEnabled is provided, that value is used.
  2. Org default - if sharingEnabled is omitted, the org-level defaultSharingEnabled value is used.
  3. False - if no org default has been set, new conversations start private.
Individual users can change sharing on any conversation they own at any time using PATCH /api/v2/murph/conversations/{conversationUid}/sharing.

​
Errors

  • 400 VALIDATION_ERROR: invalid request body.
  • 401 UNAUTHORIZED: missing or invalid bearer token.
  • 403 FORBIDDEN: caller does not have admin or super-admin role, or Murph is not enabled for the caller’s account.
See Errors for the full error contract.

Shared conversations

Share a Murph conversation with teammates in the same account.

Murph user preferences

Read and set the authenticated user’s Murph language and display preferences.