User

Replace mutable segment fields

Changed on Jul 26, 2026

When filters_json is present it follows UserSegmentFilters. Invalid or legacy fields return 400; unsupported indexed combinations return 422.

put/api/v1/user/segments/{id}

Request

Base URL
https://openmercantil.es
Auth
API key in cookie ob_sess
TypeScript
https://skmtc.dev/openmercantil/apis/openmercantil-public-api/docs/api/v1/user/segments/:id/put.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idinteger required

Headers

X-CSRF-Tokenstring required

Fresh token returned by GET /api/v1/user/me for this authenticated session.

Request body

namestring

descriptionstring

iconstring nullable

pinnedboolean

Response

Updated

okboolean required

Changes

Jul 26, 2026996f96a11758 Revision changes
- breaking
  added the new required header request parameter X-CSRF-Token
- breaking
  added required request body
- warning
  for the path request parameter id, the min was set to 1.00
- info
  api operation id putUserSegmentsById was added
- info
  added the media type application/json for the response with the status
- info
  added the media type application/json for the response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  the response property became required for the status

Operation history