Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.knoxcall.com/llms.txt

Use this file to discover all available pages before exploring further.

​
GET /admin/migrations/:id

Retrieve full details for a single migration, including a sample of its discovered items.

​
Response

{
  "migration": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "provider": "aws_sm",
    "mode": "pull",
    "status": "awaiting_review",
    "region": "us-east-1",
    "scope": { "regions": ["us-east-1"] },
    "discovered_count": 42,
    "approved_count": 30,
    "rejected_count": 2,
    "committed_count": 0,
    "expired_count": 0,
    "denylisted_count": 1,
    "error_details": null,
    "created_at": "2026-05-20T09:00:00Z",
    "started_at": "2026-05-20T09:00:05Z",
    "completed_at": null
  },
  "items": [
    {
      "id": "item-uuid",
      "source_provider": "aws_sm",
      "source_id": "arn:aws:secretsmanager:us-east-1:111122223333:secret:stripe/prod-abc123",
      "source_path": "stripe/prod",
      "source_region": "us-east-1",
      "source_version": null,
      "source_metadata": {},
      "bucket_classification": "a_https",
      "bucket_classification_source": "heuristic",
      "target_environments": ["production"],
      "status": "pending_review",
      "denylist_reason": null,
      "captured_at": "2026-05-20T09:00:30Z"
    }
  ]
}
bucket_classification is "a_https" (HTTPS API secret) or "b_wire" (database credential). bucket_classification_source is "heuristic" (auto-detected) or "user_override" (reviewer changed it). Items are returned most-recent-first, limited to 200. For full pagination use the items sub-resource (coming in a future API version).