Importing a Policy from File
POST /policies/push/import/file
Imports a new policy and all associated artifacts from a zip file asynchronously. Returns a task ID immediately; poll GET /tasks/{taskId} for the result.
Authentication: Bearer token required (Authorization: Bearer <token>)
Permission: Permissions.POLICIES_POLICY_CREATE
Request
Query Parameters
versionOfTopicId
string
No
—
The topic ID of the policy version to associate
demo
boolean
No
false
Import the policy in demo mode
Request Body
The request body must be the raw binary content of a .zip file exported from Guardian.
Content-Type: application/octet-stream
Response
Success Response
Status: 202 Accepted
Poll GET /tasks/{taskId} to retrieve the result.
Error Responses
401 Unauthorized
Missing or invalid token
403 Forbidden
Insufficient permissions
500 Internal Server Error
Unexpected server failure
Was this helpful?