API ReferenceTray

Validate a Tray

View as Markdown

Validate a Tray by comparing expected vs actual state.

Compares the expected component configuration against the actual state. Returns a detailed diff report showing missing, extra, and drifted components.

Org must have an Infrastructure Provider entity. User must have FORGE_PROVIDER_ADMIN authorization role.

Authentication

AuthorizationBearer
``` export JWT_BEARER_TOKEN="<jwt-bearer-token>" # Example org name: "acme-inc export ORG_NAME=<org-name> # Use the JWT bearer token in your API request auth header: curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://carbide-rest-api.carbide.svc.cluster.local/v2/org/$ORG_NAME/carbide/user/current ```

Path parameters

orgstringRequired
idstringRequired

Query parameters

siteIdstringRequiredformat: "uuid"
ID of the Site

Response

OK
diffslist of objects
List of component differences found during validation
totalDiffsinteger
Total number of component differences found
missingCountinteger
Number of components expected but missing from the source system
unexpectedCountinteger
Number of components found in the source system but not expected
driftCountinteger
Number of components present in both but with field differences
matchCountinteger
Number of components that match between expected and actual

Errors

400
Bad Request Error
403
Forbidden Error