On this page
Sample projects API
Generated Golden API operations for Sample projects.
Golden 3.0.0 public API reference. Parameters, responses, and schemas for supported customer operations.
4 operations.
GET /api/samples
Lists the available sample projects.
Operation ID: listSamples
Returns every sample project this build ships, each saying whether it is currently installed. Requires the ADMIN role.
Security: bearerAuth
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful operation | application/json: SampleListResponseDto |
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/samples/{id}
Retrieves a sample project.
Operation ID: getSample
Locates a sample project by identifier and returns it, including whether it is installed. Requires the ADMIN role.
Security: bearerAuth
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | true | string | Sample identifier minLength: 1 |
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful operation | application/json: SampleResponseDto |
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/samples/{id}
Removes a sample project.
Operation ID: removeSample
Removes everything the sample created: its records, resources, tables, entity, uploaded files, and the task schedulings it produced together with their runs. Nothing outside the sample’s own identifier prefixes is touched. Asynchronous - returns a task identifier to poll. Requires the ADMIN role.
Security: bearerAuth
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | true | string | Sample identifier minLength: 1 |
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful operation | application/json: SampleOperationResponseDto |
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 |
POST /api/samples/{id}/install
Installs a sample project.
Operation ID: installSample
Removes any previous copy of the sample and installs it: uploads its data files, imports its resources, tables and entity, and runs a full load, index and classification. Asynchronous - returns a task identifier to poll. Installing is also how a sample is reinstalled, because installing over an existing copy cannot work. Requires the ADMIN role.
Security: bearerAuth
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | true | string | Sample identifier minLength: 1 |
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful operation | application/json: SampleOperationResponseDto |
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 |