Skip to content

Developer portal

POST /pqc/cbom/pull/{provider}

Trigger a cloud pull from provider inventory and ingest the resulting CBOM snapshot.

POST /pqc/cbom/pull/{provider}Auth: viewer | operator | admin

Summary

Trigger a cloud pull from provider inventory and ingest the resulting CBOM snapshot.

Example

Response

{
  "status": "success",
  "provider": "aws",
  "pull": {
    "ok": true,
    "component_count": 58
  },
  "ingest": {
    "ok": true,
    "snapshot_id": "cbom_01J..."
  }
}

Errors

CodeMeaningTypical causeSuggested fix
404Not foundScan, schedule, share link, or resource id does not exist or expired.Verify id and tenant scope; share links expire per expiresHours.
422Unprocessable entityInvalid payload shape, unsupported scenario, or infeasible constraints.Fix field errors in response detail; relax constraints and retry.
429Too many requestsPer-key rate limit exceeded (default 300 requests per minute) or public endpoint limit.Backoff with jitter; cache results; request higher limit for production.
500Internal server errorUnexpected backend failure; includes requestId in response.Retry with exponential backoff; contact support with requestId if persistent.

See the full errors reference.