Ignores (v1)

This document uses the v1 API, which will eventually be deprecated, as further Snyk developments are now focused on the REST API. For more details, see the v1 API.

List all ignores

get

Ignores from .snyk files are not included here. Ignores from Policies are not included here. Temporary ignores include an expires attribute, while permanent ignores do not.

Required permissions

• View Organization
• View Project
• View Project Ignores

Path parameters

orgIdstringrequired

The organization ID to list ignores for. The API_KEY must have access to this organization.

Example: 4a18d42f-0706-4ad0-b127-24078731fbed

projectIdstringrequired

The project ID to list ignores for.

Example: 463c1ee5-31bc-428c-b451-b79a3270db08

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.snyk.io/v1/org/{orgId}/project/{projectId}/ignores'

200

200

{
  "issueId": [
    {
      "ignorePath": {
        "reason": "text",
        "reasonType": "not-vulnerable",
        "ignoredBy": {
          "name": "text",
          "email": "text",
          "id": "text"
        },
        "disregardIfFixable": true,
        "expires": "text",
        "created": "text"
      }
    }
  ]
}

Replace ignores

put

It is possible to modify/retrieve ignored vulnerability or license issues for a given organization and project. Ignores from .snyk files are not included here

Required permissions

• View Organization
• View Project Ignores
• Edit Project Ignores

Path parameters

orgIdstringrequired

The organization ID to modify ignores for. The API_KEY must have access to this organization.

Example: 4a18d42f-0706-4ad0-b127-24078731fbed

projectIdstringrequired

The project ID to modify ignores for.

Example: 463c1ee5-31bc-428c-b451-b79a3270db08

issueIdstringrequired

The issue ID to modify ignores for. Can be a vulnerability or a license Issue.

Example: npm:qs:20140806-1

Body

ignorePathstringoptional

The path to ignore (default is * which represents all paths).

reasonstringoptional

The reason that the issue was ignored.

reasonTypeall ofoptional

The classification of the ignore.

The classification of the ignore.

disregardIfFixablebooleanrequired

Only ignore the issue if no upgrade or patch is available.

expiresstringoptional

The timestamp that the issue will no longer be ignored.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api.snyk.io/v1/org/{orgId}/project/{projectId}/ignore/{issueId}' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "ignorePath": "",
      "reason": "",
      "reasonType": "not-vulnerable",
      "disregardIfFixable": false,
      "expires": ""
    }
  ]'

200

200

[
  {
    "ignorePath": {
      "reason": "text",
      "reasonType": "not-vulnerable",
      "ignoredBy": {
        "name": "text",
        "email": "text",
        "id": "text"
      },
      "disregardIfFixable": true,
      "expires": "text",
      "created": "text"
    }
  }
]

Add ignore

post

It is possible to modify/retrieve ignored vulnerability or license issues for a given organization and project. Ignores from .snyk files are not included here

Required permissions

• View Organization
• View Project Ignores
• Create new project ignores

Path parameters

orgIdstringrequired

The organization ID to modify ignores for. The API_KEY must have access to this organization.

Example: 4a18d42f-0706-4ad0-b127-24078731fbed

projectIdstringrequired

The project ID to modify ignores for.

Example: 463c1ee5-31bc-428c-b451-b79a3270db08

issueIdstringrequired

The issue ID to modify ignores for. Can be a vulnerability or a license Issue.

Example: npm:qs:20140806-1

Body

ignorePathstringoptional

The path to ignore (default is * which represents all paths).

reasonstringoptional

The reason that the issue was ignored.

reasonTypeall ofrequired

The classification of the ignore.

The classification of the ignore.

disregardIfFixablebooleanrequired

Only ignore the issue if no upgrade or patch is available.

expiresstringoptional

The timestamp that the issue will no longer be ignored.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.snyk.io/v1/org/{orgId}/project/{projectId}/ignore/{issueId}' \
  --header 'Content-Type: application/json' \
  --data '{
    "ignorePath": "",
    "reason": "",
    "reasonType": "not-vulnerable",
    "disregardIfFixable": false,
    "expires": ""
  }'

200

200

{
  "ignorePath": {
    "reason": "text",
    "reasonType": "not-vulnerable",
    "ignoredBy": {
      "name": "text",
      "email": "text",
      "id": "text"
    },
    "disregardIfFixable": true,
    "expires": "text",
    "created": "text"
  }
}

Retrieve ignore

get

It is possible to modify/retrieve ignored vulnerability or license issues for a given organization and project. Ignores from .snyk files are not included here

Required permissions

• View Project
• View Project Ignores

Path parameters

orgIdstringrequired

The organization ID to modify ignores for. The API_KEY must have access to this organization.

Example: 4a18d42f-0706-4ad0-b127-24078731fbed

projectIdstringrequired

The project ID to modify ignores for.

Example: 463c1ee5-31bc-428c-b451-b79a3270db08

issueIdstringrequired

The issue ID to modify ignores for. Can be a vulnerability or a license Issue.

Example: npm:qs:20140806-1

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.snyk.io/v1/org/{orgId}/project/{projectId}/ignore/{issueId}'

200

200

{
  "ignorePath": {
    "reason": "text",
    "reasonType": "not-vulnerable",
    "ignoredBy": {
      "name": "text",
      "email": "text",
      "id": "text"
    },
    "disregardIfFixable": true,
    "expires": "text",
    "created": "text"
  }
}

Delete ignores

delete

It is possible to modify/retrieve ignored vulnerability or license issues for a given organization and project. Ignores from .snyk files are not included here

Required permissions

• View Organization
• View Project Ignores
• Remove Project Ignores

Path parameters

orgIdstringrequired

The organization ID to modify ignores for. The API_KEY must have access to this organization.

Example: 4a18d42f-0706-4ad0-b127-24078731fbed

projectIdstringrequired

The project ID to modify ignores for.

Example: 463c1ee5-31bc-428c-b451-b79a3270db08

issueIdstringrequired

The issue ID to modify ignores for. Can be a vulnerability or a license Issue.

Example: npm:qs:20140806-1

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://api.snyk.io/v1/org/{orgId}/project/{projectId}/ignore/{issueId}'

200

200

No Content