On this page

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

StatusDescriptionBody
200Successful operationapplication/json: SampleListResponseDto
400Invalid parametersapplication/json: BaseResponseDto
401Authentication requiredapplication/json: BaseResponseDto
403Not authorizedapplication/json: BaseResponseDto
404Resource not foundapplication/json: BaseResponseDto
409Object is not in the correct stateapplication/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

NameInRequiredTypeDescription
idpathtruestringSample identifier minLength: 1

Responses

StatusDescriptionBody
200Successful operationapplication/json: SampleResponseDto
400Invalid parametersapplication/json: BaseResponseDto
401Authentication requiredapplication/json: BaseResponseDto
403Not authorizedapplication/json: BaseResponseDto
404Resource not foundapplication/json: BaseResponseDto
409Object is not in the correct stateapplication/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

NameInRequiredTypeDescription
idpathtruestringSample identifier minLength: 1

Responses

StatusDescriptionBody
200Successful operationapplication/json: SampleOperationResponseDto
400Invalid parametersapplication/json: BaseResponseDto
401Authentication requiredapplication/json: BaseResponseDto
403Not authorizedapplication/json: BaseResponseDto
404Resource not foundapplication/json: BaseResponseDto
409Object is not in the correct stateapplication/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

NameInRequiredTypeDescription
idpathtruestringSample identifier minLength: 1

Responses

StatusDescriptionBody
200Successful operationapplication/json: SampleOperationResponseDto
400Invalid parametersapplication/json: BaseResponseDto
401Authentication requiredapplication/json: BaseResponseDto
403Not authorizedapplication/json: BaseResponseDto
404Resource not foundapplication/json: BaseResponseDto
409Object is not in the correct stateapplication/json: BaseResponseDto
Golden 3.0.0 · Published 2026-10-04