Schedule a policy for immediate remediation

Schedule a policy for immediate remediation. Note: Please use this endpoint to execute a policy. See Using Global API Keys for more information on permission and scope requirements.

SecuritybearerAuth
Request
path Parameters
id
required
integer

Policy ID for the specified policy

Example: 123456
query Parameters
o
required
integer

Organization ID for the specified policy

Example: o=123456
Request Body schema: application/json
required
action
required
string

Specify the type of action.

Enum: "remediateAll" "remediateServer"
serverId
integer <int64>

The ID of the target device. Use with remediateServer

Responses
201

Action Started Successfully

400

Invalid Request

401

Access token is missing or invalid

403

You do not have permission to perform this action.

404

Entity not found

429

Too many requests

503

Service Unavailable

default

Invalid Request

post/policies/{id}/action
Request samples
application/json
{
  • "action": "remediateServer",
  • "serverId": 123456
}
Response samples
application/json
{
  • "errors": [
    • "string"
    ]
}