Discover services

Searches service manifests by name and description. If the request omits enabled, only enabled services are returned by default. Set enabled to null to include both enabled and disabled services.

POST /discover/services

Discover services

cURL

curl --request POST \
  --url http://localhost:7687/discover/services \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "limit": 1,
  "enabled": true
}
'

200

{
  "services": [
    {
      "name": "<string>",
      "type": "<string>",
      "source": "<string>",
      "description": "<string>",
      "hash": "<string>",
      "enabled": true
    }
  ]
}

Body

application/json

Request body used to discover services.

query · string

Free-text query used to match service names and descriptions.

limit · integer

Maximum number of matching services to return.

Required range: x > 0

enabled · boolean | null

When set, returns only enabled services, only disabled services, or both when null.

Response

200

application/json

Service discovery results.

Response body returned by the service discovery endpoint.

services · object[] · required

Discovered services that satisfy the supplied search query and enabled filter.

Show child attributes