Compliance and policy settings API

  • Tier: Ultimate
  • Offering: GitLab Self-Managed

Use this API to interact with the security policy settings for your GitLab instance.

Prerequisites:

  • You must have administrator access to the instance.
  • Your instance must have the Ultimate tier to use security policies.

Get security policy settings

Gets the current security policy settings for this GitLab instance.

GET /admin/security/compliance_policy_settings
curl --request GET \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/admin/security/compliance_policy_settings"

Example response:

{
  "csp_namespace_id": 42
}

When no CSP namespace is configured:

{
  "csp_namespace_id": null
}

Update security policy settings

Updates the security policy settings for this GitLab instance.

PUT /admin/security/compliance_policy_settings
AttributeTypeRequiredDescription
csp_namespace_idintegeryesID of the group designated to centrally manage security policies. Must be a top-level group. Set to null to clear the setting.
curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --header "Content-Type: application/json" \
  --data '{"csp_namespace_id": 42}' \
  --url "https://gitlab.example.com/api/v4/admin/security/compliance_policy_settings"

Example response:

{
  "csp_namespace_id": 42
}