Base configuration

Update base configuration

PUT/v4/config/consent/data-space/base-configurations

Replaces the data marketplace connection of your organisation, for example after the data marketplace gave you a new client secret. Send all three fields.

Errors: 400 when a field is missing or baseUrl is not a URL; 404 when the organisation has no base configuration (create it with POST).

Language of the request sample

curl -X PUT 'https://demo-api.igrant.io/v4/config/consent/data-space/base-configurations' \
  -H 'Authorization: ApiKey <your-api-key>' \
  -H 'Content-Type: application/json' \
  -d '{
  "baseUrl": "https://data-marketplace.example.com",
  "clientId": "marketplace-client-01",
  "clientSecret": "<client-secret>"
}'

{
  "baseConfigurations": {
    "id": "6af081702d6fb7b6ac6efc63",
    "baseUrl": "https://data-marketplace.example.com",
    "clientId": "marketplace-client-01",
    "clientSecret": "<client-secret>"
  }
}

Authorizations

Authorizationstringheaderrequired
Your API key with the prefix ApiKey: ApiKey <your-api-key>. Get an API key.
Scope:data-space:update

Body

application/json

baseUrlstring<uri>required
Base URL of the data marketplace.
clientIdstringrequired
Client ID that the data marketplace gave to your organisation.
clientSecretstringrequired
Client secret that the data marketplace gave to your organisation.

Response

application/json

The changed base configuration.

baseConfigurationsobject
How your organisation connects to its data marketplace. The service reads <baseUrl>/.well-known/data-space-configuration and gets an access token from the data marketplace with the client credentials. It uses them to tell the data marketplace about your data disclosure agreement templates and records.