Switch a capability on or off
PUT/ai-world/:feature_key
Turn one AI capability on or off.
Most of these consume AI credits every time they run — check
GET /v1/billing/usage-pricing before enabling one across a busy account.
The response carries changed, which is false when the capability was already
in the requested state. Note that switching a feature on does nothing if the
account's plan does not include AI World at all: the plan gate is checked where
the feature runs, so GET /v1/billing/plan is where that shows up.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 503
The capability, after the change.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
The request was malformed, or a parameter was rejected.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
No token, an expired token, or a credential that has been revoked.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
Refused. Either the credential does not hold the scope this endpoint needs (code: insufficient_scope), or the account's IP allow-list does not include the calling address (code: ip_not_allowed).
Response Headers
Correlation id for this request. Quote it when reporting a problem.
No such resource in this account.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
A dependency is temporarily unavailable, or a required index is still building. Safe to retry.
Response Headers
Correlation id for this request. Quote it when reporting a problem.