API referenceEndpoints

Set organization web search limits

Requires organization-administrator authority. Generated from the production route registered in `internal/features/websearch/inbound/http.go`.

PUT/v1/web-search/policy

Requires organization-administrator authority. Generated from the production route registered in internal/features/websearch/inbound/http.go.

Authorization

bearerAuth
AuthorizationBearer <token>

Engine-issued API key or tenant-signed JWT.

In: header

Header Parameters

If-Match*string

The strong entity tag from the most recent GET or PUT, or * for "whatever is stored now". Omitting it is 428; a tag that is not current is 412. The tag is opaque — echo it, never parse it.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

One organization's tightening of its parent web search limits. A null or absent field inherits the parent; a value above the parent, zero or negative is 400 and nothing is stored. Unknown fields are rejected.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/web-search/policy" \  -H "If-Match: string" \  -H "Content-Type: application/json" \  -d '{}'
{  "scope": "organization",  "org_id": "string",  "platform_version": 0,  "parent_source": "application",  "parent_version": 0,  "version": 0,  "override": {    "monthly_searches": 1,    "searches_per_minute": 1  },  "effective": {    "monthly_searches": 1000,    "searches_per_minute": 30  }}