Api referenceWorkspaces

Rebuild Control Room

Reference for Rebuild Control Room in the Hyperoru v1 API, including request, response, and authentication details.

POST/v1/workspaces/{workspace_id}/control-room/rebuild

Rebuild Control Room. Returns a typed response and a request ID for operational support.

Authorization

hyperoru_session<token>

Opaque HttpOnly customer session. Mutations also require X-CSRF-Token.

In: cookie

Path Parameters

workspace_id*Workspace Id
Formatuuid

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/control-room/rebuild"
{
  "calculation_version": "control-room-v1",
  "generated_at": "2019-08-24T14:15:22Z",
  "match_suggestions": [
    {
      "algorithm_version": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "decided_at": "2019-08-24T14:15:22Z",
      "decided_by": "4accc021-c0cc-4c2c-8a78-605a0ed6da31",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "left_finding_id": "ab2a9365-93af-4416-a93b-fd7875de25e2",
      "method": "string",
      "rationale": "string",
      "right_finding_id": "04e9a9b0-eb9d-42f5-b48d-e87078ac0e25",
      "similarity": "string",
      "state": "pending"
    }
  ],
  "recent_transitions": [
    {
      "actor_id": "04f37679-bfbf-4906-b749-01756515cecf",
      "created_at": "2019-08-24T14:15:22Z",
      "evidence_ids": [
        "string"
      ],
      "expires_at": "2019-08-24T14:15:22Z",
      "finding_id": "feebf65a-2eaa-4fae-aab2-772450efdffe",
      "from_state": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "metadata_json": {},
      "reason": "string",
      "supersedes_transition_id": "f9ff0de1-fe00-468e-90d4-e52542ee49f3",
      "to_state": "new",
      "verification_audit_id": "cef6c8ad-7eed-4189-9f94-26d2342cdd25",
      "version": 0
    }
  ],
  "recurring_findings": [
    {
      "architecture_confidence": "0",
      "architecture_disposition": "pending",
      "architecture_impact": "critical",
      "audit_id": "78c04fa6-cfb4-46a0-9aa5-3681ba4f3897",
      "auto_disposition": false,
      "component_identity": "string",
      "cvss_score": "string",
      "evidence_revision": "string",
      "fingerprint_algorithm_version": "finding-v1",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "identity_fingerprint": "string",
      "last_seen_at": "2019-08-24T14:15:22Z",
      "lifecycle_started_at": "2019-08-24T14:15:22Z",
      "lifecycle_state": "new",
      "lifecycle_updated_at": "2019-08-24T14:15:22Z",
      "lifecycle_version": 1,
      "locations": [
        {}
      ],
      "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
      "repository_id": "b349ae61-b973-4c6c-a5e0-89183ba99ff3",
      "risk_severity": "string",
      "risk_total": "string",
      "rule_id": "string",
      "scanner_severity": "string",
      "severity_source": "cvss",
      "sla_due_at": "2019-08-24T14:15:22Z",
      "source_family": "scanner",
      "source_tools": [
        {
          "rule_id": "string",
          "tool": "string",
          "version": "string"
        }
      ],
      "state": "new",
      "title": "string",
      "tool": "string"
    }
  ],
  "snapshots": [
    {
      "architecture_impact_counts": {
        "property1": 0,
        "property2": 0
      },
      "as_of": "2019-08-24T14:15:22Z",
      "calculation_version": "string",
      "counts": {
        "property1": 0,
        "property2": 0
      },
      "freshness_percent": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "mttr_hours": "string",
      "recurring_count": 0,
      "score": "string",
      "severity_counts": {
        "property1": 0,
        "property2": 0
      },
      "source_transition_version": 0,
      "time_to_decision_hours": "string",
      "window": "24h"
    }
  ]
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.hyperoru.com/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.hyperoru.com/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.hyperoru.com/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.hyperoru.com/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.hyperoru.com/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.hyperoru.com/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.hyperoru.com/problems/validation_failed"
}