On this page
Configuration API
Generated Golden API operations for Configuration.
Golden 3.0.0 public API reference. Parameters, responses, and schemas for supported customer operations.
7 operations.
POST /api/configuration
Saves a configuration.
Operation ID: saveConfiguration
Saves indicated configuration. Requires the ADMIN role.
Security: bearerAuth
Request body
Configuration to save
| Media type | Required | Schema |
|---|---|---|
application/json | true | ConfigurationRequestDto |
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful operation | application/json: ConfigurationResponseDto |
400 | Invalid parameters | application/json: BaseResponseDto |
401 | Authentication required | application/json: BaseResponseDto |
403 | Not authorized | application/json: BaseResponseDto |
404 | Resource not found | application/json: BaseResponseDto |
409 | Object is not in the correct state | application/json: BaseResponseDto |
GET /api/configuration/category/{category}
Retrieves a configuration by identifier.
Operation ID: listConfigurations
Retrieves a configuration with indicated identifier. Requires the ADMIN role.
Security: bearerAuth
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
category | path | true | string | Configuration category |
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful operation | application/json: ConfigurationListResponseDto |
400 | Invalid parameters | application/json: BaseResponseDto |
401 | Authentication required | application/json: BaseResponseDto |
403 | Not authorized | application/json: BaseResponseDto |
404 | Resource not found | application/json: BaseResponseDto |
409 | Object is not in the correct state | application/json: BaseResponseDto |
DELETE /api/configuration/category/{category}
Deletes configurations by category.
Operation ID: deleteConfigurationsByCategory
Locates all configurations for indicated category and deletes them. 404 when no configuration carries that category, like the delete by identifier. Requires the ADMIN role.
Security: bearerAuth
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
category | path | true | string | Configuration category |
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful operation | application/json: ConfigurationListResponseDto |
400 | Invalid parameters | application/json: BaseResponseDto |
401 | Authentication required | application/json: BaseResponseDto |
403 | Not authorized | application/json: BaseResponseDto |
404 | Resource not found | application/json: BaseResponseDto |
409 | Object is not in the correct state | application/json: BaseResponseDto |
GET /api/configuration/id/{id}
Retrieves a configuration by identifier.
Operation ID: getConfiguration
Retrieves a configuration with indicated identifier. Requires the ADMIN role.
Security: bearerAuth
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | true | string | Configuration identifier |
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful operation | application/json: ConfigurationResponseDto |
400 | Invalid parameters | application/json: BaseResponseDto |
401 | Authentication required | application/json: BaseResponseDto |
403 | Not authorized | application/json: BaseResponseDto |
404 | Resource not found | application/json: BaseResponseDto |
409 | Object is not in the correct state | application/json: BaseResponseDto |
DELETE /api/configuration/id/{id}
Deletes a configuration by identifier.
Operation ID: deleteConfigurationById
Locates a configuration with indicated identifier and deletes it. Requires the ADMIN role.
Security: bearerAuth
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | true | string | Configuration identifier |
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful operation | application/json: ConfigurationResponseDto |
400 | Invalid parameters | application/json: BaseResponseDto |
401 | Authentication required | application/json: BaseResponseDto |
403 | Not authorized | application/json: BaseResponseDto |
404 | Resource not found | application/json: BaseResponseDto |
409 | Object is not in the correct state | application/json: BaseResponseDto |
GET /api/configuration/openapi
Retrieves OpenAPI definition.
Operation ID: getOpenApi
Retrieves latest OpenAPI definition in JSON format. Restricted to authenticated users.
Security: bearerAuth
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful operation | application/json: object |
400 | Invalid parameters | application/json: BaseResponseDto |
401 | Authentication required | application/json: BaseResponseDto |
403 | Not authorized | application/json: BaseResponseDto |
404 | Resource not found | application/json: BaseResponseDto |
409 | Object is not in the correct state | application/json: BaseResponseDto |
GET /api/configuration/version
Retrieves product version.
Operation ID: getVersion
Retrieves product version. Restricted to authenticated users.
Security: bearerAuth
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful operation | application/json: ConfigurationVersionResponseDto |
400 | Invalid parameters | application/json: BaseResponseDto |
401 | Authentication required | application/json: BaseResponseDto |
403 | Not authorized | application/json: BaseResponseDto |
404 | Resource not found | application/json: BaseResponseDto |
409 | Object is not in the correct state | application/json: BaseResponseDto |