Preview a metadata-only inventory import
POST/api/v1/operator/inventory/preview
Requires mcp:inventory:import, current manager permission and MCP_OPERATOR_WRITES_ENABLED. Validates up to 100 normalized records and returns a 15-minute plan showing creates and existing records to keep. Existing records are never overwritten; secrets are rejected. CertOps renewal controls and Job approval do not apply.
Request
Responses
- 200
- 400
- 401
- 402
- 403
- 404
- 422
- 429
- 500
Exact normalized create-only import effect and expiring plan
Response Headers
Cache-Control
Bad request
Unauthorized
Cloud plan or inventory quota refuses the operation
Required connection scope or current workspace role is missing; Cloud also refuses frozen workspaces
Not found
Metadata contains a secret or another unsafe value
Rate limit or pending inventory preview limit reached
Internal server error