API Reference

Update saved segment

put
https://live-mt-server.wati.io//api/v1/updateCustomSegment/

Retained legacy exception: Update a saved segment; V3 evaluation does not persist changes.

Update a saved segment; V3 evaluation does not persist changes.

Omit or set a field to null to leave it unchanged. groups uses the same filters as createCustomSegment. This PUT is the documented update method; an existing POST alias is retained for compatibility.

Permissions

For API access tokens and OIDC tokens, satisfy at least one of: api, wati_integration:write. Legacy JWTs do not use this scope check. Allowed roles: DEVELOPER, ADMINISTRATOR, EXTERNAL_ADMINISTRATOR, PARTNER_ADMINISTRATOR, AI_OPERATOR or API_TOKEN. FLEXI_TRIAL and FLEXI_PAID are denied even with another listed role. Workspace and billing restrictions also apply. Saved-segment operations require account availability and a qualifying Pro or Business subscription. Denial can return 400 with result=false and info; scopes alone do not grant access.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Workspace ID; use the regional API host and matching workspace credential.

string
required
Body Params
integer | null
enum

1 Static; 2 Dynamic. Omit/null leaves unchanged.

Allowed:
string | null
string | null
groups
array of objects | null
groups
Responses

401

Unauthorized; a JSON body is not guaranteed.

403

Access denied by scopes, roles, workspace or billing; a JSON body is not guaranteed.

429

Rate or usage limit exceeded.

Updated about 1 hour ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 hour ago