How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Snyk Policies API

The Policies API from Snyk — 5 operation(s) for policies.

Snyk Policies API is one of 51 APIs that Snyk publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Policies. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 10 operations across 5 paths, and defines 62 schemas. It is described by OpenAPI 3.2.0, at version REST.

Requests are made against a single base URL, https://api.snyk.io/rest.

10 operations 5 paths 62 schemas 2 DELETE4 GET2 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
REST
Base URL
https://api.snyk.io/rest
Authentication
API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Snyk Policies API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (APIToken). It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

  • APIToken — API key value must be prefixed with \"Token \".

Paths & Operations 10

Across 5 paths, the API surfaces 10 operations — 2 DELETE, 4 GET, 2 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Policies 10
GET
/groups/{group_id}/policies
Get group level policies (Early Access)
listGroupPolicies 5 params → 200400401403404
POST
/groups/{group_id}/policies
Create a new group level policy (Early Access)
createGroupPolicy 2 params body → 201400401403404500
DELETE
/groups/{group_id}/policies/{policy_id}
Delete an group-level policy (Early Access)
deleteGroupPolicy 3 params → 204400401403404500
PATCH
/groups/{group_id}/policies/{policy_id}
Update a group-level policy (Early Access)
updateGroupPolicy 3 params body → 200400401403404409
GET
/orgs/{org_id}/policies
Get org-level policies
getOrgPolicies 12 params → 200400401403404
POST
/orgs/{org_id}/policies
Create a new org-level policy
createOrgPolicy 2 params body → 201400401403404500
DELETE
/orgs/{org_id}/policies/{policy_id}
Delete an org-level policy
deleteOrgPolicy 3 params → 204400401403404500
GET
/orgs/{org_id}/policies/{policy_id}
Get an org-level policy
getOrgPolicy 3 params → 200400401403404
PATCH
/orgs/{org_id}/policies/{policy_id}
Update an org-level policy
updateOrgPolicy 3 params body → 200400401403404409
GET
/orgs/{org_id}/policies/{policy_id}/events
List org policy events (Early Access)
getOrgPolicyEvents 6 params → 200400401403404

Schemas 62

The contract defines 62 schemas that model the data the API accepts and returns. The most detailed are PolicyResponseAttributes (8 properties), PolicyEventChanges (8 properties), GroupPolicyResponseAttributes (7 properties), Links (6 properties). Each schema is shown below with its type and property counts.

QueryVersion
string
Requested API version
GroupPolicyConditionSnykAssetFindingV1
object
Matches on the Snyk Asset Finding V1 identifier.
3 properties 3 required
PolicyEventChanges
object
8 properties
GroupPolicyPrincipal
object
3 properties 2 required
ErrorDocument
object
2 properties 2 required
GroupPolicyActionAnnotationData
object
2 properties 1 required
PolicyEventType
string
UpdatePolicyPayload
object
1 property 1 required
GroupPolicyOperator
string
CreatePolicyPayload
object
1 property 1 required
CreateGroupPolicyPayload
object
1 property 1 required
UpdateGroupPolicyPayload
object
1 property 1 required
JsonApi
object
1 property 1 required
GroupPolicyConditionBusinessCriticality
object
Matches on the project business criticality - if business criticality is provided, the policy will only apply to projects with the specified business criticali…
3 properties 3 required
PolicyResponseAttributes
object
8 properties 7 required
PolicyActionIgnoreDataTemporaryIgnore
object
3 properties 2 required
GroupPolicyActionIgnoreData
object
2 properties 1 required
PolicyActionIgnoreDataWontFix
object
3 properties 1 required
GroupPolicyActionIgnore
object
Ignore action
1 property 1 required
PolicyEventResponse
object
3 properties 3 required
GroupPolicyResponseAttributes
object
7 properties 7 required
GroupPolicyResponse
object
3 properties 3 required
GroupPolicyActionAnnotation
object
Annotation action
1 property 1 required
GroupPolicyConditionsGroup
object
2 properties 2 required
GroupPolicyConditionEnvironment
object
Matches on the project environment - if environment is provided, the policy will only apply to projects with the specified environment.
3 properties 3 required
GroupPolicyConditionLifecycle
object
Matches on the project lifecycle - if lifecycle is provided, the policy will only apply to projects with the specified lifecycle.
3 properties 3 required
ActualVersion
string
Resolved API version
GroupPolicyConditionSeverity
object
Matches on the severity.
3 properties 3 required
SelfLink
object
1 property
PolicyResponse
object
3 properties 3 required
UpdatePolicyAttributes
object
Attributes of a policy that can be updated. At least one of 'name', 'conditionsgroup', 'action', or 'review' must be provided. In order to update the review fi…
4 properties
PaginatedLinks
object
5 properties
Meta
object
Free-form object that may contain non-standard information.
PolicyActionIgnoreData__0
object
3 properties 1 required
GroupPolicyConditionCVE
object
Matches on the CVE.
3 properties 3 required
GroupPolicyConditionRuleId
object
Matches on the rule ID.
3 properties 3 required
GroupPolicyActionSeverityOverride
object
Severity override action
1 property 1 required
GroupPolicyRequestAttributes
object
4 properties 4 required
GroupPolicyActionType
string
GroupPolicyConditionCWE
object
Matches on the CWE.
3 properties 3 required
GroupPolicyConditionSnykId
object
Matches on the Snyk ID.
3 properties 3 required
GroupPolicyAction
PolicyActionIgnoreDataNotVulnerable
object
3 properties 1 required
UpdateGroupPolicyAttributes
object
Attributes of a policy that can be updated. At least one of 'name', 'conditionsgroup', 'actiontype', or 'action' must be provided.
4 properties
GroupPolicyConditionOrgID
object
Matches on the organization ID - if org ID is provided, the policy will only apply to the specified organization. If no org ID is provided, the policy will app…
3 properties 3 required
PolicyActionIgnore__0
object
1 property 1 required
PolicyAttributes
object
5 properties 4 required
GroupPolicyConditionExploitMaturity
object
Matches on the exploit maturity.
3 properties 3 required
PolicyReview
string
Review status.
UpdatePolicyReview
string
Review update. To provide an optional message relating to the review state change, add a string 'message' property to the 'meta' object.
PolicyCondition
object
3 properties 3 required
PolicyActionIgnoreData
object
GroupPolicyConditionOperator
string
LinkProperty
PolicyEventAttributes
object
5 properties 4 required
PolicyConditionsGroup
object
2 properties 2 required
PolicyActionIgnore
object
1 property 1 required
SeverityLevel
string
Links
object
6 properties
GroupPolicyActionSeverityOverrideData
object
2 properties 1 required
GroupPolicyConditionProjectTags
object
Matches on the project tags - if project tags are provided, the policy will only apply to projects with the specified tags. The value is a list of key:value pa…
3 properties 3 required
Principal
object
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

snyk-policies-api-openapi.yml Raw ↑

Other APIs Snyk publishes across the network.

Snyk REST API - Apps (OAuth)
Snyk V1 API (Legacy)
Snyk OAuth2 API - Authorize
Snyk OAuth2 API - Token
Snyk MCP Server (Snyk Studio)
Snyk AccessRequests API
Snyk AiBom API
Snyk Apps API
Snyk Asset API
Snyk Audit Logs API
Snyk BrokerConnections API
Snyk BrokerContexts API
Where this information came from

This is an independent, third-party profile of Snyk Policies API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.