Capability declaration

23 distinct extensions were invented to do this job. Each one is a provider deciding OpenAPI would not carry something and building their own way through. Where a job has many names and few uses each, nobody won — the problem was solved privately, over and over.

23 extensions
4846 occurrences
3 vendor-named

The extensions

ExtensionWhat it appears to doUsesProviders
x-undo `x-undo` appears on operations. Its value is a structured object. Used by a single provider across 1 OpenAPI document. Consistent with capability declaration — this is inferred from where the key appe 523 1
x-capability `x-capability` appears on operations. Its value is a list. Used by a single provider across 1 OpenAPI document. Observed values include `transformationsAcl:READ`, `transformationsAcl:WRITE`, `subscrib 426 1
x-requiresInternalClient `x-requiresInternalClient` appears on operations. Its value is a boolean flag. Used by a single provider across 17 OpenAPI documents. Consistent with capability declaration — this is inferred from whe 424 1
x-requiresUser `x-requiresUser` appears on operations. Its value is a boolean flag. Used by a single provider across 17 OpenAPI documents. Consistent with capability declaration — this is inferred from where the key 424 1
x-supportsCursorBasedPaging `x-supportsCursorBasedPaging` appears on operations. Its value is a boolean flag. Used by a single provider across 17 OpenAPI documents. Consistent with capability declaration — this is inferred from 424 1
x-supportsCursorBasedPagingWithoutTotal `x-supportsCursorBasedPagingWithoutTotal` appears on operations. Its value is a boolean flag. Used by a single provider across 17 OpenAPI documents. Consistent with capability declaration — this is in 424 1
x-supportsOffsetBasedPaging `x-supportsOffsetBasedPaging` appears on operations. Its value is a boolean flag. Used by a single provider across 17 OpenAPI documents. Consistent with capability declaration — this is inferred from 424 1
x-supportsOffsetBasedPagingWithoutTotal `x-supportsOffsetBasedPagingWithoutTotal` appears on operations. Its value is a boolean flag. Used by a single provider across 17 OpenAPI documents. Consistent with capability declaration — this is in 424 1
x-supportsPermissionDeniedResponse `x-supportsPermissionDeniedResponse` appears on operations. Its value is a boolean flag. Used by a single provider across 17 OpenAPI documents. Consistent with capability declaration — this is inferre 424 1
x-supportsPush `x-supportsPush` appears on operations. Its value is a boolean flag. Used by a single provider across 17 OpenAPI documents. Consistent with capability declaration — this is inferred from where the key 424 1
x-pd-requires-scope `x-pd-requires-scope` appears on operations. Its value is a string. Used by a single provider across 1 OpenAPI document. Observed values include `services.write`, `services.read`, `incidents.read`, `s 310 1
x-requires-authentication `x-requires-authentication` appears on operations. Its value is a boolean flag. Used by a single provider across 12 OpenAPI documents. Consistent with capability declaration — this is inferred from wh 60 1
x-konfig-operation-can-have-single-parameter
vendor
`x-konfig-operation-can-have-single-parameter` appears on operations. Its value is a boolean flag. Used by a single provider across 1 OpenAPI document. It sits in the `x-konfig-` namespace, so its mea 53 1
x-supports-streaming `x-supports-streaming` appears on operations. Its value is a boolean flag. Used by a single provider across 1 OpenAPI document. Consistent with capability declaration — this is inferred from where the 25 1
x-requires-administrator `x-requires-administrator` appears on operations. Its value is a boolean flag. Used by a single provider across 1 OpenAPI document. Consistent with capability declaration — this is inferred from where 20 1
x-feature-flag `x-feature-flag` appears on operations. Its value is a string. Used by 2 providers across 2 OpenAPI documents. Observed values include `user-groups-enabled`, `p1ax-1984-configuration-promotion`, `user 15 2
x-cdm-capability `x-cdm-capability` appears on operations. Its value is a list. Used by a single provider across 1 OpenAPI document. Consistent with capability declaration — this is inferred from where the key appears 7 1
x-gremlin-feature-flag `x-gremlin-feature-flag` appears on operations. Its value is a string. Used by a single provider across 1 OpenAPI document. Observed values include `gcp-ihc`. Consistent with capability declaration — 4 1
x-requires-api-key `x-requires-api-key` appears on operations. Its value is a boolean flag. Used by a single provider across 1 OpenAPI document. Consistent with capability declaration — this is inferred from where the k 4 1
x-requires-owner `x-requires-owner` appears on operations. Its value is a boolean flag. Used by a single provider across 1 OpenAPI document. Consistent with capability declaration — this is inferred from where the key 3 1
x-box-requires-admin
vendor
`x-box-requires-admin` appears on operations. Its value is a boolean flag. Used by a single provider across 2 OpenAPI documents. It sits in the `x-box-` namespace, so its meaning is defined by box too 2 1
x-ms-has-immutability-policy
vendor
`x-ms-has-immutability-policy` appears on header objects. Its value is a structured object. Used by a single provider across 1 OpenAPI document. It sits in the `x-ms-` namespace, so its meaning is def 1 1
x-requiresEnv `x-requiresEnv` appears on parameter objects. Its value is a string. Used by a single provider across 1 OpenAPI document. Observed values include `API_ALLOW_SKIP_PAGINATION`. Consistent with capabilit 1 1

Work with this as data

Every extension here is available over the APIs.io API and to AI agents over MCP. OpenAPI Extensions is not yet its own endpoint on the v1 API. Reach it through catalog search and the tag graph, or the MCP server.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi extensions

3 MCP tools reach this
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
Search the catalog
curl "https://apis.io/api/v1/search?q=capability-declaration&limit=10"
Everything under a tag
curl "https://apis.io/api/v1/tags/capability-declaration"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.