Install a service from a registry

Resolves the registry source URL, downloads the definition from the returned downloadUrl, validates the manifest, and stores it. Optional adapter and id override the registry defaults. The registry source URL is stored for future updates.

POST /services/install

Install a service from a registry

cURL

curl --request POST \
  --url http://localhost:9371/services/install \
  --header 'Content-Type: application/json' \
  --data '
{
  "source": "<string>",
  "adapter": "<string>",
  "id": "<string>"
}
'

201

{
  "id": "<string>"
}

Body

application/json

Request body used to install a service from a registry.

source · string · required

Registry URL to resolve for service metadata, then download the definition.

Minimum string length: 1

adapter · string

Optional adapter module identifier. Overrides registry default.

Minimum string length: 1

id · string

Optional service identifier. Overrides registry default.

Minimum string length: 1

Response

201

application/json

The service was installed and stored.

Response returned after a service is installed.

id · string · required

Identifier assigned to the newly installed service.

Minimum string length: 1