Check publication status

After you publish security updates, you can check their deployment status using the F5 NGINX Instance Manager REST API.

These endpoints help you verify whether security policies, log profiles, and other configurations were successfully deployed to instances or instance groups.

Use tools such as curl or Postman to send requests to the NGINX Instance Manager REST API. The API base URL is https://<NIM_FQDN>/api/[nim|platform]/<API_VERSION>.
All requests require authentication. For details on authentication methods, see the API overview.

Check publication status for a security policy

To view deployment status for a specific policy, send a GET request to the Security Deployments Associations API using the policy name.

Example:

curl -X GET "https://<NIM_FQDN>/api/platform/v1/security/deployments/associations/ignore-xss" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Replace <NIM_FQDN> with the fully qualified domain name (FQDN) of your NGINX Instance Manager host and <ACCESS_TOKEN> with your access token.

In the response, check the lastDeploymentDetails field under instance or instanceGroup.instances for deployment results.

Check publication status for a security log profile

Example:

curl -X GET "https://<NIM_FQDN>/api/platform/v1/security/deployments/logprofiles/associations/default-log" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

The response includes a lastDeploymentDetails field for each instance or instance group.

Check status for a specific instance

To view deployment status for a specific instance, provide the system UID and instance UID.

Example:

curl -X GET "https://<NIM_FQDN>/api/platform/v1/systems/{system_uid}/instances/{instance_uid}" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Replace {system_uid} with the unique identifier (UID) of the system and {instance_uid} with the unique identifier (UID) of the instance.

In the response, the lastDeploymentDetails field shows deployment status, timestamps, and any related error messages.

Check deployment result by deployment ID

When you use the Publish API to publish security content, NGINX Instance Manager assigns a deployment ID to the request.
You can use this ID to check the final result of the publication.

Example:

curl -X GET "https://<NIM_FQDN>/api/platform/v1/systems/instances/deployments/{deployment_id}" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Replace {deployment_id} with the ID of the deployment.

The response includes detailed deployment information, including success or failure status and any compiler error messages.