Install a service

Downloads a registry definition, validates the manifest, and stores it as a new service. The source may be a direct URL or a structured object containing a file_url. Installation does not automatically enable the service.

POST /services/install

Install a service

cURL

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

201

{
  "name": "<string>",
  "type": "<string>"
}

Body

application/json

Request body used to install a service manifest from a registry definition file.

type · string · required

Service adapter type to install, such as a registry or transport implementation.

Minimum string length: 1

source · string object · required

Registry definition location. The controller normalizes this before downloading the manifest.

Minimum string length: 1

Response

201

application/json

The service was installed and stored.

Response returned after successfully installing a new service.

name · string · required

Normalized service name assigned to the installed manifest.

Minimum string length: 1

type · string · required

Service adapter type selected during installation.

Minimum string length: 1