Skip to main content

Endpoints

ReferencePublicUpdated 2026-04-08

Endpoints

Platform

GET /platform/status

Returns current platform health summary.

curl -H "Authorization: Bearer $TOKEN" \
https://console.<your-domain>/api/v1/platform/status
{
"status": "healthy",
"version": "1.3.1",
"template": "run",
"tools": {
"gitlab": "healthy",
"argocd": "healthy",
"keycloak": "healthy",
"vault": "healthy"
},
"compliance_posture": "passing",
"last_custodian_scan": "2026-04-08T02:00:00Z"
}

GET /platform/tools

Returns inventory of all installed tools with version and health.

{
"tools": [
{"name": "gitlab", "version": "17.2.1", "status": "healthy", "namespace": "gitlab"},
{"name": "argocd", "version": "2.10.3", "status": "healthy", "namespace": "argocd"}
]
}

Organizations

GET /orgs

List all organizations on the platform.

{
"orgs": [
{"id": "org-abc123", "name": "my-org", "created_at": "2026-01-15T10:00:00Z"}
]
}

POST /orgs

Create a new organization.

{
"name": "new-org",
"admin_email": "admin@example.com"
}

GET /orgs/{org_id}/users

List users in an organization.

POST /orgs/{org_id}/users

Add a user to an organization.

{
"email": "user@example.com",
"role": "org-user"
}

Valid roles: platform-admin, org-admin, org-privileged, org-user, platform-user


Deployments

GET /orgs/{org_id}/deployments

List deployments for an organization.

{
"deployments": [
{
"id": "deploy-xyz789",
"app_name": "my-app",
"namespace": "my-app",
"status": "healthy",
"image": "registry1.dso.mil/my-app:v1.2.3",
"synced_at": "2026-04-08T14:30:00Z"
}
]
}

POST /orgs/{org_id}/deployments/{deployment_id}/sync

Trigger an ArgoCD sync for a deployment.

{
"prune": true,
"force": false
}

Compliance

GET /guide/compliance/posture

Returns current compliance posture summary.

{
"overall": "passing",
"fips": "compliant",
"disa_stig": {
"status": "compliant",
"controls_passing": 147,
"controls_failing": 0,
"last_scan": "2026-04-08T02:00:00Z"
},
"sbom_coverage": {
"images_with_sbom": 42,
"images_without_sbom": 0
}
}

GET /guide/compliance/sbom/{image_digest}

Returns the SBOM for a specific image digest.

curl -H "Authorization: Bearer $TOKEN" \
"https://console.<your-domain>/api/v1/guide/compliance/sbom/sha256:abc123..."

Returns a CycloneDX JSON SBOM.

GET /guide/compliance/report

Returns a downloadable compliance evidence report (PDF) for ATO package inclusion.