Put Feature Settings

PUT
/v1/admin/feature-settings/{level}

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Bearer credential. API keys look like sqk_<geo>_<key_id>_<secret>: treat them as opaque and never put one in a browser. Older keys without the geo part stay valid until rotated. Find a geo's endpoints through GET /.well-known/sparq-discovery before sending a key.

Path Parameters

level*FeatureLevel

Where a feature setting is stored, from the widest to the narrowest.

Value in"platform""workspace""project""audience_tenant""user""conversation"

Header Parameters

Sparq-Workspace?string

For a person signed in to a console with several workspaces: the workspace this call is for, one of their memberships (listMyMemberships). Without it such a person gets workspace_required (400); a workspace they are not a member of is forbidden. It never grants anything, and other callers' credentials ignore it.

Formatuuid
If-Match?string

The ETag you last read. A different current version is precondition_failed (412). Optional in 0.5.0.

Request Body

application/json
  1. body

All feature settings stored at one level for one scope.

level*FeatureLevel

Where a feature setting is stored, from the widest to the narrowest.

Value in"platform""workspace""project""audience_tenant""user""conversation"
scope_id?|

The workspace, project, audience tenant, user or session the settings apply to. Empty only at platform level.

features*

Response Body

Successful Response

application/json
  1. response

All feature settings stored at one level for one scope.

level*FeatureLevel

Where a feature setting is stored, from the widest to the narrowest.

Value in"platform""workspace""project""audience_tenant""user""conversation"
scope_id?|

The workspace, project, audience tenant, user or session the settings apply to. Empty only at platform level.

features*
Example Request
curl -X PUT 'http://dev-sparq.centralindia.cloudapp.azure.com:8000/v1/admin/feature-settings/platform' \  -H 'Content-Type: application/json' \  -d '{  "level": "platform",  "features": {}}'
Example Response
{  "level": "platform",  "scope_id": "5d3fe357-12dd-4f62-b004-6d1fb3b8454f",  "features": {}}