User

Create segment

Create a tier-limited saved corporate segment. At least one effective UserSegmentFilters anchor is required. Unknown fields and legacy forma/estado filters are rejected with 400; an individually valid but unindexed combination is rejected with 422.

post/api/v1/user/segments

Headers

X-CSRF-Tokenstring required

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

Request body

namestring required

descriptionstring

personastring nullable

iconstring nullable

pinnedboolean

Response

Created

idinteger required

Changes

Changed in 1 of the 3 revisions of this API.238

Jul 26, 2026996f96a11758238See the full diff
- ▲
  added the new required header request parameter X-CSRF-Token
  new-required-request-parameter
- ▲
  added required request body
  request-body-added-required
- ○
  api operation id postUserSegments was added
  api-operation-id-added
- ○
  added the media type application/json for the response with the status 201
  response-media-type-added
- ○
  added the media type application/json for the response with the status 400
  response-media-type-added
- ○
  added the non-success response with the status 422
  response-non-success-status-added
- ○
  added the optional property _alias_of to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property action to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property allowed to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property allowed_parameters to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property daily_limit to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property date to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property detail to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property fields to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property key to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property limit to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property limited_by to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property login_url to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property max_bytes to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property maximum to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property needed to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property ok to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property parameter to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property projection to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property remaining to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property reset_at to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property reset_at_human to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property retry_after to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property retry_after_s to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property shortfall to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property slug to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property source_catalog_version to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property status to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property upgrade to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property upgrade_url to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property valid to the response with the 401 status
  response-optional-property-added
- ○
  the response property error became required for the status 401
  response-property-became-required
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history