diff --git a/docs/.gitbook/assets/rest-spec.json b/docs/.gitbook/assets/rest-spec.json index 9200586fb9fb..829fea436643 100644 --- a/docs/.gitbook/assets/rest-spec.json +++ b/docs/.gitbook/assets/rest-spec.json @@ -335,7 +335,9 @@ "description": "The version of the endpoint requested by the caller.", "example": "2021-06-04", "schema": { - "$ref": "#/components/schemas/QueryVersion" + "description": "Requested API version", + "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", + "type": "string" } }, "VersionServedResponseHeader": { @@ -349,7 +351,9 @@ "description": "The version of the endpoint that was served by the API.", "example": "2021-06-04", "schema": { - "$ref": "#/components/schemas/ActualVersion" + "description": "Resolved API version", + "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", + "type": "string" } }, "VersionStageResponseHeader": { @@ -903,12 +907,11 @@ "style": "form" }, "OrgId": { - "description": "Org ID", + "description": "The unique identifier of the organization.", "in": "path", "name": "org_id", "required": true, "schema": { - "example": "4a18d42f-0706-4ad0-b127-24078731fbed", "format": "uuid", "type": "string" } @@ -1220,21 +1223,12 @@ } }, "Status": { - "description": "An issue's status", - "explode": false, + "description": "Filter by progress status of the resources", "in": "query", "name": "status", "schema": { - "items": { - "enum": [ - "open", - "resolved" - ], - "type": "string" - }, - "type": "array" - }, - "style": "form" + "$ref": "#/components/schemas/ProgressStatus" + } }, "StatusInQuery": { "description": "Filter environments by latest scan status (multi-value, comma-separated)", @@ -1287,13 +1281,12 @@ } }, "Type": { - "description": "An issue type to filter issues.", + "description": "Filter by the learn catalog resource type", "in": "query", "name": "type", "schema": { - "$ref": "#/components/schemas/TypeDef" - }, - "style": "form" + "$ref": "#/components/schemas/ResourceType" + } }, "UpdatedAfter": { "description": "A filter to select issues updated after this date.", @@ -1426,7 +1419,120 @@ "content": { "application/vnd.api+json": { "schema": { - "$ref": "#/components/schemas/ErrorDocument" + "additionalProperties": false, + "example": { + "errors": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "jsonapi": { + "version": "1.0" + } + }, + "properties": { + "errors": { + "example": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "items": { + "additionalProperties": false, + "example": { + "detail": "Not Found", + "status": "404" + }, + "properties": { + "code": { + "description": "An application-specific error code, expressed as a string value.", + "example": "entity-not-found", + "type": "string" + }, + "detail": { + "description": "A human-readable explanation specific to this occurrence of the problem.", + "example": "The request was missing these required fields: ...", + "type": "string" + }, + "id": { + "description": "A unique identifier for this particular occurrence of the problem.", + "example": "f16c31b5-6129-4571-add8-d589da9be524", + "format": "uuid", + "type": "string" + }, + "meta": { + "additionalProperties": true, + "example": { + "key": "value" + }, + "type": "object" + }, + "source": { + "additionalProperties": false, + "example": { + "pointer": "/data/attributes" + }, + "properties": { + "parameter": { + "description": "A string indicating which URI query parameter caused the error.", + "example": "param1", + "type": "string" + }, + "pointer": { + "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", + "example": "/data/attributes", + "type": "string" + } + }, + "type": "object" + }, + "status": { + "description": "The HTTP status code applicable to this problem, expressed as a string value.", + "example": "400", + "pattern": "^[45]\\d\\d$", + "type": "string" + }, + "title": { + "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", + "example": "Bad request", + "type": "string" + } + }, + "required": [ + "status", + "detail" + ], + "type": "object" + }, + "minItems": 1, + "type": "array" + }, + "jsonapi": { + "additionalProperties": false, + "example": { + "version": "1.0" + }, + "properties": { + "version": { + "description": "Version of the JSON API specification this server supports.", + "example": "1.0", + "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "type": "string" + } + }, + "required": [ + "version" + ], + "type": "object" + } + }, + "required": [ + "jsonapi", + "errors" + ], + "type": "object" } } }, @@ -1460,7 +1566,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token or a token with more permissions.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" @@ -1486,7 +1592,120 @@ "content": { "application/vnd.api+json": { "schema": { - "$ref": "#/components/schemas/ErrorDocument" + "additionalProperties": false, + "example": { + "errors": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "jsonapi": { + "version": "1.0" + } + }, + "properties": { + "errors": { + "example": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "items": { + "additionalProperties": false, + "example": { + "detail": "Not Found", + "status": "404" + }, + "properties": { + "code": { + "description": "An application-specific error code, expressed as a string value.", + "example": "entity-not-found", + "type": "string" + }, + "detail": { + "description": "A human-readable explanation specific to this occurrence of the problem.", + "example": "The request was missing these required fields: ...", + "type": "string" + }, + "id": { + "description": "A unique identifier for this particular occurrence of the problem.", + "example": "f16c31b5-6129-4571-add8-d589da9be524", + "format": "uuid", + "type": "string" + }, + "meta": { + "additionalProperties": true, + "example": { + "key": "value" + }, + "type": "object" + }, + "source": { + "additionalProperties": false, + "example": { + "pointer": "/data/attributes" + }, + "properties": { + "parameter": { + "description": "A string indicating which URI query parameter caused the error.", + "example": "param1", + "type": "string" + }, + "pointer": { + "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", + "example": "/data/attributes", + "type": "string" + } + }, + "type": "object" + }, + "status": { + "description": "The HTTP status code applicable to this problem, expressed as a string value.", + "example": "400", + "pattern": "^[45]\\d\\d$", + "type": "string" + }, + "title": { + "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", + "example": "Bad request", + "type": "string" + } + }, + "required": [ + "status", + "detail" + ], + "type": "object" + }, + "minItems": 1, + "type": "array" + }, + "jsonapi": { + "additionalProperties": false, + "example": { + "version": "1.0" + }, + "properties": { + "version": { + "description": "Version of the JSON API specification this server supports.", + "example": "1.0", + "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "type": "string" + } + }, + "required": [ + "version" + ], + "type": "object" + } + }, + "required": [ + "jsonapi", + "errors" + ], + "type": "object" } } }, @@ -1520,25 +1739,25 @@ } } }, - "description": "Unauthorized: the request requires an authentication token or a token with more permissions.", + "description": "Forbidden: the request requires an authentication token with more or different permissions.", "headers": { "deprecation": { - "$ref": "#/components/headers/DeprecationHeader__0" + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader__0" + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader__0" + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader__0" + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader__0" + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "$ref": "#/components/headers/SunsetHeader__0" + "$ref": "#/components/headers/SunsetHeader" } } }, @@ -1576,7 +1795,120 @@ "content": { "application/vnd.api+json": { "schema": { - "$ref": "#/components/schemas/ErrorDocument" + "additionalProperties": false, + "example": { + "errors": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "jsonapi": { + "version": "1.0" + } + }, + "properties": { + "errors": { + "example": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "items": { + "additionalProperties": false, + "example": { + "detail": "Not Found", + "status": "404" + }, + "properties": { + "code": { + "description": "An application-specific error code, expressed as a string value.", + "example": "entity-not-found", + "type": "string" + }, + "detail": { + "description": "A human-readable explanation specific to this occurrence of the problem.", + "example": "The request was missing these required fields: ...", + "type": "string" + }, + "id": { + "description": "A unique identifier for this particular occurrence of the problem.", + "example": "f16c31b5-6129-4571-add8-d589da9be524", + "format": "uuid", + "type": "string" + }, + "meta": { + "additionalProperties": true, + "example": { + "key": "value" + }, + "type": "object" + }, + "source": { + "additionalProperties": false, + "example": { + "pointer": "/data/attributes" + }, + "properties": { + "parameter": { + "description": "A string indicating which URI query parameter caused the error.", + "example": "param1", + "type": "string" + }, + "pointer": { + "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", + "example": "/data/attributes", + "type": "string" + } + }, + "type": "object" + }, + "status": { + "description": "The HTTP status code applicable to this problem, expressed as a string value.", + "example": "400", + "pattern": "^[45]\\d\\d$", + "type": "string" + }, + "title": { + "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", + "example": "Bad request", + "type": "string" + } + }, + "required": [ + "status", + "detail" + ], + "type": "object" + }, + "minItems": 1, + "type": "array" + }, + "jsonapi": { + "additionalProperties": false, + "example": { + "version": "1.0" + }, + "properties": { + "version": { + "description": "Version of the JSON API specification this server supports.", + "example": "1.0", + "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "type": "string" + } + }, + "required": [ + "version" + ], + "type": "object" + } + }, + "required": [ + "jsonapi", + "errors" + ], + "type": "object" } } }, @@ -1606,7 +1938,120 @@ "content": { "application/vnd.api+json": { "schema": { - "$ref": "#/components/schemas/ErrorDocument" + "additionalProperties": false, + "example": { + "errors": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "jsonapi": { + "version": "1.0" + } + }, + "properties": { + "errors": { + "example": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "items": { + "additionalProperties": false, + "example": { + "detail": "Not Found", + "status": "404" + }, + "properties": { + "code": { + "description": "An application-specific error code, expressed as a string value.", + "example": "entity-not-found", + "type": "string" + }, + "detail": { + "description": "A human-readable explanation specific to this occurrence of the problem.", + "example": "The request was missing these required fields: ...", + "type": "string" + }, + "id": { + "description": "A unique identifier for this particular occurrence of the problem.", + "example": "f16c31b5-6129-4571-add8-d589da9be524", + "format": "uuid", + "type": "string" + }, + "meta": { + "additionalProperties": true, + "example": { + "key": "value" + }, + "type": "object" + }, + "source": { + "additionalProperties": false, + "example": { + "pointer": "/data/attributes" + }, + "properties": { + "parameter": { + "description": "A string indicating which URI query parameter caused the error.", + "example": "param1", + "type": "string" + }, + "pointer": { + "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", + "example": "/data/attributes", + "type": "string" + } + }, + "type": "object" + }, + "status": { + "description": "The HTTP status code applicable to this problem, expressed as a string value.", + "example": "400", + "pattern": "^[45]\\d\\d$", + "type": "string" + }, + "title": { + "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", + "example": "Bad request", + "type": "string" + } + }, + "required": [ + "status", + "detail" + ], + "type": "object" + }, + "minItems": 1, + "type": "array" + }, + "jsonapi": { + "additionalProperties": false, + "example": { + "version": "1.0" + }, + "properties": { + "version": { + "description": "Version of the JSON API specification this server supports.", + "example": "1.0", + "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "type": "string" + } + }, + "required": [ + "version" + ], + "type": "object" + } + }, + "required": [ + "jsonapi", + "errors" + ], + "type": "object" } } }, @@ -1666,7 +2111,120 @@ "content": { "application/vnd.api+json": { "schema": { - "$ref": "#/components/schemas/ErrorDocument" + "additionalProperties": false, + "example": { + "errors": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "jsonapi": { + "version": "1.0" + } + }, + "properties": { + "errors": { + "example": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "items": { + "additionalProperties": false, + "example": { + "detail": "Not Found", + "status": "404" + }, + "properties": { + "code": { + "description": "An application-specific error code, expressed as a string value.", + "example": "entity-not-found", + "type": "string" + }, + "detail": { + "description": "A human-readable explanation specific to this occurrence of the problem.", + "example": "The request was missing these required fields: ...", + "type": "string" + }, + "id": { + "description": "A unique identifier for this particular occurrence of the problem.", + "example": "f16c31b5-6129-4571-add8-d589da9be524", + "format": "uuid", + "type": "string" + }, + "meta": { + "additionalProperties": true, + "example": { + "key": "value" + }, + "type": "object" + }, + "source": { + "additionalProperties": false, + "example": { + "pointer": "/data/attributes" + }, + "properties": { + "parameter": { + "description": "A string indicating which URI query parameter caused the error.", + "example": "param1", + "type": "string" + }, + "pointer": { + "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", + "example": "/data/attributes", + "type": "string" + } + }, + "type": "object" + }, + "status": { + "description": "The HTTP status code applicable to this problem, expressed as a string value.", + "example": "400", + "pattern": "^[45]\\d\\d$", + "type": "string" + }, + "title": { + "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", + "example": "Bad request", + "type": "string" + } + }, + "required": [ + "status", + "detail" + ], + "type": "object" + }, + "minItems": 1, + "type": "array" + }, + "jsonapi": { + "additionalProperties": false, + "example": { + "version": "1.0" + }, + "properties": { + "version": { + "description": "Version of the JSON API specification this server supports.", + "example": "1.0", + "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "type": "string" + } + }, + "required": [ + "version" + ], + "type": "object" + } + }, + "required": [ + "jsonapi", + "errors" + ], + "type": "object" } } }, @@ -4422,6 +4980,9 @@ "format": "uuid", "type": "string" }, + "links": { + "$ref": "#/components/schemas/ErrorLink" + }, "meta": { "additionalProperties": true, "example": { @@ -4679,46 +5240,7 @@ }, "properties": { "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] + "$ref": "#/components/schemas/LinkProperty" } }, "type": "object" @@ -6104,123 +6626,7 @@ "properties": { "errors": { "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" + "$ref": "#/components/schemas/Error" }, "type": "array" } @@ -6405,19 +6811,7 @@ "type": "string" }, "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" + "$ref": "#/components/schemas/Meta" } }, "required": [ @@ -7933,8 +8327,7 @@ "ProgressStatus": { "enum": [ "completed", - "inProgress", - "todo" + "inProgress" ], "type": "string" }, @@ -9302,6 +9695,7 @@ "type": "object" }, "ResourceType": { + "default": "lesson", "enum": [ "learning_path", "lesson" @@ -11113,6 +11507,102 @@ } }, "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get a custom base image collection", + "tags": [ + "Custom Base Images" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-08-21", + "2023-09-20", + "2024-01-04", + "2024-05-31" + ], + "x-snyk-api-resource": "custombaseimages", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-31", + "x-stability-level": "stable" + }, + "post": { + "description": "In order to create a custom base image, you first need to import your base images into Snyk.\nYou can do this through the CLI, UI, or API.\n\nThis endpoint marks an image as a custom base image. This means that the image will get\nadded to the pool of images from which Snyk can recommend base image upgrades.\n\nNote, after the first image in a repository gets added, a versioning schema cannot be passed in this endpoint.\nTo update the versioning schema, the PATCH endpoint must be used.\n", + "operationId": "createCustomBaseImage", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/CustomBaseImagePostRequest" + } + } + }, + "description": "The properties used in the creation of a custom base image" + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/CustomBaseImageResponse" + } + } + }, + "description": "Successfully created a custom base image", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -11285,7 +11775,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -11346,269 +11836,568 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Create a Custom Base Image from an existing container project", + "tags": [ + "Custom Base Images" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-08-21", + "2023-09-20", + "2024-01-04", + "2024-05-31" + ], + "x-snyk-api-resource": "custombaseimages", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-31", + "x-stability-level": "stable" + } + }, + "/custom_base_images/{custombaseimage_id}": { + "delete": { + "description": "Delete a custom base image resource. (the related container project is unaffected)", + "operationId": "deleteCustomBaseImage", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/CustomBaseImageId" + } + ], + "responses": { + "204": { + "description": "Successfully deleted the custom base image", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, "401": { + "$ref": "#/components/responses/401" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Delete a custom base image", + "tags": [ + "Custom Base Images" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-08-21", + "2023-09-20", + "2024-01-04", + "2024-05-31" + ], + "x-snyk-api-resource": "custombaseimages", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-31", + "x-stability-level": "stable" + }, + "get": { + "description": "Get a custom base image", + "operationId": "getCustomBaseImage", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/CustomBaseImageId" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/CustomBaseImageResponse" + } + } + }, + "description": "Returns a custom base image", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get a custom base image", + "tags": [ + "Custom Base Images" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-08-21", + "2023-09-20", + "2024-01-04", + "2024-05-31" + ], + "x-snyk-api-resource": "custombaseimages", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-31", + "x-stability-level": "stable" + }, + "patch": { + "description": "Updates a custom base image's attributes", + "operationId": "updateCustomBaseImage", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/CustomBaseImageId" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/CustomBaseImagePatchRequest" + } + } + }, + "description": "custom base image to be updated" + }, + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/CustomBaseImageResponse" + } + } + }, + "description": "Returns the updated custom base image", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Update a custom base image", + "tags": [ + "Custom Base Images" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-08-21", + "2023-09-20", + "2024-01-04", + "2024-05-31" + ], + "x-snyk-api-resource": "custombaseimages", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-31", + "x-stability-level": "stable" + } + }, + "/groups": { + "get": { + "description": "Returns a list of groups which a user is a member of", + "operationId": "listGroups", + "parameters": [ + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], + "data": { "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" + "$ref": "#/components/schemas/Group" }, - "minItems": 1, "type": "array" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "A list of groups is returned", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get all groups", + "tags": [ + "Groups" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-01-31~experimental", + "2023-01-30~beta" + ], + "x-snyk-api-resource": "groups", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2023-01-30~beta", + "x-stability-level": "beta" + } + }, + "/groups/{group_id}": { + "get": { + "description": "Returns a group by its ID", + "operationId": "getGroup", + "parameters": [ + { + "description": "The ID of the group", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "$ref": "#/components/schemas/Group" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" + } + }, + "required": [ + "jsonapi", + "data", + "links" + ], + "type": "object" + } + } + }, + "description": "Group is returned", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get a group", + "tags": [ + "Groups" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-01-31~experimental", + "2023-01-30~beta" + ], + "x-snyk-api-resource": "groups", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2023-01-30~beta", + "x-stability-level": "beta" + } + }, + "/groups/{group_id}/apps/installs": { + "get": { + "description": "Get a list of apps installed for a group.", + "operationId": "getAppInstallsForGroup", + "parameters": [ + { + "description": "Expand relationships.", + "explode": false, + "in": "query", + "name": "expand", + "schema": { + "items": { + "enum": [ + "app" + ], + "type": "string" + }, + "type": "array" + }, + "style": "form" + }, + { + "description": "Group ID", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "items": { + "$ref": "#/components/schemas/AppInstallData" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "required": [ + "data", + "jsonapi", + "links" + ], + "type": "object" + } + } + }, + "description": "A list of apps installed for the specified group.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "example": { + "errors": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "jsonapi": { + "version": "1.0" + } + }, + "properties": { + "errors": { + "example": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "items": { + "additionalProperties": false, + "example": { + "detail": "Not Found", + "status": "404" }, "properties": { "code": { @@ -11753,7 +12542,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -11814,7 +12603,7 @@ } } }, - "404": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -11987,7 +12776,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -12048,7 +12837,10 @@ } } }, - "500": { + "403": { + "$ref": "#/components/responses/403" + }, + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -12221,7 +13013,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -12281,77 +13073,8 @@ } } } - } - }, - "summary": "Get a custom base image collection", - "tags": [ - "Custom Base Images" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-08-21", - "2023-09-20", - "2024-01-04", - "2024-05-31" - ], - "x-snyk-api-resource": "custombaseimages", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-31", - "x-stability-level": "stable" - }, - "post": { - "description": "In order to create a custom base image, you first need to import your base images into Snyk.\nYou can do this through the CLI, UI, or API.\n\nThis endpoint marks an image as a custom base image. This means that the image will get\nadded to the pool of images from which Snyk can recommend base image upgrades.\n\nNote, after the first image in a repository gets added, a versioning schema cannot be passed in this endpoint.\nTo update the versioning schema, the PATCH endpoint must be used.\n", - "operationId": "createCustomBaseImage", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/CustomBaseImagePostRequest" - } - } }, - "description": "The properties used in the creation of a custom base image" - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/CustomBaseImageResponse" - } - } - }, - "description": "Successfully created a custom base image", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -12524,7 +13247,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -12585,7 +13308,7 @@ } } }, - "401": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -12758,7 +13481,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -12818,8 +13541,162 @@ } } } + } + }, + "summary": "Get a list of apps installed for a group.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-19~experimental", + "2023-11-03", + "2024-05-23" + ], + "x-snyk-api-resource": "app_installs", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-23", + "x-stability-level": "stable" + }, + "post": { + "description": "Install a Snyk Apps to this group, the Snyk App must use unattended authentication eg client credentials.", + "operationId": "createGroupAppInstall", + "parameters": [ + { + "$ref": "#/components/parameters/Version" }, - "403": { + { + "description": "Group ID", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "properties": { + "type": { + "enum": [ + "app_install" + ], + "example": "app_install", + "type": "string" + } + }, + "type": "object" + }, + "relationships": { + "additionalProperties": false, + "properties": { + "app": { + "additionalProperties": false, + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "id": { + "$ref": "#/components/schemas/Uuid" + }, + "type": { + "enum": [ + "app" + ], + "example": "app", + "type": "string" + } + }, + "required": [ + "id", + "type" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + }, + "required": [ + "app" + ], + "type": "object" + } + }, + "required": [ + "data", + "relationships" + ], + "type": "object" + } + } + }, + "description": "App Install to be created" + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/AppInstallWithClient" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "required": [ + "data", + "jsonapi", + "links" + ], + "type": "object" + } + } + }, + "description": "The newly created app install.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "schema": { + "type": "string" + } + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -12992,7 +13869,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -13053,7 +13930,7 @@ } } }, - "404": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -13226,7 +14103,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -13287,7 +14164,10 @@ } } }, - "409": { + "403": { + "$ref": "#/components/responses/403" + }, + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -13460,7 +14340,7 @@ } } }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -13521,7 +14401,7 @@ } } }, - "500": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -13694,7 +14574,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -13754,62 +14634,8 @@ } } } - } - }, - "summary": "Create a Custom Base Image from an existing container project", - "tags": [ - "Custom Base Images" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-08-21", - "2023-09-20", - "2024-01-04", - "2024-05-31" - ], - "x-snyk-api-resource": "custombaseimages", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-31", - "x-stability-level": "stable" - } - }, - "/custom_base_images/{custombaseimage_id}": { - "delete": { - "description": "Delete a custom base image resource. (the related container project is unaffected)", - "operationId": "deleteCustomBaseImage", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/CustomBaseImageId" - } - ], - "responses": { - "204": { - "description": "Successfully deleted the custom base image", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } }, - "401": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -13982,7 +14808,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -14042,8 +14868,76 @@ } } } + } + }, + "summary": "Install a Snyk Apps to this group.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-19~experimental", + "2023-11-03", + "2024-05-23" + ], + "x-snyk-api-resource": "app_installs", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-23", + "x-stability-level": "stable" + } + }, + "/groups/{group_id}/apps/installs/{install_id}": { + "delete": { + "description": "Revoke app authorization for an Snyk Group with install ID.", + "operationId": "deleteGroupAppInstallById", + "parameters": [ + { + "$ref": "#/components/parameters/Version" }, - "404": { + { + "description": "Group ID", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/InstallId" + } + ], + "responses": { + "204": { + "description": "The app install has been de-authorized.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "schema": { + "type": "string" + } + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -14216,7 +15110,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -14277,7 +15171,7 @@ } } }, - "500": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -14450,7 +15344,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -14510,67 +15404,11 @@ } } } - } - }, - "summary": "Delete a custom base image", - "tags": [ - "Custom Base Images" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-08-21", - "2023-09-20", - "2024-01-04", - "2024-05-31" - ], - "x-snyk-api-resource": "custombaseimages", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-31", - "x-stability-level": "stable" - }, - "get": { - "description": "Get a custom base image", - "operationId": "getCustomBaseImage", - "parameters": [ - { - "$ref": "#/components/parameters/Version" }, - { - "$ref": "#/components/parameters/CustomBaseImageId" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/CustomBaseImageResponse" - } - } - }, - "description": "Returns a custom base image", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } + "403": { + "$ref": "#/components/responses/403" }, - "400": { + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -14743,7 +15581,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -14804,7 +15642,7 @@ } } }, - "401": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -14977,7 +15815,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -15038,7 +15876,7 @@ } } }, - "403": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -15211,7 +16049,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -15271,8 +16109,148 @@ } } } + } + }, + "summary": "Revoke app authorization for an Snyk Group with install ID.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-19~experimental", + "2023-11-03", + "2024-05-23" + ], + "x-snyk-api-resource": "app_installs", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-23", + "x-stability-level": "stable" + } + }, + "/groups/{group_id}/apps/installs/{install_id}/secrets": { + "post": { + "description": "Manage client secret for non-interactive Snyk App installations.", + "operationId": "updateGroupAppInstallSecret", + "parameters": [ + { + "$ref": "#/components/parameters/Version" }, - "404": { + { + "description": "Group ID", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/InstallId" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { + "additionalProperties": false, + "properties": { + "mode": { + "description": "Operation to perform:\n * `replace` - Replace existing secrets with a new generated\nsecret\n * `create` - Add a new secret, preserving existing secrets\n * `delete` - Remove an existing secret by value\n", + "enum": [ + "replace", + "create", + "delete" + ], + "type": "string" + }, + "secret": { + "description": "Secret to delete when using `delete` mode", + "type": "string" + } + }, + "required": [ + "mode" + ], + "type": "object" + }, + "type": { + "enum": [ + "app" + ], + "type": "string" + } + }, + "required": [ + "attributes", + "type" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + } + }, + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/AppInstallDataWithSecret" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/SelfLink" + } + }, + "type": "object" + } + } + }, + "description": "Secret has been updated.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "schema": { + "type": "string" + } + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -15445,7 +16423,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -15506,7 +16484,7 @@ } } }, - "500": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -15679,7 +16657,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -15739,77 +16717,245 @@ } } } - } - }, - "summary": "Get a custom base image", - "tags": [ - "Custom Base Images" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-08-21", - "2023-09-20", - "2024-01-04", - "2024-05-31" - ], - "x-snyk-api-resource": "custombaseimages", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-31", - "x-stability-level": "stable" - }, - "patch": { - "description": "Updates a custom base image's attributes", - "operationId": "updateCustomBaseImage", - "parameters": [ - { - "$ref": "#/components/parameters/Version" }, - { - "$ref": "#/components/parameters/CustomBaseImageId" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/CustomBaseImagePatchRequest" - } - } + "403": { + "$ref": "#/components/responses/403" }, - "description": "custom base image to be updated" - }, - "responses": { - "200": { + "404": { "content": { "application/vnd.api+json": { "schema": { - "$ref": "#/components/schemas/CustomBaseImageResponse" + "additionalProperties": false, + "example": { + "errors": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "jsonapi": { + "version": "1.0" + } + }, + "properties": { + "errors": { + "example": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "items": { + "additionalProperties": false, + "example": { + "detail": "Not Found", + "status": "404" + }, + "properties": { + "code": { + "description": "An application-specific error code, expressed as a string value.", + "example": "entity-not-found", + "type": "string" + }, + "detail": { + "description": "A human-readable explanation specific to this occurrence of the problem.", + "example": "The request was missing these required fields: ...", + "type": "string" + }, + "id": { + "description": "A unique identifier for this particular occurrence of the problem.", + "example": "f16c31b5-6129-4571-add8-d589da9be524", + "format": "uuid", + "type": "string" + }, + "links": { + "additionalProperties": false, + "description": "A link that leads to further details about this particular occurrance of the problem.", + "example": { + "about": "https://example.com/about_this_error" + }, + "properties": { + "about": { + "example": "https://example.com/api/resource", + "oneOf": [ + { + "description": "A string containing the link’s URL.", + "example": "https://example.com/api/resource", + "type": "string" + }, + { + "additionalProperties": false, + "example": { + "href": "https://example.com/api/resource" + }, + "properties": { + "href": { + "description": "A string containing the link’s URL.", + "example": "https://example.com/api/resource", + "type": "string" + }, + "meta": { + "additionalProperties": true, + "description": "Free-form object that may contain non-standard information.", + "example": { + "key1": "value1", + "key2": { + "sub_key": "sub_value" + }, + "key3": [ + "array_value1", + "array_value2" + ] + }, + "type": "object" + } + }, + "required": [ + "href" + ], + "type": "object" + } + ] + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": true, + "example": { + "key": "value" + }, + "type": "object" + }, + "source": { + "additionalProperties": false, + "example": { + "pointer": "/data/attributes" + }, + "properties": { + "parameter": { + "description": "A string indicating which URI query parameter caused the error.", + "example": "param1", + "type": "string" + }, + "pointer": { + "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", + "example": "/data/attributes", + "type": "string" + } + }, + "type": "object" + }, + "status": { + "description": "The HTTP status code applicable to this problem, expressed as a string value.", + "example": "400", + "pattern": "^[45]\\d\\d$", + "type": "string" + }, + "title": { + "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", + "example": "Bad request", + "type": "string" + } + }, + "required": [ + "status", + "detail" + ], + "type": "object" + }, + "minItems": 1, + "type": "array" + }, + "jsonapi": { + "additionalProperties": false, + "example": { + "version": "1.0" + }, + "properties": { + "version": { + "description": "Version of the JSON API specification this server supports.", + "example": "1.0", + "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "type": "string" + } + }, + "required": [ + "version" + ], + "type": "object" + } + }, + "required": [ + "jsonapi", + "errors" + ], + "type": "object" } } }, - "description": "Returns the updated custom base image", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" + "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", + "example": "2021-07-01T00:00:00Z", + "schema": { + "format": "date-time", + "type": "string" + } }, "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" + "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", + "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", + "schema": { + "format": "uuid", + "type": "string" + } }, "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" + "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", + "schema": { + "enum": [ + "wip", + "experimental", + "beta", + "ga", + "deprecated", + "sunset" + ], + "example": "ga", + "type": "string" + } }, "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" + "description": "A header containing the version of the endpoint requested by the caller.", + "example": "2021-06-04", + "schema": { + "description": "Requested API version", + "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", + "type": "string" + } }, "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" + "description": "A header containing the version of the endpoint that was served by the API.", + "example": "2021-06-04", + "schema": { + "description": "Resolved API version", + "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", + "type": "string" + } }, "sunset": { - "$ref": "#/components/headers/SunsetHeader" + "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", + "example": "2021-08-02", + "schema": { + "format": "date", + "type": "string" + } } } }, - "400": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -15982,7 +17128,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -16043,7 +17189,7 @@ } } }, - "401": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -16216,7 +17362,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -16276,6 +17422,266 @@ } } } + } + }, + "summary": "Manage client secret for non-interactive Snyk App installations.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-19~experimental", + "2023-11-03", + "2024-05-23" + ], + "x-snyk-api-resource": "app_installs", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-23", + "x-stability-level": "stable" + } + }, + "/groups/{group_id}/audit_logs/search": { + "get": { + "description": "Search audit logs for a Group. \"api.access\" events are omitted from results unless explicitly requested using the events parameter. Some Organization level events are supported as well as the following\nGroup level events:\n - api.access\n - group.cloud_config.settings.edit\n - group.create\n - group.delete\n - group.edit\n - group.notification_settings.edit\n - group.org.add\n - group.org.remove\n - group.policy.create\n - group.policy.delete\n - group.policy.edit\n - group.request_access_settings.edit\n - group.role.create\n - group.role.delete\n - group.role.edit\n - group.service_account.create\n - group.service_account.delete\n - group.service_account.edit\n - group.settings.edit\n - group.settings.feature_flag.edit\n - group.sso.add\n - group.sso.auth0_connection.create\n - group.sso.auth0_connection.edit\n - group.sso.create\n - group.sso.delete\n - group.sso.edit\n - group.sso.membership.sync\n - group.sso.remove\n - group.tag.create\n - group.tag.delete\n - group.user.add\n - group.user.remove\n - group.user.role.edit\n", + "operationId": "listGroupAuditLogs", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "The ID of the Group.", + "example": "0d3728ec-eebf-484d-9907-ba238019f10b", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Cursor" + }, + { + "$ref": "#/components/parameters/From" + }, + { + "$ref": "#/components/parameters/To" + }, + { + "$ref": "#/components/parameters/Size" + }, + { + "description": "Order in which results are returned.", + "example": "ASC", + "in": "query", + "name": "sort_order", + "schema": { + "default": "DESC", + "enum": [ + "ASC", + "DESC" + ], + "type": "string" + } + }, + { + "description": "Filter logs by user ID.", + "example": "0d3728ec-eebf-484d-9907-ba238019f10b", + "in": "query", + "name": "user_id", + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "Filter logs by project ID.", + "example": "0d3728ec-eebf-484d-9907-ba238019f10b", + "in": "query", + "name": "project_id", + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Events" + }, + { + "$ref": "#/components/parameters/ExcludeEvents" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/AuditLogSearch" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" + } + }, + "required": [ + "jsonapi", + "data" + ], + "type": "object" + } + } + }, + "description": "Group Audit Logs.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "schema": { + "type": "string" + } + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Search Group audit logs.", + "tags": [ + "Audit Logs" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-09-11", + "2024-04-29" + ], + "x-snyk-api-resource": "audit-logs", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-04-29", + "x-stability-level": "stable" + } + }, + "/groups/{group_id}/issues": { + "get": { + "description": "Get a list of a group's issues.", + "operationId": "listGroupIssues", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/GroupId" + }, + { + "$ref": "#/components/parameters/ScanItemId" + }, + { + "$ref": "#/components/parameters/ScanItemType" + }, + { + "description": "An issue type to filter issues.", + "in": "query", + "name": "type", + "schema": { + "description": "The type of an issue.", + "enum": [ + "package_vulnerability", + "license", + "cloud", + "code", + "custom", + "config" + ], + "example": "cloud", + "type": "string" + }, + "style": "form" + }, + { + "$ref": "#/components/parameters/UpdatedBefore" + }, + { + "$ref": "#/components/parameters/UpdatedAfter" + }, + { + "$ref": "#/components/parameters/CreatedBefore" + }, + { + "$ref": "#/components/parameters/CreatedAfter" + }, + { + "$ref": "#/components/parameters/EffectiveSeverityLevel" + }, + { + "description": "An issue's status", + "explode": false, + "in": "query", + "name": "status", + "schema": { + "items": { + "enum": [ + "open", + "resolved" + ], + "type": "string" + }, + "type": "array" + }, + "style": "form" + }, + { + "$ref": "#/components/parameters/Ignored" + } + ], + "responses": { + "200": { + "$ref": "#/components/responses/ListIssues200" + }, + "401": { + "$ref": "#/components/responses/401__0" }, "403": { "content": { @@ -16324,58 +17730,6 @@ "format": "uuid", "type": "string" }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, "meta": { "additionalProperties": true, "example": { @@ -16450,10 +17804,10 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Unauthorized: the request requires an authentication token or a token with more permissions.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", + "description": "The deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", "example": "2021-07-01T00:00:00Z", "schema": { "format": "date-time", @@ -16461,7 +17815,7 @@ } }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", + "description": "A unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", "schema": { "format": "uuid", @@ -16469,7 +17823,7 @@ } }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", + "description": "The version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", "schema": { "enum": [ "wip", @@ -16484,7 +17838,7 @@ } }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", + "description": "The version of the endpoint requested by the caller.", "example": "2021-06-04", "schema": { "description": "Requested API version", @@ -16493,7 +17847,7 @@ } }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", + "description": "The version of the endpoint that was served by the API.", "example": "2021-06-04", "schema": { "description": "Resolved API version", @@ -16512,6 +17866,54 @@ } }, "404": { + "$ref": "#/components/responses/404__0" + }, + "500": { + "$ref": "#/components/responses/500__0" + } + }, + "summary": "Get issues by group ID", + "tags": [ + "Issues" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-03-10~experimental", + "2023-09-29~beta", + "2024-01-23" + ], + "x-snyk-api-resource": "issues", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-01-23", + "x-stability-level": "stable" + } + }, + "/groups/{group_id}/issues/{issue_id}": { + "get": { + "description": "Get an issue", + "operationId": "getGroupIssueByIssueID", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/GroupId" + }, + { + "$ref": "#/components/parameters/PathIssueId20240123" + } + ], + "responses": { + "200": { + "$ref": "#/components/responses/GetIssue20020240123" + }, + "400": { + "$ref": "#/components/responses/400__0" + }, + "401": { + "$ref": "#/components/responses/401__0" + }, + "403": { "content": { "application/vnd.api+json": { "schema": { @@ -16558,58 +17960,6 @@ "format": "uuid", "type": "string" }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, "meta": { "additionalProperties": true, "example": { @@ -16684,10 +18034,10 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Unauthorized: the request requires an authentication token or a token with more permissions.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", + "description": "The deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", "example": "2021-07-01T00:00:00Z", "schema": { "format": "date-time", @@ -16695,7 +18045,7 @@ } }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", + "description": "A unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", "schema": { "format": "uuid", @@ -16703,7 +18053,7 @@ } }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", + "description": "The version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", "schema": { "enum": [ "wip", @@ -16718,7 +18068,7 @@ } }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", + "description": "The version of the endpoint requested by the caller.", "example": "2021-06-04", "schema": { "description": "Requested API version", @@ -16727,7 +18077,7 @@ } }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", + "description": "The version of the endpoint that was served by the API.", "example": "2021-06-04", "schema": { "description": "Resolved API version", @@ -16745,28 +18095,262 @@ } } }, + "404": { + "$ref": "#/components/responses/404__0" + }, + "409": { + "$ref": "#/components/responses/409" + }, "500": { + "$ref": "#/components/responses/500__0" + } + }, + "summary": "Get an issue", + "tags": [ + "Issues" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-01-23" + ], + "x-snyk-api-resource": "issues", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-01-23", + "x-stability-level": "stable" + } + }, + "/groups/{group_id}/memberships": { + "get": { + "description": "Returns all memberships of the group", + "operationId": "listGroupMemberships", + "parameters": [ + { + "description": "The ID of the group", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/SortBy__0" + }, + { + "$ref": "#/components/parameters/SortOrder__0" + }, + { + "$ref": "#/components/parameters/EmailFilter" + }, + { + "$ref": "#/components/parameters/UserIdFilter" + }, + { + "$ref": "#/components/parameters/UsernameFilter" + }, + { + "$ref": "#/components/parameters/RoleFilter" + }, + { + "$ref": "#/components/parameters/IncludeGroupMembershipCount" + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], + "properties": { + "data": { + "$ref": "#/components/schemas/GroupMembershipResponseData" + }, "jsonapi": { - "version": "1.0" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" + "required": [ + "jsonapi", + "data", + "links" + ], + "type": "object" + } + } + }, + "description": "List of group memberships is returned", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get all memberships of the group", + "tags": [ + "Groups" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-05-09~experimental", + "2024-08-25" + ], + "x-snyk-api-resource": "groups", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-08-25", + "x-stability-level": "stable" + }, + "post": { + "description": "Create a group membership for a user with role", + "operationId": "createGroupMembership", + "parameters": [ + { + "description": "The ID of the group", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/CreateGroupMembershipRequestBody" + } + } + } + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "$ref": "#/components/schemas/GroupMembership" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" + } + }, + "type": "object" + } + } + }, + "description": "Membership for the group was created", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "example": { + "errors": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "jsonapi": { + "version": "1.0" + } + }, + "properties": { + "errors": { + "example": [ + { + "detail": "Permission denied for this resource", + "status": "403" } ], "items": { @@ -16918,7 +18502,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -16978,72 +18562,54 @@ } } } + }, + "500": { + "$ref": "#/components/responses/500" } }, - "summary": "Update a custom base image", + "summary": "Create a group membership for a user with role", "tags": [ - "Custom Base Images" + "Groups" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2023-08-21", - "2023-09-20", - "2024-01-04", - "2024-05-31" + "2024-05-09~experimental", + "2024-08-25" ], - "x-snyk-api-resource": "custombaseimages", + "x-snyk-api-resource": "groups", "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-31", + "x-snyk-api-version": "2024-08-25", "x-stability-level": "stable" } }, - "/groups": { - "get": { - "description": "Returns a list of groups which a user is a member of", - "operationId": "listGroups", + "/groups/{group_id}/memberships/{membership_id}": { + "delete": { + "description": "Deletes a membership from a group", + "operationId": "deleteGroupMembership", "parameters": [ { - "$ref": "#/components/parameters/StartingAfter" + "description": "The ID of the group", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } }, { - "$ref": "#/components/parameters/EndingBefore" + "$ref": "#/components/parameters/MembershipId" }, { - "$ref": "#/components/parameters/Limit" + "$ref": "#/components/parameters/Cascade" }, { "$ref": "#/components/parameters/Version" } ], "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/Group" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "A list of groups is returned", + "204": { + "description": "group membership is deleted from Group", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" @@ -17066,6 +18632,18 @@ } }, "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -17238,7 +18816,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -17299,7 +18877,203 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Delete a membership from a group", + "tags": [ + "Groups" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-05-09~experimental", + "2024-08-25" + ], + "x-snyk-api-resource": "groups", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-08-25", + "x-stability-level": "stable" + }, + "patch": { + "description": "Update a role from a group membership", + "operationId": "updateGroupUserMembership", + "parameters": [ + { + "description": "The ID of the group", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/MembershipId" + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "$ref": "#/components/schemas/MembershipPatchRequestBody" + } + }, + "type": "object" + } + } + } + }, + "responses": { + "204": { + "$ref": "#/components/responses/204" + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Update a role from a group membership", + "tags": [ + "Groups" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-05-09~experimental", + "2024-08-25" + ], + "x-snyk-api-resource": "groups", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-08-25", + "x-stability-level": "stable" + } + }, + "/groups/{group_id}/org_memberships": { + "get": { + "description": "Get list of org memberships of a group user", + "operationId": "listGroupUserOrgMemberships", + "parameters": [ + { + "description": "The ID of the group", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/UserId" + }, + { + "$ref": "#/components/parameters/OrgName" + }, + { + "$ref": "#/components/parameters/RoleFilter" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "items": { + "$ref": "#/components/schemas/GroupMembershipOrgMembership" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" + }, + "meta": { + "properties": { + "org_membership_count": { + "description": "Org memberships for this user within this group.", + "type": "number" + } + }, + "type": "object" + } + }, + "required": [ + "jsonapi", + "data", + "links" + ], + "type": "object" + } + } + }, + "description": "A list of org memberships is returned", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -17472,7 +19246,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -17533,731 +19307,572 @@ } } }, - "403": { + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get list of org memberships of a group user", + "tags": [ + "Groups" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-05-07~experimental", + "2024-08-25" + ], + "x-snyk-api-resource": "groups", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-08-25", + "x-stability-level": "stable" + } + }, + "/groups/{group_id}/orgs": { + "get": { + "description": "Get a paginated list of all the organizations belonging to the group.\nBy default, this endpoint returns the organizations in alphabetical order of their name.", + "operationId": "listOrgsInGroup", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/PathGroupId" + }, + { + "$ref": "#/components/parameters/QueryNameFilter" + }, + { + "$ref": "#/components/parameters/QuerySlugFilter" + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], + "data": { "items": { "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { + "attributes": { "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", + "access_requests_enabled": { + "description": "Whether the organization permits access requests from users who are not members of the organization.", + "example": false, + "type": "boolean" + }, + "created_at": { + "description": "The time the organization was created.", + "example": "2022-03-16T00:00:00Z", + "format": "date-time", "type": "string" }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", + "group_id": { + "description": "The Snyk ID of the group to which the organization belongs.", + "example": "59d6d97e-3106-4ebb-b608-352fad9c5b34", + "format": "uuid", + "type": "string" + }, + "is_personal": { + "description": "Whether the organization is independent (that is, not part of a group).", + "example": true, + "type": "boolean" + }, + "name": { + "description": "The display name of the organization.", + "example": "My Org", + "type": "string" + }, + "slug": { + "description": "The canonical (unique and URL-friendly) name of the organization.", + "example": "my-org", + "type": "string" + }, + "updated_at": { + "description": "The time the organization was last modified.", + "example": "2022-03-16T00:00:00Z", + "format": "date-time", "type": "string" } }, + "required": [ + "name", + "slug", + "is_personal" + ], "type": "object" }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", + "id": { + "description": "The Snyk ID of the organization.", + "example": "59d6d97e-3106-4ebb-b608-352fad9c5b34", + "format": "uuid", "type": "string" }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", + "type": { + "example": "resource", + "pattern": "^[a-z][a-z0-9]*(_[a-z][a-z0-9]*)*$", "type": "string" } }, "required": [ - "status", - "detail" + "type", + "id", + "attributes" ], "type": "object" }, - "minItems": 1, "type": "array" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "A list of organizations in the group.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "List all organizations in group", + "tags": [ + "Orgs" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-10-24~experimental", + "2023-12-14~beta", + "2024-02-28" + ], + "x-snyk-api-resource": "orgs", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-02-28", + "x-stability-level": "stable" + } + }, + "/groups/{group_id}/service_accounts": { + "get": { + "description": "Get all service accounts for a group.", + "operationId": "getManyGroupServiceAccount", + "parameters": [ + { + "description": "The ID of the Snyk Group that owns the service accounts.", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], + "data": { "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" + "$ref": "#/components/schemas/ServiceAccount" }, - "minItems": 1, "type": "array" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "A list of service accounts is returned.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get a list of group service accounts.", + "tags": [ + "ServiceAccounts" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-09-07" + ], + "x-snyk-api-resource": "service_accounts", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-07", + "x-stability-level": "stable" + }, + "post": { + "description": "Create a service account for a group. The service account can be used to access the Snyk API.", + "operationId": "createGroupServiceAccount", + "parameters": [ + { + "description": "The ID of the Snyk Group that is creating and owns the service account", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" + "access_token_ttl_seconds": { + "description": "The time, in seconds, that a generated access token will be valid for. Defaults to 1 hour if unset. Only used when auth_type is one of the oauth_* variants.", + "maximum": 86400, + "minimum": 3600, + "type": "number" }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", + "auth_type": { + "description": "Authentication strategy for the service account:\n * api_key - Regular Snyk API Key.\n * oauth_client_secret - OAuth2 client_credentials grant, which returns a client secret that can be used to retrieve an access token.\n * oauth_private_key_jwt - OAuth2 client_credentials grant, using private_key_jwt client_assertion as laid out in OIDC Connect Core 1.0, section 9.", + "enum": [ + "api_key", + "oauth_client_secret", + "oauth_private_key_jwt" + ], "type": "string" }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", + "jwks_url": { + "description": "A JWKs URL hosting your public keys, used to verify signed JWT requests. Must be https. Required only when auth_type is oauth_private_key_jwt.", "type": "string" }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", + "name": { + "description": "A human-friendly name for the service account.", "type": "string" }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", + "role_id": { + "description": "The ID of the role which the created service account should use.", + "format": "uuid", "type": "string" } }, "required": [ - "status", - "detail" + "name", + "auth_type", + "role_id" ], "type": "object" }, - "minItems": 1, - "type": "array" + "type": { + "description": "The Resource type.", + "enum": [ + "service_account" + ], + "type": "string" + } + }, + "required": [ + "type", + "attributes" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + }, + "required": true + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/ServiceAccount" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data" ], "type": "object" } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "A new service account has been created", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" } }, - "summary": "Get all groups", + "summary": "Create a service account for a group.", "tags": [ - "Groups" + "ServiceAccounts" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2022-01-31~experimental", - "2023-01-30~beta" + "2023-09-07" ], - "x-snyk-api-resource": "groups", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2023-01-30~beta", - "x-stability-level": "beta" + "x-snyk-api-resource": "service_accounts", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-07", + "x-stability-level": "stable" } }, - "/groups/{group_id}": { + "/groups/{group_id}/service_accounts/{serviceaccount_id}": { + "delete": { + "description": "Permanently delete a group-level service account by its ID.", + "operationId": "deleteOneGroupServiceAccount", + "parameters": [ + { + "description": "The ID of the Snyk Group that owns the service account.", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "The ID of the service account.", + "in": "path", + "name": "serviceaccount_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "204": { + "description": "Service account was successfully deleted.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Delete a group service account.", + "tags": [ + "ServiceAccounts" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-09-07" + ], + "x-snyk-api-resource": "service_accounts", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-07", + "x-stability-level": "stable" + }, "get": { - "description": "Returns a group by its ID", - "operationId": "getGroup", + "description": "Get a group-level service account by its ID.", + "operationId": "getOneGroupServiceAccount", "parameters": [ { - "description": "The ID of the group", + "description": "The ID of the Snyk Group that owns the service account.", "in": "path", "name": "group_id", "required": true, @@ -18266,6 +19881,16 @@ "type": "string" } }, + { + "description": "The ID of the service account.", + "in": "path", + "name": "serviceaccount_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, { "$ref": "#/components/parameters/Version" } @@ -18275,9 +19900,10 @@ "content": { "application/vnd.api+json": { "schema": { + "additionalProperties": false, "properties": { "data": { - "$ref": "#/components/schemas/Group" + "$ref": "#/components/schemas/ServiceAccount" }, "jsonapi": { "$ref": "#/components/schemas/JsonApi" @@ -18295,11 +19921,14 @@ } } }, - "description": "Group is returned", + "description": "Service account is returned.", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, "snyk-request-id": { "$ref": "#/components/headers/RequestIdResponseHeader" }, @@ -18318,1214 +19947,626 @@ } }, "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get a group service account.", + "tags": [ + "ServiceAccounts" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-09-07" + ], + "x-snyk-api-resource": "service_accounts", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-07", + "x-stability-level": "stable" + }, + "patch": { + "description": "Update the name of a group's service account by its ID.", + "operationId": "updateGroupServiceAccount", + "parameters": [ + { + "description": "The ID of the Snyk Group that owns the service account.", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "The ID of the service account.", + "in": "path", + "name": "serviceaccount_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { + "additionalProperties": false, + "properties": { + "name": { + "description": "A human-friendly name for the service account. Must be unique within the group.", "type": "string" } }, "required": [ - "status", - "detail" + "name" ], "type": "object" }, - "minItems": 1, - "type": "array" + "id": { + "description": "The ID of the service account. Must match the id in the url path.", + "format": "uuid", + "type": "string" + }, + "type": { + "description": "The Resource type.", + "enum": [ + "service_account" + ], + "type": "string" + } + }, + "required": [ + "type", + "id", + "attributes" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/ServiceAccount" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Service account is returned.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Update a group service account.", + "tags": [ + "ServiceAccounts" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-09-07" + ], + "x-snyk-api-resource": "service_accounts", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-07", + "x-stability-level": "stable" + } + }, + "/groups/{group_id}/service_accounts/{serviceaccount_id}/secrets": { + "post": { + "description": "Manage the client secret of a group service account by the service account ID.", + "operationId": "updateServiceAccountSecret", + "parameters": [ + { + "description": "The ID of the Snyk Group that owns the service account.", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "The ID of the service account.", + "in": "path", + "name": "serviceaccount_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", + "mode": { + "description": "Operation to perform:\n * `replace` - Replace existing secrets with a new generated secret.\n * `create` - Add a new secret, preserving existing secrets. A maximum of to two secrets can exist at a time.\n * `delete` - Remove an existing secret by value. At least one secret must remain per service account.\n", + "enum": [ + "replace", + "create", + "delete" + ], "type": "string" }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", + "secret": { + "description": "Secret to delete when using `delete` mode", "type": "string" } }, "required": [ - "status", - "detail" + "mode" ], "type": "object" }, - "minItems": 1, - "type": "array" + "type": { + "description": "The Resource type.", + "enum": [ + "service_account" + ], + "type": "string" + } + }, + "required": [ + "attributes", + "type" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/ServiceAccount" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data" ], "type": "object" } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Service account client secret has been updated.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Manage a group service account's client secret.", + "tags": [ + "ServiceAccounts" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-09-07" + ], + "x-snyk-api-resource": "service_accounts", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-07", + "x-stability-level": "stable" + } + }, + "/groups/{group_id}/settings/iac": { + "get": { + "description": "Get the Infrastructure as Code Settings for a group.", + "operationId": "getIacSettingsForGroup", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "The id of the group whose Infrastructure as Code settings are requested", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" + "data": { + "$ref": "#/components/schemas/GroupIacSettingsResponse" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "The Infrastructure as Code Settings of the group.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get the Infrastructure as Code Settings for a group", + "tags": [ + "IacSettings" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2021-12-09" + ], + "x-snyk-api-resource": "iac_settings", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2021-12-09", + "x-stability-level": "stable" + }, + "patch": { + "description": "Update the Infrastructure as Code Settings for a group.", + "operationId": "updateIacSettingsForGroup", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "The id of the group whose Infrastructure as Code settings are getting updated", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "$ref": "#/components/schemas/GroupIacSettingsRequest" + } + }, + "type": "object" + } + } + } + }, + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], + "properties": { + "data": { + "$ref": "#/components/schemas/GroupIacSettingsResponse" + }, "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "The Infrastructure as Code Settings of the group were updated.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } + "$ref": "#/components/responses/500" } }, - "summary": "Get a group", + "summary": "Update the Infrastructure as Code Settings for a group", "tags": [ - "Groups" + "IacSettings" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2022-01-31~experimental", - "2023-01-30~beta" + "2021-12-09" ], - "x-snyk-api-resource": "groups", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2023-01-30~beta", - "x-stability-level": "beta" + "x-snyk-api-resource": "iac_settings", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2021-12-09", + "x-stability-level": "stable" } }, - "/groups/{group_id}/apps/installs": { - "get": { - "description": "Get a list of apps installed for a group.", - "operationId": "getAppInstallsForGroup", + "/groups/{group_id}/settings/pull_request_template": { + "delete": { + "description": "Delete your groups pull request template. This means Snyk pull requests will start to use the default template for this group.", + "operationId": "deletePullRequestTemplate", "parameters": [ { - "description": "Expand relationships.", - "explode": false, - "in": "query", - "name": "expand", + "description": "Snyk Group ID", + "example": "7626925e-4b0f-11ee-be56-0242ac120002", + "in": "path", + "name": "group_id", + "required": true, "schema": { - "items": { - "enum": [ - "app" - ], - "type": "string" - }, - "type": "array" - }, - "style": "form" + "format": "uuid", + "type": "string" + } }, { - "description": "Group ID", + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "204": { + "$ref": "#/components/responses/204" + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Delete pull request template for group", + "tags": [ + "Pull Request Templates" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-10-13~beta", + "2024-05-08" + ], + "x-snyk-api-resource": "pull-request-templates", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-08", + "x-stability-level": "stable" + }, + "get": { + "description": "Get your groups pull request template", + "operationId": "getPullRequestTemplate", + "parameters": [ + { + "description": "Snyk Group ID", + "example": "7626925e-4b0f-11ee-be56-0242ac120002", "in": "path", "name": "group_id", "required": true, @@ -19552,13 +20593,27 @@ "content": { "application/vnd.api+json": { "schema": { - "additionalProperties": false, "properties": { "data": { - "items": { - "$ref": "#/components/schemas/AppInstallData" + "additionalProperties": false, + "description": "Fetch a pull request template response", + "properties": { + "attributes": { + "$ref": "#/components/schemas/PullRequestTemplateAttributes" + }, + "id": { + "$ref": "#/components/schemas/PullRequsetTemplateId" + }, + "type": { + "$ref": "#/components/schemas/Types" + } }, - "type": "array" + "required": [ + "id", + "type", + "attributes" + ], + "type": "object" }, "jsonapi": { "$ref": "#/components/schemas/JsonApi" @@ -19567,20 +20622,18 @@ "$ref": "#/components/schemas/PaginatedLinks" } }, - "required": [ - "data", - "jsonapi", - "links" - ], "type": "object" } } }, - "description": "A list of apps installed for the specified group.", + "description": "Fetch Pull Request Template for group.", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, "snyk-request-id": { "$ref": "#/components/headers/RequestIdResponseHeader" }, @@ -19599,126299 +20652,825 @@ } }, "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get pull request template for group", + "tags": [ + "Pull Request Templates" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-10-13~beta", + "2024-05-08" + ], + "x-snyk-api-resource": "pull-request-templates", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-08", + "x-stability-level": "stable" + }, + "post": { + "description": "Configures a group level pull request template that will be used on any org or project within that group", + "operationId": "createOrUpdatePullRequestTemplate", + "parameters": [ + { + "description": "Snyk Group ID", + "example": "7626925e-4b0f-11ee-be56-0242ac120002", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { + "$ref": "#/components/schemas/PullRequestTemplateAttributes" }, - "minItems": 1, - "type": "array" + "type": { + "$ref": "#/components/schemas/Types" + } }, - "jsonapi": { + "required": [ + "type", + "attributes" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + }, + "required": true + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { "additionalProperties": false, - "example": { - "version": "1.0" - }, + "description": "Create or update Pull Request Template response", "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" + "attributes": { + "$ref": "#/components/schemas/PullRequestTemplateAttributes" + }, + "id": { + "$ref": "#/components/schemas/PullRequsetTemplateId" + }, + "type": { + "$ref": "#/components/schemas/Types" } }, "required": [ - "version" + "id", + "type", + "attributes" ], "type": "object" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" } }, - "required": [ - "jsonapi", - "errors" - ], "type": "object" } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Pull Request Template created for group.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Create or update pull request template for group", + "tags": [ + "Pull Request Templates" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-10-13~beta", + "2024-05-08" + ], + "x-snyk-api-resource": "pull-request-templates", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-08", + "x-stability-level": "stable" + } + }, + "/groups/{group_id}/sso_connections": { + "get": { + "description": "Returns a list of SSO connections for a group", + "operationId": "listGroupSsoConnections", + "parameters": [ + { + "description": "The ID of the group", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], + "data": { "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" + "$ref": "#/components/schemas/SSOConnection" }, - "minItems": 1, "type": "array" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "List of SSO connections is returned", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get all SSO connections for a group", + "tags": [ + "Groups" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-01-31~experimental", + "2023-01-30~beta" + ], + "x-snyk-api-resource": "groups", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2023-01-30~beta", + "x-stability-level": "beta" + } + }, + "/groups/{group_id}/sso_connections/{sso_id}/users": { + "get": { + "description": "Returns a list of users for a SSO connection", + "operationId": "listGroupSsoConnectionUsers", + "parameters": [ + { + "description": "The ID of the group", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/SsoId" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], + "data": { "items": { "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { + "attributes": { "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", + "active": { + "description": "Whether the user status is enabled or not", + "example": true, + "type": "boolean" + }, + "email": { + "description": "The email of the user.", + "example": "user@someorg.com", + "type": "string" + }, + "membership": { + "properties": { + "created_at": { + "description": "The date the membership was established.", + "example": "2022-09-14T09:19:29.206Z", + "format": "date-time", "type": "string" }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" + "strategy": { + "description": "Whether the membership is a direct, or indirect membership.", + "enum": [ + "direct", + "indirect" ], - "type": "object" + "example": "direct", + "type": "string" } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", + }, + "type": "object" + }, + "name": { + "description": "The name of the user.", + "example": "user", "type": "string" }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", + "username": { + "description": "The username of the user.", + "example": "username", "type": "string" } }, "type": "object" }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", + "id": { + "description": "The Snyk ID corresponding to this user", + "example": "55a348e2-c3ad-4bbc-b40e-9b232d1f4121", + "format": "uuid", "type": "string" }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", + "type": { + "description": "Content type.", + "example": "user", "type": "string" } }, "required": [ - "status", - "detail" + "type", + "id", + "attributes" ], "type": "object" }, - "minItems": 1, "type": "array" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "List of users is returned", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get all users using a given SSO connection", + "tags": [ + "Groups" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-01-31~experimental", + "2023-01-30~beta" + ], + "x-snyk-api-resource": "groups", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2023-01-30~beta", + "x-stability-level": "beta" + } + }, + "/groups/{group_id}/sso_connections/{sso_id}/users/{user_id}": { + "delete": { + "description": "Deletes a user from a Group SSO connection", + "operationId": "deleteUser", + "parameters": [ + { + "description": "The ID of the group", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/SsoId" + }, + { + "$ref": "#/components/parameters/UserId20230130" + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "204": { + "description": "User is deleted from Group SSO connection", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Delete a user from a Group SSO connection", + "tags": [ + "Groups" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-01-31~experimental", + "2023-01-30~beta" + ], + "x-snyk-api-resource": "groups", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2023-01-30~beta", + "x-stability-level": "beta" + } + }, + "/groups/{group_id}/users/{id}": { + "patch": { + "description": "Update a user's membership of the group.\n\nTo remove a user's membership, provide 'null' as the membership parameter (see example).\n\nAt present, only removing memberships is supported by this endpoint. To update a user's group membership, please use\nthe UI or legacy API.\n", + "operationId": "updateUser", + "parameters": [ + { + "description": "The id of the group", + "in": "path", + "name": "group_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "The id of the user", + "in": "path", + "name": "id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "example": { + "data": { + "attributes": { + "membership": null }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get a list of apps installed for a group.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03", - "2024-05-23" - ], - "x-snyk-api-resource": "app_installs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-23", - "x-stability-level": "stable" - }, - "post": { - "description": "Install a Snyk Apps to this group, the Snyk App must use unattended authentication eg client credentials.", - "operationId": "createGroupAppInstall", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Group ID", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "properties": { - "type": { - "enum": [ - "app_install" - ], - "example": "app_install", - "type": "string" - } - }, - "type": "object" - }, - "relationships": { - "additionalProperties": false, - "properties": { - "app": { - "additionalProperties": false, - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "id": { - "$ref": "#/components/schemas/Uuid" - }, - "type": { - "enum": [ - "app" - ], - "example": "app", - "type": "string" - } - }, - "required": [ - "id", - "type" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - }, - "required": [ - "app" - ], - "type": "object" - } - }, - "required": [ - "data", - "relationships" - ], - "type": "object" - } - } - }, - "description": "App Install to be created" - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/AppInstallWithClient" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "required": [ - "data", - "jsonapi", - "links" - ], - "type": "object" - } - } - }, - "description": "The newly created app install.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "schema": { - "type": "string" - } - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Install a Snyk Apps to this group.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03", - "2024-05-23" - ], - "x-snyk-api-resource": "app_installs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-23", - "x-stability-level": "stable" - } - }, - "/groups/{group_id}/apps/installs/{install_id}": { - "delete": { - "description": "Revoke app authorization for an Snyk Group with install ID.", - "operationId": "deleteGroupAppInstallById", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Group ID", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/InstallId" - } - ], - "responses": { - "204": { - "description": "The app install has been de-authorized.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "schema": { - "type": "string" - } - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Revoke app authorization for an Snyk Group with install ID.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03", - "2024-05-23" - ], - "x-snyk-api-resource": "app_installs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-23", - "x-stability-level": "stable" - } - }, - "/groups/{group_id}/apps/installs/{install_id}/secrets": { - "post": { - "description": "Manage client secret for non-interactive Snyk App installations.", - "operationId": "updateGroupAppInstallSecret", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Group ID", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/InstallId" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "additionalProperties": false, - "properties": { - "mode": { - "description": "Operation to perform:\n * `replace` - Replace existing secrets with a new generated\nsecret\n * `create` - Add a new secret, preserving existing secrets\n * `delete` - Remove an existing secret by value\n", - "enum": [ - "replace", - "create", - "delete" - ], - "type": "string" - }, - "secret": { - "description": "Secret to delete when using `delete` mode", - "type": "string" - } - }, - "required": [ - "mode" - ], - "type": "object" - }, - "type": { - "enum": [ - "app" - ], - "type": "string" - } - }, - "required": [ - "attributes", - "type" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - } - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/AppInstallDataWithSecret" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/SelfLink" - } - }, - "type": "object" - } - } - }, - "description": "Secret has been updated.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "schema": { - "type": "string" - } - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Manage client secret for non-interactive Snyk App installations.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03", - "2024-05-23" - ], - "x-snyk-api-resource": "app_installs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-23", - "x-stability-level": "stable" - } - }, - "/groups/{group_id}/audit_logs/search": { - "get": { - "description": "Search audit logs for a Group. \"api.access\" events are omitted from results unless explicitly requested using the events parameter. Some Organization level events are supported as well as the following\nGroup level events:\n - api.access\n - group.cloud_config.settings.edit\n - group.create\n - group.delete\n - group.edit\n - group.notification_settings.edit\n - group.org.add\n - group.org.remove\n - group.policy.create\n - group.policy.delete\n - group.policy.edit\n - group.request_access_settings.edit\n - group.role.create\n - group.role.delete\n - group.role.edit\n - group.service_account.create\n - group.service_account.delete\n - group.service_account.edit\n - group.settings.edit\n - group.settings.feature_flag.edit\n - group.sso.add\n - group.sso.auth0_connection.create\n - group.sso.auth0_connection.edit\n - group.sso.create\n - group.sso.delete\n - group.sso.edit\n - group.sso.membership.sync\n - group.sso.remove\n - group.tag.create\n - group.tag.delete\n - group.user.add\n - group.user.remove\n - group.user.role.edit\n", - "operationId": "listGroupAuditLogs", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "The ID of the Group.", - "example": "0d3728ec-eebf-484d-9907-ba238019f10b", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Cursor" - }, - { - "$ref": "#/components/parameters/From" - }, - { - "$ref": "#/components/parameters/To" - }, - { - "$ref": "#/components/parameters/Size" - }, - { - "description": "Order in which results are returned.", - "example": "ASC", - "in": "query", - "name": "sort_order", - "schema": { - "default": "DESC", - "enum": [ - "ASC", - "DESC" - ], - "type": "string" - } - }, - { - "description": "Filter logs by user ID.", - "example": "0d3728ec-eebf-484d-9907-ba238019f10b", - "in": "query", - "name": "user_id", - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "Filter logs by project ID.", - "example": "0d3728ec-eebf-484d-9907-ba238019f10b", - "in": "query", - "name": "project_id", - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Events" - }, - { - "$ref": "#/components/parameters/ExcludeEvents" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/AuditLogSearch" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data" - ], - "type": "object" - } - } - }, - "description": "Group Audit Logs.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "schema": { - "type": "string" - } - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Search Group audit logs.", - "tags": [ - "Audit Logs" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-09-11", - "2024-04-29" - ], - "x-snyk-api-resource": "audit-logs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-04-29", - "x-stability-level": "stable" - } - }, - "/groups/{group_id}/issues": { - "get": { - "description": "Get a list of a group's issues.", - "operationId": "listGroupIssues", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "$ref": "#/components/parameters/GroupId" - }, - { - "$ref": "#/components/parameters/ScanItemId" - }, - { - "$ref": "#/components/parameters/ScanItemType" - }, - { - "$ref": "#/components/parameters/Type" - }, - { - "$ref": "#/components/parameters/UpdatedBefore" - }, - { - "$ref": "#/components/parameters/UpdatedAfter" - }, - { - "$ref": "#/components/parameters/CreatedBefore" - }, - { - "$ref": "#/components/parameters/CreatedAfter" - }, - { - "$ref": "#/components/parameters/EffectiveSeverityLevel" - }, - { - "$ref": "#/components/parameters/Status" - }, - { - "$ref": "#/components/parameters/Ignored" - } - ], - "responses": { - "200": { - "$ref": "#/components/responses/ListIssues200" - }, - "401": { - "$ref": "#/components/responses/401__0" - }, - "403": { - "$ref": "#/components/responses/403" - }, - "404": { - "$ref": "#/components/responses/404__0" - }, - "500": { - "$ref": "#/components/responses/500__0" - } - }, - "summary": "Get issues by group ID", - "tags": [ - "Issues" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-03-10~experimental", - "2023-09-29~beta", - "2024-01-23" - ], - "x-snyk-api-resource": "issues", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-01-23", - "x-stability-level": "stable" - } - }, - "/groups/{group_id}/issues/{issue_id}": { - "get": { - "description": "Get an issue", - "operationId": "getGroupIssueByIssueID", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/GroupId" - }, - { - "$ref": "#/components/parameters/PathIssueId20240123" - } - ], - "responses": { - "200": { - "$ref": "#/components/responses/GetIssue20020240123" - }, - "400": { - "$ref": "#/components/responses/400__0" - }, - "401": { - "$ref": "#/components/responses/401__0" - }, - "403": { - "$ref": "#/components/responses/403" - }, - "404": { - "$ref": "#/components/responses/404__0" - }, - "409": { - "$ref": "#/components/responses/409" - }, - "500": { - "$ref": "#/components/responses/500__0" - } - }, - "summary": "Get an issue", - "tags": [ - "Issues" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-01-23" - ], - "x-snyk-api-resource": "issues", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-01-23", - "x-stability-level": "stable" - } - }, - "/groups/{group_id}/memberships": { - "get": { - "description": "Returns all memberships of the group", - "operationId": "listGroupMemberships", - "parameters": [ - { - "description": "The ID of the group", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/SortBy__0" - }, - { - "$ref": "#/components/parameters/SortOrder__0" - }, - { - "$ref": "#/components/parameters/EmailFilter" - }, - { - "$ref": "#/components/parameters/UserIdFilter" - }, - { - "$ref": "#/components/parameters/UsernameFilter" - }, - { - "$ref": "#/components/parameters/RoleFilter" - }, - { - "$ref": "#/components/parameters/IncludeGroupMembershipCount" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "$ref": "#/components/schemas/GroupMembershipResponseData" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "List of group memberships is returned", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get all memberships of the group", - "tags": [ - "Groups" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-05-09~experimental", - "2024-08-25" - ], - "x-snyk-api-resource": "groups", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-08-25", - "x-stability-level": "stable" - }, - "post": { - "description": "Create a group membership for a user with role", - "operationId": "createGroupMembership", - "parameters": [ - { - "description": "The ID of the group", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/CreateGroupMembershipRequestBody" - } - } - } - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "$ref": "#/components/schemas/GroupMembership" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "type": "object" - } - } - }, - "description": "Membership for the group was created", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Create a group membership for a user with role", - "tags": [ - "Groups" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-05-09~experimental", - "2024-08-25" - ], - "x-snyk-api-resource": "groups", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-08-25", - "x-stability-level": "stable" - } - }, - "/groups/{group_id}/memberships/{membership_id}": { - "delete": { - "description": "Deletes a membership from a group", - "operationId": "deleteGroupMembership", - "parameters": [ - { - "description": "The ID of the group", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/MembershipId" - }, - { - "$ref": "#/components/parameters/Cascade" - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "204": { - "description": "group membership is deleted from Group", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Delete a membership from a group", - "tags": [ - "Groups" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-05-09~experimental", - "2024-08-25" - ], - "x-snyk-api-resource": "groups", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-08-25", - "x-stability-level": "stable" - }, - "patch": { - "description": "Update a role from a group membership", - "operationId": "updateGroupUserMembership", - "parameters": [ - { - "description": "The ID of the group", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/MembershipId" - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "$ref": "#/components/schemas/MembershipPatchRequestBody" - } - }, - "type": "object" - } - } - } - }, - "responses": { - "204": { - "$ref": "#/components/responses/204" - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Update a role from a group membership", - "tags": [ - "Groups" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-05-09~experimental", - "2024-08-25" - ], - "x-snyk-api-resource": "groups", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-08-25", - "x-stability-level": "stable" - } - }, - "/groups/{group_id}/org_memberships": { - "get": { - "description": "Get list of org memberships of a group user", - "operationId": "listGroupUserOrgMemberships", - "parameters": [ - { - "description": "The ID of the group", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/UserId" - }, - { - "$ref": "#/components/parameters/OrgName" - }, - { - "$ref": "#/components/parameters/RoleFilter" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/GroupMembershipOrgMembership" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - }, - "meta": { - "properties": { - "org_membership_count": { - "description": "Org memberships for this user within this group.", - "type": "number" - } - }, - "type": "object" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "A list of org memberships is returned", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get list of org memberships of a group user", - "tags": [ - "Groups" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-05-07~experimental", - "2024-08-25" - ], - "x-snyk-api-resource": "groups", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-08-25", - "x-stability-level": "stable" - } - }, - "/groups/{group_id}/orgs": { - "get": { - "description": "Get a paginated list of all the organizations belonging to the group.\nBy default, this endpoint returns the organizations in alphabetical order of their name.", - "operationId": "listOrgsInGroup", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "$ref": "#/components/parameters/PathGroupId" - }, - { - "$ref": "#/components/parameters/QueryNameFilter" - }, - { - "$ref": "#/components/parameters/QuerySlugFilter" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "items": { - "additionalProperties": false, - "properties": { - "attributes": { - "additionalProperties": false, - "properties": { - "access_requests_enabled": { - "description": "Whether the organization permits access requests from users who are not members of the organization.", - "example": false, - "type": "boolean" - }, - "created_at": { - "description": "The time the organization was created.", - "example": "2022-03-16T00:00:00Z", - "format": "date-time", - "type": "string" - }, - "group_id": { - "description": "The Snyk ID of the group to which the organization belongs.", - "example": "59d6d97e-3106-4ebb-b608-352fad9c5b34", - "format": "uuid", - "type": "string" - }, - "is_personal": { - "description": "Whether the organization is independent (that is, not part of a group).", - "example": true, - "type": "boolean" - }, - "name": { - "description": "The display name of the organization.", - "example": "My Org", - "type": "string" - }, - "slug": { - "description": "The canonical (unique and URL-friendly) name of the organization.", - "example": "my-org", - "type": "string" - }, - "updated_at": { - "description": "The time the organization was last modified.", - "example": "2022-03-16T00:00:00Z", - "format": "date-time", - "type": "string" - } - }, - "required": [ - "name", - "slug", - "is_personal" - ], - "type": "object" - }, - "id": { - "description": "The Snyk ID of the organization.", - "example": "59d6d97e-3106-4ebb-b608-352fad9c5b34", - "format": "uuid", - "type": "string" - }, - "type": { - "example": "resource", - "pattern": "^[a-z][a-z0-9]*(_[a-z][a-z0-9]*)*$", - "type": "string" - } - }, - "required": [ - "type", - "id", - "attributes" - ], - "type": "object" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "A list of organizations in the group.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "List all organizations in group", - "tags": [ - "Orgs" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-10-24~experimental", - "2023-12-14~beta", - "2024-02-28" - ], - "x-snyk-api-resource": "orgs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-02-28", - "x-stability-level": "stable" - } - }, - "/groups/{group_id}/service_accounts": { - "get": { - "description": "Get all service accounts for a group.", - "operationId": "getManyGroupServiceAccount", - "parameters": [ - { - "description": "The ID of the Snyk Group that owns the service accounts.", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/ServiceAccount" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "A list of service accounts is returned.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get a list of group service accounts.", - "tags": [ - "ServiceAccounts" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-09-07" - ], - "x-snyk-api-resource": "service_accounts", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-07", - "x-stability-level": "stable" - }, - "post": { - "description": "Create a service account for a group. The service account can be used to access the Snyk API.", - "operationId": "createGroupServiceAccount", - "parameters": [ - { - "description": "The ID of the Snyk Group that is creating and owns the service account", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "additionalProperties": false, - "properties": { - "access_token_ttl_seconds": { - "description": "The time, in seconds, that a generated access token will be valid for. Defaults to 1 hour if unset. Only used when auth_type is one of the oauth_* variants.", - "maximum": 86400, - "minimum": 3600, - "type": "number" - }, - "auth_type": { - "description": "Authentication strategy for the service account:\n * api_key - Regular Snyk API Key.\n * oauth_client_secret - OAuth2 client_credentials grant, which returns a client secret that can be used to retrieve an access token.\n * oauth_private_key_jwt - OAuth2 client_credentials grant, using private_key_jwt client_assertion as laid out in OIDC Connect Core 1.0, section 9.", - "enum": [ - "api_key", - "oauth_client_secret", - "oauth_private_key_jwt" - ], - "type": "string" - }, - "jwks_url": { - "description": "A JWKs URL hosting your public keys, used to verify signed JWT requests. Must be https. Required only when auth_type is oauth_private_key_jwt.", - "type": "string" - }, - "name": { - "description": "A human-friendly name for the service account.", - "type": "string" - }, - "role_id": { - "description": "The ID of the role which the created service account should use.", - "format": "uuid", - "type": "string" - } - }, - "required": [ - "name", - "auth_type", - "role_id" - ], - "type": "object" - }, - "type": { - "description": "The Resource type.", - "enum": [ - "service_account" - ], - "type": "string" - } - }, - "required": [ - "type", - "attributes" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - }, - "required": true - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/ServiceAccount" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data" - ], - "type": "object" - } - } - }, - "description": "A new service account has been created", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Create a service account for a group.", - "tags": [ - "ServiceAccounts" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-09-07" - ], - "x-snyk-api-resource": "service_accounts", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-07", - "x-stability-level": "stable" - } - }, - "/groups/{group_id}/service_accounts/{serviceaccount_id}": { - "delete": { - "description": "Permanently delete a group-level service account by its ID.", - "operationId": "deleteOneGroupServiceAccount", - "parameters": [ - { - "description": "The ID of the Snyk Group that owns the service account.", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "The ID of the service account.", - "in": "path", - "name": "serviceaccount_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "204": { - "description": "Service account was successfully deleted.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Delete a group service account.", - "tags": [ - "ServiceAccounts" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-09-07" - ], - "x-snyk-api-resource": "service_accounts", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-07", - "x-stability-level": "stable" - }, - "get": { - "description": "Get a group-level service account by its ID.", - "operationId": "getOneGroupServiceAccount", - "parameters": [ - { - "description": "The ID of the Snyk Group that owns the service account.", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "The ID of the service account.", - "in": "path", - "name": "serviceaccount_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/ServiceAccount" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "Service account is returned.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get a group service account.", - "tags": [ - "ServiceAccounts" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-09-07" - ], - "x-snyk-api-resource": "service_accounts", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-07", - "x-stability-level": "stable" - }, - "patch": { - "description": "Update the name of a group's service account by its ID.", - "operationId": "updateGroupServiceAccount", - "parameters": [ - { - "description": "The ID of the Snyk Group that owns the service account.", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "The ID of the service account.", - "in": "path", - "name": "serviceaccount_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "additionalProperties": false, - "properties": { - "name": { - "description": "A human-friendly name for the service account. Must be unique within the group.", - "type": "string" - } - }, - "required": [ - "name" - ], - "type": "object" - }, - "id": { - "description": "The ID of the service account. Must match the id in the url path.", - "format": "uuid", - "type": "string" - }, - "type": { - "description": "The Resource type.", - "enum": [ - "service_account" - ], - "type": "string" - } - }, - "required": [ - "type", - "id", - "attributes" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - }, - "required": true - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/ServiceAccount" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "Service account is returned.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Update a group service account.", - "tags": [ - "ServiceAccounts" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-09-07" - ], - "x-snyk-api-resource": "service_accounts", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-07", - "x-stability-level": "stable" - } - }, - "/groups/{group_id}/service_accounts/{serviceaccount_id}/secrets": { - "post": { - "description": "Manage the client secret of a group service account by the service account ID.", - "operationId": "updateServiceAccountSecret", - "parameters": [ - { - "description": "The ID of the Snyk Group that owns the service account.", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "The ID of the service account.", - "in": "path", - "name": "serviceaccount_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "additionalProperties": false, - "properties": { - "mode": { - "description": "Operation to perform:\n * `replace` - Replace existing secrets with a new generated secret.\n * `create` - Add a new secret, preserving existing secrets. A maximum of to two secrets can exist at a time.\n * `delete` - Remove an existing secret by value. At least one secret must remain per service account.\n", - "enum": [ - "replace", - "create", - "delete" - ], - "type": "string" - }, - "secret": { - "description": "Secret to delete when using `delete` mode", - "type": "string" - } - }, - "required": [ - "mode" - ], - "type": "object" - }, - "type": { - "description": "The Resource type.", - "enum": [ - "service_account" - ], - "type": "string" - } - }, - "required": [ - "attributes", - "type" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - }, - "required": true - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/ServiceAccount" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data" - ], - "type": "object" - } - } - }, - "description": "Service account client secret has been updated.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Manage a group service account's client secret.", - "tags": [ - "ServiceAccounts" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-09-07" - ], - "x-snyk-api-resource": "service_accounts", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-07", - "x-stability-level": "stable" - } - }, - "/groups/{group_id}/settings/iac": { - "get": { - "description": "Get the Infrastructure as Code Settings for a group.", - "operationId": "getIacSettingsForGroup", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "The id of the group whose Infrastructure as Code settings are requested", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/GroupIacSettingsResponse" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "The Infrastructure as Code Settings of the group.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get the Infrastructure as Code Settings for a group", - "tags": [ - "IacSettings" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2021-12-09" - ], - "x-snyk-api-resource": "iac_settings", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2021-12-09", - "x-stability-level": "stable" - }, - "patch": { - "description": "Update the Infrastructure as Code Settings for a group.", - "operationId": "updateIacSettingsForGroup", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "The id of the group whose Infrastructure as Code settings are getting updated", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "$ref": "#/components/schemas/GroupIacSettingsRequest" - } - }, - "type": "object" - } - } - } - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/GroupIacSettingsResponse" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "The Infrastructure as Code Settings of the group were updated.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Update the Infrastructure as Code Settings for a group", - "tags": [ - "IacSettings" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2021-12-09" - ], - "x-snyk-api-resource": "iac_settings", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2021-12-09", - "x-stability-level": "stable" - } - }, - "/groups/{group_id}/settings/pull_request_template": { - "delete": { - "description": "Delete your groups pull request template. This means Snyk pull requests will start to use the default template for this group.", - "operationId": "deletePullRequestTemplate", - "parameters": [ - { - "description": "Snyk Group ID", - "example": "7626925e-4b0f-11ee-be56-0242ac120002", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "204": { - "$ref": "#/components/responses/204" - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Delete pull request template for group", - "tags": [ - "Pull Request Templates" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-10-13~beta", - "2024-05-08" - ], - "x-snyk-api-resource": "pull-request-templates", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-08", - "x-stability-level": "stable" - }, - "get": { - "description": "Get your groups pull request template", - "operationId": "getPullRequestTemplate", - "parameters": [ - { - "description": "Snyk Group ID", - "example": "7626925e-4b0f-11ee-be56-0242ac120002", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "description": "Fetch a pull request template response", - "properties": { - "attributes": { - "$ref": "#/components/schemas/PullRequestTemplateAttributes" - }, - "id": { - "$ref": "#/components/schemas/PullRequsetTemplateId" - }, - "type": { - "$ref": "#/components/schemas/Types" - } - }, - "required": [ - "id", - "type", - "attributes" - ], - "type": "object" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "type": "object" - } - } - }, - "description": "Fetch Pull Request Template for group.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get pull request template for group", - "tags": [ - "Pull Request Templates" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-10-13~beta", - "2024-05-08" - ], - "x-snyk-api-resource": "pull-request-templates", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-08", - "x-stability-level": "stable" - }, - "post": { - "description": "Configures a group level pull request template that will be used on any org or project within that group", - "operationId": "createOrUpdatePullRequestTemplate", - "parameters": [ - { - "description": "Snyk Group ID", - "example": "7626925e-4b0f-11ee-be56-0242ac120002", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "$ref": "#/components/schemas/PullRequestTemplateAttributes" - }, - "type": { - "$ref": "#/components/schemas/Types" - } - }, - "required": [ - "type", - "attributes" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - }, - "required": true - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "description": "Create or update Pull Request Template response", - "properties": { - "attributes": { - "$ref": "#/components/schemas/PullRequestTemplateAttributes" - }, - "id": { - "$ref": "#/components/schemas/PullRequsetTemplateId" - }, - "type": { - "$ref": "#/components/schemas/Types" - } - }, - "required": [ - "id", - "type", - "attributes" - ], - "type": "object" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "type": "object" - } - } - }, - "description": "Pull Request Template created for group.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Create or update pull request template for group", - "tags": [ - "Pull Request Templates" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-10-13~beta", - "2024-05-08" - ], - "x-snyk-api-resource": "pull-request-templates", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-08", - "x-stability-level": "stable" - } - }, - "/groups/{group_id}/sso_connections": { - "get": { - "description": "Returns a list of SSO connections for a group", - "operationId": "listGroupSsoConnections", - "parameters": [ - { - "description": "The ID of the group", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/SSOConnection" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "List of SSO connections is returned", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get all SSO connections for a group", - "tags": [ - "Groups" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-01-31~experimental", - "2023-01-30~beta" - ], - "x-snyk-api-resource": "groups", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2023-01-30~beta", - "x-stability-level": "beta" - } - }, - "/groups/{group_id}/sso_connections/{sso_id}/users": { - "get": { - "description": "Returns a list of users for a SSO connection", - "operationId": "listGroupSsoConnectionUsers", - "parameters": [ - { - "description": "The ID of the group", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/SsoId" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "items": { - "additionalProperties": false, - "properties": { - "attributes": { - "additionalProperties": false, - "properties": { - "active": { - "description": "Whether the user status is enabled or not", - "example": true, - "type": "boolean" - }, - "email": { - "description": "The email of the user.", - "example": "user@someorg.com", - "type": "string" - }, - "membership": { - "properties": { - "created_at": { - "description": "The date the membership was established.", - "example": "2022-09-14T09:19:29.206Z", - "format": "date-time", - "type": "string" - }, - "strategy": { - "description": "Whether the membership is a direct, or indirect membership.", - "enum": [ - "direct", - "indirect" - ], - "example": "direct", - "type": "string" - } - }, - "type": "object" - }, - "name": { - "description": "The name of the user.", - "example": "user", - "type": "string" - }, - "username": { - "description": "The username of the user.", - "example": "username", - "type": "string" - } - }, - "type": "object" - }, - "id": { - "description": "The Snyk ID corresponding to this user", - "example": "55a348e2-c3ad-4bbc-b40e-9b232d1f4121", - "format": "uuid", - "type": "string" - }, - "type": { - "description": "Content type.", - "example": "user", - "type": "string" - } - }, - "required": [ - "type", - "id", - "attributes" - ], - "type": "object" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "List of users is returned", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get all users using a given SSO connection", - "tags": [ - "Groups" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-01-31~experimental", - "2023-01-30~beta" - ], - "x-snyk-api-resource": "groups", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2023-01-30~beta", - "x-stability-level": "beta" - } - }, - "/groups/{group_id}/sso_connections/{sso_id}/users/{user_id}": { - "delete": { - "description": "Deletes a user from a Group SSO connection", - "operationId": "deleteUser", - "parameters": [ - { - "description": "The ID of the group", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/SsoId" - }, - { - "$ref": "#/components/parameters/UserId20230130" - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "204": { - "description": "User is deleted from Group SSO connection", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Delete a user from a Group SSO connection", - "tags": [ - "Groups" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-01-31~experimental", - "2023-01-30~beta" - ], - "x-snyk-api-resource": "groups", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2023-01-30~beta", - "x-stability-level": "beta" - } - }, - "/groups/{group_id}/users/{id}": { - "patch": { - "description": "Update a user's membership of the group.\n\nTo remove a user's membership, provide 'null' as the membership parameter (see example).\n\nAt present, only removing memberships is supported by this endpoint. To update a user's group membership, please use\nthe UI or legacy API.\n", - "operationId": "updateUser", - "parameters": [ - { - "description": "The id of the group", - "in": "path", - "name": "group_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "The id of the user", - "in": "path", - "name": "id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "example": { - "data": { - "attributes": { - "membership": null - }, - "id": "55a348e2-c3ad-4bbc-b40e-9b232d1f4122", - "type": "user" - } - }, - "schema": { - "properties": { - "data": { - "$ref": "#/components/schemas/UserPatchRequestBody" - } - }, - "type": "object" - } - } - } - }, - "responses": { - "204": { - "$ref": "#/components/responses/204" - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Update a user's role in a group", - "tags": [ - "Users" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-10-06~beta" - ], - "x-snyk-api-resource": "users", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2022-10-06~beta", - "x-stability-level": "beta" - } - }, - "/learn/catalog": { - "get": { - "description": "List Snyk Learn's catalog resources", - "operationId": "listLearnCatalog", - "parameters": [ - { - "$ref": "#/components/parameters/ApiVersion" - }, - { - "$ref": "#/components/parameters/ContentSource" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/EducationResource" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "required": [ - "data", - "links", - "jsonapi" - ], - "type": "object" - } - } - }, - "description": "Returns a list of catalog resources", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "List Snyk Learn's resources", - "tags": [ - "Catalog Resource" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-05-13~experimental", - "2024-10-13~beta" - ], - "x-snyk-api-resource": "catalog", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2024-10-13~beta", - "x-stability-level": "beta" - } - }, - "/openapi": { - "get": { - "description": "List available versions of OpenAPI specification", - "operationId": "listAPIVersions", - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "items": { - "type": "string" - }, - "type": "array" - } - } - }, - "description": "List of available versions is returned", - "headers": { - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - } - } - }, - "400": { - "$ref": "#/components/responses/400" - }, - "401": { - "$ref": "#/components/responses/401" - }, - "404": { - "$ref": "#/components/responses/404" - }, - "500": { - "$ref": "#/components/responses/500" - } - }, - "tags": [ - "OpenAPI" - ] - } - }, - "/openapi/{version}": { - "get": { - "description": "Get OpenAPI specification effective at version.", - "operationId": "getAPIVersion", - "parameters": [ - { - "description": "The requested version of the API", - "in": "path", - "name": "version", - "required": true, - "schema": { - "type": "string" - } - } - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "type": "object" - } - } - }, - "description": "OpenAPI specification matching requested version is returned", - "headers": { - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - } - } - }, - "400": { - "$ref": "#/components/responses/400" - }, - "401": { - "$ref": "#/components/responses/401" - }, - "404": { - "$ref": "#/components/responses/404" - }, - "500": { - "$ref": "#/components/responses/500" - } - }, - "tags": [ - "OpenAPI" - ] - } - }, - "/orgs": { - "get": { - "description": "Get a paginated list of organizations you have access to.", - "operationId": "listOrgs", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "description": "If set, only return organizations within the specified group", - "in": "query", - "name": "group_id", - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "If true, only return organizations that are not part of a group.", - "in": "query", - "name": "is_personal", - "schema": { - "type": "boolean" - } - }, - { - "description": "Only return orgs whose slug exactly matches this value.", - "in": "query", - "name": "slug", - "schema": { - "maxLength": 100, - "pattern": "^[\\w.-]+$", - "type": "string" - } - }, - { - "description": "Only return orgs whose name contains this value.", - "in": "query", - "name": "name", - "schema": { - "maxLength": 100, - "type": "string" - } - }, - { - "description": "Expand the specified related resources in the response to include their attributes.", - "in": "query", - "name": "expand", - "schema": { - "items": { - "enum": [ - "member_role" - ], - "type": "string" - }, - "type": "array" - } - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/OrgWithRelationships" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "A list of organizations you have access to.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "List accessible organizations", - "tags": [ - "Orgs" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-04-06~experimental", - "2022-12-15~beta", - "2023-05-29", - "2024-02-28" - ], - "x-snyk-api-resource": "orgs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-02-28", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}": { - "get": { - "description": "Returns an org by its ID", - "operationId": "getOrg", - "parameters": [ - { - "description": "The ID of the org", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "$ref": "#/components/schemas/Org" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "Org is returned", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get an org", - "tags": [ - "Orgs" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-02-16~experimental", - "2022-04-06~experimental", - "2022-12-15~beta" - ], - "x-snyk-api-resource": "orgs", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2022-12-15~beta", - "x-stability-level": "beta" - }, - "patch": { - "description": "Update the details of an organization", - "operationId": "updateOrg", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/PathOrgId" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "$ref": "#/components/schemas/OrgUpdateAttributes" - }, - "id": { - "description": "The ID of the resource.", - "format": "uuid", - "type": "string" - }, - "type": { - "description": "The type of the resource.", - "enum": [ - "org" - ], - "example": "org", - "type": "string" - } - }, - "required": [ - "id", - "type", - "attributes" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - } - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "description": "org resource object", - "properties": { - "attributes": { - "$ref": "#/components/schemas/OrgAttributes" - }, - "id": { - "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", - "format": "uuid", - "type": "string" - }, - "relationships": { - "$ref": "#/components/schemas/OrgRelationships" - }, - "type": { - "enum": [ - "org" - ], - "example": "org", - "type": "string" - } - }, - "required": [ - "id", - "type" - ], - "type": "object" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/SelfLink" - } - }, - "type": "object" - } - } - }, - "description": "Instance of org is updated", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "204": { - "$ref": "#/components/responses/204" - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Update organization", - "tags": [ - "Orgs" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-04-06~experimental", - "2022-12-15~beta", - "2023-05-29", - "2024-02-28" - ], - "x-snyk-api-resource": "orgs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-02-28", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/app_bots": { - "get": { - "deprecated": true, - "description": "Get a list of app bots authorized to an organization. Deprecated, use /orgs/{org_id}/apps/installs instead.", - "operationId": "getAppBots", - "parameters": [ - { - "description": "Expand relationships.", - "explode": false, - "in": "query", - "name": "expand", - "schema": { - "items": { - "enum": [ - "app" - ], - "type": "string" - }, - "type": "array" - }, - "style": "form" - }, - { - "description": "Organization ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/AppBot" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "required": [ - "data", - "jsonapi", - "links" - ], - "type": "object" - } - } - }, - "description": "A list of app bots authorized to the specified organization", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get a list of app bots authorized to an organization.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-03-11" - ], - "x-snyk-api-resource": "app_bots", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-03-11", - "x-snyk-sunset-eligible": "2024-07-17", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/app_bots/{bot_id}": { - "delete": { - "deprecated": true, - "description": "Revoke app bot authorization. Deprecated, use /orgs/{org_id}/apps/installs/{install_id} instead.", - "operationId": "deleteAppBot", - "parameters": [ - { - "description": "The ID of the app bot", - "in": "path", - "name": "bot_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Organization ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "responses": { - "204": { - "description": "The app bot has been deauthorized", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "schema": { - "type": "string" - } - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Revoke app bot authorization", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-03-11" - ], - "x-snyk-api-resource": "app_bots", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-03-11", - "x-snyk-sunset-eligible": "2024-07-17", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/apps": { - "get": { - "deprecated": true, - "description": "Get a list of apps created by an organization. Deprecated, use /orgs/{org_id}/apps/creations instead.", - "operationId": "getApps", - "parameters": [ - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/AppData20220311" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "required": [ - "data", - "jsonapi", - "links" - ], - "type": "object" - } - } - }, - "description": "A list of apps created by the specified organization", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get a list of apps created by an organization.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-03-11" - ], - "x-snyk-api-resource": "apps", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-03-11", - "x-snyk-sunset-eligible": "2024-07-17", - "x-stability-level": "stable" - }, - "post": { - "deprecated": true, - "description": "Create a new app for an organization. Deprecated, use /orgs/{org_id}/apps/creations instead.", - "operationId": "createApp", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/AppPostRequest20220311" - } - } - }, - "description": "app to be created" - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/AppPostResponse20220311" - } - } - }, - "description": "Created Snyk App successfully", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "schema": { - "type": "string" - } - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Create a new app for an organization.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-03-11" - ], - "x-snyk-api-resource": "apps", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-03-11", - "x-snyk-sunset-eligible": "2024-07-17", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/apps/creations": { - "get": { - "description": "Get a list of apps created by an organization.", - "operationId": "getOrgApps", - "parameters": [ - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/AppData" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "required": [ - "data", - "jsonapi", - "links" - ], - "type": "object" - } - } - }, - "description": "A list of apps created by the specified organization", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get a list of apps created by an organization.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03" - ], - "x-snyk-api-resource": "apps", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-11-03", - "x-stability-level": "stable" - }, - "post": { - "description": "Create a new Snyk App for an organization.", - "operationId": "createOrgApp", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/AppPostRequest" - } - } - }, - "description": "Snyk App details for app to be created." - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/AppPostResponse" - } - } - }, - "description": "Created Snyk App successfully.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "schema": { - "type": "string" - } - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Create a new Snyk App for an organization.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03" - ], - "x-snyk-api-resource": "apps", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-11-03", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/apps/creations/{app_id}": { - "delete": { - "description": "Delete an app by its App ID.", - "operationId": "deleteAppByID", - "parameters": [ - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/AppId" - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "204": { - "description": "The app has been deleted", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "schema": { - "type": "string" - } - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Delete an app by its App ID.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03" - ], - "x-snyk-api-resource": "apps", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-11-03", - "x-stability-level": "stable" - }, - "get": { - "description": "Get a Snyk App by its App ID.", - "operationId": "getAppByID", - "parameters": [ - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/AppId" - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/AppData" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/SelfLink" - } - }, - "type": "object" - } - } - }, - "description": "The requested app", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get a Snyk App by its App ID.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03" - ], - "x-snyk-api-resource": "apps", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-11-03", - "x-stability-level": "stable" - }, - "patch": { - "description": "Update app creation attributes with App ID.", - "operationId": "updateAppCreationByID", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/AppId" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/AppPatchRequest" - } - } - } - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/AppData" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/SelfLink" - } - }, - "type": "object" - } - } - }, - "description": "The update app.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Update app creation attributes such as name, redirect URIs, and access token time to live using the App ID.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03" - ], - "x-snyk-api-resource": "apps", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-11-03", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/apps/creations/{app_id}/secrets": { - "post": { - "description": "Manage client secret for the Snyk App.", - "operationId": "manageAppCreationSecret", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/AppId" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "additionalProperties": false, - "properties": { - "mode": { - "description": "Operation to perform:\n * `replace` - Replace existing secrets with a new generated\nsecret\n * `create` - Add a new secret, preserving existing secrets\n * `delete` - Remove an existing secret by value\n", - "enum": [ - "replace", - "create", - "delete" - ], - "type": "string" - }, - "secret": { - "description": "Secret to delete when using `delete` mode", - "type": "string" - } - }, - "required": [ - "mode" - ], - "type": "object" - }, - "type": { - "enum": [ - "app" - ], - "type": "string" - } - }, - "required": [ - "attributes", - "type" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - } - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/AppDataWithSecret" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/SelfLink" - } - }, - "type": "object" - } - } - }, - "description": "Secret has been updated.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Manage client secret for the Snyk App.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03" - ], - "x-snyk-api-resource": "apps", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-11-03", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/apps/installs": { - "get": { - "description": "Get a list of apps installed for an organization.", - "operationId": "getAppInstallsForOrg", - "parameters": [ - { - "description": "Expand relationships.", - "explode": false, - "in": "query", - "name": "expand", - "schema": { - "items": { - "enum": [ - "app" - ], - "type": "string" - }, - "type": "array" - }, - "style": "form" - }, - { - "description": "Organization ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/AppInstallData" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "required": [ - "data", - "jsonapi", - "links" - ], - "type": "object" - } - } - }, - "description": "A list of apps installed for the specified organization.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get a list of apps installed for an organization.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03", - "2024-05-23" - ], - "x-snyk-api-resource": "app_installs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-23", - "x-stability-level": "stable" - }, - "post": { - "description": "Install a Snyk Apps to this organization, the Snyk App must use unattended authentication eg client credentials.", - "operationId": "createOrgAppInstall", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "properties": { - "type": { - "enum": [ - "app_install" - ], - "example": "app_install", - "type": "string" - } - }, - "type": "object" - }, - "relationships": { - "additionalProperties": false, - "properties": { - "app": { - "additionalProperties": false, - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "id": { - "$ref": "#/components/schemas/Uuid" - }, - "type": { - "enum": [ - "app" - ], - "example": "app", - "type": "string" - } - }, - "required": [ - "id", - "type" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - }, - "required": [ - "app" - ], - "type": "object" - } - }, - "required": [ - "data", - "relationships" - ], - "type": "object" - } - } - }, - "description": "App Install to be created" - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/AppInstallWithClient" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "required": [ - "data", - "jsonapi", - "links" - ], - "type": "object" - } - } - }, - "description": "The newly created app install.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "schema": { - "type": "string" - } - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Install a Snyk Apps to this organization.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03", - "2024-05-23" - ], - "x-snyk-api-resource": "app_installs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-23", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/apps/installs/{install_id}": { - "delete": { - "description": "Revoke app authorization for an Snyk Organization with install ID.", - "operationId": "deleteAppOrgInstallById", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/InstallId" - } - ], - "responses": { - "204": { - "description": "The app install has been revoked.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "schema": { - "type": "string" - } - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Revoke app authorization for an Snyk Organization with install ID.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03", - "2024-05-23" - ], - "x-snyk-api-resource": "app_installs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-23", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/apps/installs/{install_id}/secrets": { - "post": { - "description": "Manage client secret for non-interactive Snyk App installations.", - "operationId": "updateOrgAppInstallSecret", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/InstallId" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "additionalProperties": false, - "properties": { - "mode": { - "description": "Operation to perform:\n * `replace` - Replace existing secrets with a new generated\nsecret\n * `create` - Add a new secret, preserving existing secrets\n * `delete` - Remove an existing secret by value\n", - "enum": [ - "replace", - "create", - "delete" - ], - "type": "string" - }, - "secret": { - "description": "Secret to delete when using `delete` mode", - "type": "string" - } - }, - "required": [ - "mode" - ], - "type": "object" - }, - "type": { - "enum": [ - "app" - ], - "type": "string" - } - }, - "required": [ - "attributes", - "type" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - } - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/AppInstallDataWithSecret" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/SelfLink" - } - }, - "type": "object" - } - } - }, - "description": "Secret has been updated.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "schema": { - "type": "string" - } - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Manage client secret for non-interactive Snyk App installations.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03", - "2024-05-23" - ], - "x-snyk-api-resource": "app_installs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-23", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/apps/{client_id}": { - "delete": { - "deprecated": true, - "description": "Delete an app by app id. Deprecated, use /orgs/{org_id}/apps/creations/{app_id} instead.", - "operationId": "deleteApp", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/ClientId" - } - ], - "responses": { - "204": { - "description": "The app has been deleted", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "schema": { - "type": "string" - } - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Delete an app", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-03-11" - ], - "x-snyk-api-resource": "apps", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-03-11", - "x-snyk-sunset-eligible": "2024-07-17", - "x-stability-level": "stable" - }, - "get": { - "deprecated": true, - "description": "Get an App by client id. Deprecated, use /orgs/{org_id}/apps/creations/{app_id} instead.", - "operationId": "getApp", - "parameters": [ - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/ClientId" - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/AppData20220311" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/SelfLink" - } - }, - "type": "object" - } - } - }, - "description": "The requested app", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get an app by client id", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-03-11" - ], - "x-snyk-api-resource": "apps", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-03-11", - "x-snyk-sunset-eligible": "2024-07-17", - "x-stability-level": "stable" - }, - "patch": { - "deprecated": true, - "description": "Update app attributes. Deprecated, use /orgs/{org_id}/apps/creations/{app_id} instead.", - "operationId": "updateApp", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/ClientId" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/AppPatchRequest20220311" - } - } - } - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/AppData20220311" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/SelfLink" - } - }, - "type": "object" - } - } - }, - "description": "The update app.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Update app attributes that are name, redirect URIs, and access token time to live", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-03-11" - ], - "x-snyk-api-resource": "apps", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-03-11", - "x-snyk-sunset-eligible": "2024-07-17", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/apps/{client_id}/secrets": { - "post": { - "deprecated": true, - "description": "Manage client secrets for an app. Deprecated, use /orgs/{org_id}/apps/creations/{app_id}/secrets instead.", - "operationId": "manageSecrets", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/ClientId" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "mode": { - "description": "Operation to perform:\n * `replace` - Replace existing secrets with a new generated\nsecret\n * `create` - Add a new secret, preserving existing secrets\n * `delete` - Remove an existing secret by value\n", - "enum": [ - "replace", - "create", - "delete" - ], - "type": "string" - }, - "secret": { - "description": "Secret to delete when using `delete` mode", - "type": "string" - } - }, - "required": [ - "mode" - ], - "type": "object" - } - } - } - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/AppDataWithSecret20220311" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/SelfLink" - } - }, - "type": "object" - } - } - }, - "description": "Secrets have been updated.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Manage client secrets for an app.", - "tags": [ - "Apps" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-03-11" - ], - "x-snyk-api-resource": "apps", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-03-11", - "x-snyk-sunset-eligible": "2024-07-17", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/audit_logs/search": { - "get": { - "description": "Search audit logs for an Organization. \"api.access\" events are omitted from results unless explicitly requested using the events parameter. Supported event types:\n - api.access\n - org.app_bot.create\n - org.app.create\n - org.app.delete\n - org.app.edit\n - org.cloud_config.settings.edit\n - org.collection.create\n - org.collection.delete\n - org.collection.edit\n - org.create\n - org.delete\n - org.edit\n - org.ignore_policy.edit\n - org.integration.create\n - org.integration.delete\n - org.integration.edit\n - org.integration.settings.edit\n - org.language_settings.edit\n - org.notification_settings.edit\n - org.org_source.create\n - org.org_source.delete\n - org.org_source.edit\n - org.policy.edit\n - org.project_filter.create\n - org.project_filter.delete\n - org.project.add\n - org.project.attributes.edit\n - org.project.delete\n - org.project.edit\n - org.project.fix_pr.auto_open\n - org.project.fix_pr.manual_open\n - org.project.ignore.create\n - org.project.ignore.delete\n - org.project.ignore.edit\n - org.project.monitor\n - org.project.pr_check.edit\n - org.project.remove\n - org.project.settings.delete\n - org.project.settings.edit\n - org.project.stop_monitor\n - org.project.tag.add\n - org.project.tag.remove\n - org.project.test\n - org.request_access_settings.edit\n - org.sast_settings.edit\n - org.service_account.create\n - org.service_account.delete\n - org.service_account.edit\n - org.settings.feature_flag.edit\n - org.target.create\n - org.target.delete\n - org.user.add\n - org.user.invite\n - org.user.invite.accept\n - org.user.invite.revoke\n - org.user.invite_link.accept\n - org.user.invite_link.create\n - org.user.invite_link.revoke\n - org.user.leave\n - org.user.provision.accept\n - org.user.provision.create\n - org.user.provision.delete\n - org.user.remove\n - org.user.role.create\n - org.user.role.delete\n - org.user.role.details.edit\n - org.user.role.edit\n - org.user.role.permissions.edit\n - org.webhook.add\n - org.webhook.delete\n - user.org.notification_settings.edit\n", - "operationId": "listOrgAuditLogs", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "The ID of the organization.", - "example": "0d3728ec-eebf-484d-9907-ba238019f10b", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Cursor" - }, - { - "$ref": "#/components/parameters/From" - }, - { - "$ref": "#/components/parameters/To" - }, - { - "$ref": "#/components/parameters/Size" - }, - { - "description": "Order in which results are returned.", - "example": "ASC", - "in": "query", - "name": "sort_order", - "schema": { - "default": "DESC", - "enum": [ - "ASC", - "DESC" - ], - "type": "string" - } - }, - { - "description": "Filter logs by user ID.", - "example": "0d3728ec-eebf-484d-9907-ba238019f10b", - "in": "query", - "name": "user_id", - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "Filter logs by project ID.", - "example": "0d3728ec-eebf-484d-9907-ba238019f10b", - "in": "query", - "name": "project_id", - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Events" - }, - { - "$ref": "#/components/parameters/ExcludeEvents" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/AuditLogSearch" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data" - ], - "type": "object" - } - } - }, - "description": "Organization Audit Logs.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "schema": { - "type": "string" - } - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Search Organization audit logs.", - "tags": [ - "Audit Logs" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-09-11", - "2024-04-29" - ], - "x-snyk-api-resource": "audit-logs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-04-29", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/cloud/environments": { - "get": { - "description": "List environments for an organization", - "operationId": "listEnvironments", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Organization ID", - "example": "9a46d918-8764-458c-1234-0987abcd6543", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "Return environments created after this date", - "example": "2022-05-06T12:25:15-04:00", - "in": "query", - "name": "created_after", - "schema": { - "format": "date-time", - "type": "string" - } - }, - { - "description": "Return environments created before this date", - "example": "2022-05-06T12:25:15-04:00", - "in": "query", - "name": "created_before", - "schema": { - "format": "date-time", - "type": "string" - } - }, - { - "description": "Return environments updated after this date", - "example": "2022-05-06T12:25:15-04:00", - "in": "query", - "name": "updated_after", - "schema": { - "format": "date-time", - "type": "string" - } - }, - { - "description": "Return environments updated before this date", - "example": "2022-05-06T12:25:15-04:00", - "in": "query", - "name": "updated_before", - "schema": { - "format": "date-time", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/NameInQuery" - }, - { - "$ref": "#/components/parameters/KindInQuery" - }, - { - "$ref": "#/components/parameters/StatusInQuery" - }, - { - "$ref": "#/components/parameters/IdInQuery" - }, - { - "description": "Filter environments by project ID", - "example": "9a46d918-8764-458c-1234-0987abcd6543", - "in": "query", - "name": "project_id", - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "items": { - "properties": { - "attributes": { - "$ref": "#/components/schemas/EnvironmentAttributes" - }, - "id": { - "description": "Environment ID", - "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", - "format": "uuid", - "type": "string" - }, - "relationships": { - "$ref": "#/components/schemas/EnvironmentRelationships" - }, - "type": { - "$ref": "#/components/schemas/EnvironmentType" - } - }, - "required": [ - "id", - "type" - ], - "type": "object" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "type": "object" - } - } - }, - "description": "Returns a list of environments", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "List Environments", - "tags": [ - "Cloud" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-04-13~experimental", - "2022-12-21~beta", - "2023-10-19~beta" - ], - "x-snyk-api-resource": "environments", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2023-10-19~beta", - "x-stability-level": "beta" - }, - "post": { - "description": "Create a new environment and run a scan", - "operationId": "createEnvironment", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Organization ID", - "example": "9a46d918-8764-458c-1234-0987abcd6543", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "$ref": "#/components/schemas/EnvironmentCreateAttributes" - }, - "type": { - "$ref": "#/components/schemas/EnvironmentType" - } - }, - "required": [ - "type" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - } - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "description": "Environment resource object", - "properties": { - "attributes": { - "$ref": "#/components/schemas/EnvironmentAttributes" - }, - "id": { - "description": "Environment ID", - "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", - "format": "uuid", - "type": "string" - }, - "relationships": { - "$ref": "#/components/schemas/EnvironmentRelationships" - }, - "type": { - "$ref": "#/components/schemas/EnvironmentType" - } - }, - "required": [ - "id", - "type" - ], - "type": "object" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - } - } - } - }, - "description": "Created environment successfully", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Create New Environment", - "tags": [ - "Cloud" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-04-13~experimental", - "2022-12-21~beta", - "2023-10-19~beta" - ], - "x-snyk-api-resource": "environments", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2023-10-19~beta", - "x-stability-level": "beta" - } - }, - "/orgs/{org_id}/cloud/environments/{environment_id}": { - "delete": { - "description": "Delete an environment", - "operationId": "deleteEnvironment", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Organization ID", - "example": "9a46d918-8764-458c-1234-0987abcd6543", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/EnvironmentId" - } - ], - "responses": { - "204": { - "description": "Returns an empty response", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Delete Environment", - "tags": [ - "Cloud" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-04-13~experimental", - "2022-12-21~beta", - "2023-10-19~beta" - ], - "x-snyk-api-resource": "environments", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2023-10-19~beta", - "x-stability-level": "beta" - }, - "patch": { - "description": "Update an environment", - "operationId": "updateEnvironment", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Organization ID", - "example": "9a46d918-8764-458c-1234-0987abcd6543", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/EnvironmentId" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "$ref": "#/components/schemas/EnvironmentUpdateAttributes" - }, - "id": { - "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", - "format": "uuid", - "type": "string" - }, - "type": { - "$ref": "#/components/schemas/EnvironmentType" - } - }, - "required": [ - "id", - "type" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - } - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "description": "environment resource object", - "properties": { - "attributes": { - "$ref": "#/components/schemas/EnvironmentAttributes" - }, - "id": { - "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", - "format": "uuid", - "type": "string" - }, - "relationships": { - "$ref": "#/components/schemas/EnvironmentRelationships" - }, - "type": { - "$ref": "#/components/schemas/EnvironmentType" - } - }, - "required": [ - "id", - "type" - ], - "type": "object" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "type": "object" - } - } - }, - "description": "Updated an environment successfully", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Update Environment", - "tags": [ - "Cloud" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-04-13~experimental", - "2022-12-21~beta", - "2023-10-19~beta" - ], - "x-snyk-api-resource": "environments", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2023-10-19~beta", - "x-stability-level": "beta" - } - }, - "/orgs/{org_id}/cloud/permissions": { - "post": { - "description": "Generate IAC template for Snyk to access your cloud resources", - "operationId": "getPermissions", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Organization ID", - "example": "9a46d918-8764-458c-1234-0987abcd6543", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "$ref": "#/components/schemas/CreatePermissionsAttributes" - }, - "type": { - "example": "permission", - "type": "string" - } - }, - "required": [ - "type", - "attributes" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - } - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "description": "permissions resource object", - "properties": { - "attributes": { - "$ref": "#/components/schemas/PermissionsAttributes" - }, - "id": { - "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", - "format": "uuid", - "type": "string" - }, - "type": { - "example": "permission", - "type": "string" - } - }, - "required": [ - "attributes", - "id", - "type" - ], - "type": "object" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - } - } - } - }, - "description": "Created permissions successfully", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Generate Cloud Provider Permissions", - "tags": [ - "Cloud" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-04-13~experimental", - "2022-12-21~beta", - "2023-10-19~beta" - ], - "x-snyk-api-resource": "permissions", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2023-10-19~beta", - "x-stability-level": "beta" - } - }, - "/orgs/{org_id}/cloud/resources": { - "get": { - "description": "List resources for an organization", - "operationId": "listResources", - "parameters": [ - { - "description": "Organization ID", - "example": "9a46d918-8764-458c-1234-0987abcd6543", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/EnvironmentIdQuery" - }, - { - "$ref": "#/components/parameters/ResourceType" - }, - { - "$ref": "#/components/parameters/ResourceId" - }, - { - "$ref": "#/components/parameters/NativeId" - }, - { - "$ref": "#/components/parameters/Id" - }, - { - "description": "Filter resources by platform (multi-value, comma-separated): aws", - "example": "aws", - "explode": false, - "in": "query", - "name": "platform", - "schema": { - "type": "string" - }, - "style": "form" - }, - { - "$ref": "#/components/parameters/Name" - }, - { - "$ref": "#/components/parameters/Kind" - }, - { - "$ref": "#/components/parameters/Location" - }, - { - "$ref": "#/components/parameters/Removed" - }, - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "items": { - "properties": { - "attributes": { - "$ref": "#/components/schemas/ResourceAttributes" - }, - "id": { - "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", - "format": "uuid", - "type": "string" - }, - "relationships": { - "$ref": "#/components/schemas/ResourceRelationships" - }, - "type": { - "example": "resource", - "type": "string" - } - }, - "required": [ - "id", - "type" - ], - "type": "object" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "type": "object" - } - } - }, - "description": "Returns a list of resources", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "List Resources", - "tags": [ - "Cloud" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-04-13~experimental", - "2022-12-21~beta", - "2023-10-19~beta" - ], - "x-snyk-api-resource": "resources", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2023-10-19~beta", - "x-stability-level": "beta" - } - }, - "/orgs/{org_id}/cloud/scans": { - "get": { - "description": "List scans for an organization", - "operationId": "listScan", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "description": "Organization ID", - "example": "9a46d918-8764-458c-1234-0987abcd6543", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "items": { - "properties": { - "attributes": { - "$ref": "#/components/schemas/ScanAttributes" - }, - "id": { - "description": "Scan ID", - "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", - "format": "uuid", - "type": "string" - }, - "relationships": { - "$ref": "#/components/schemas/ScanRelationships" - }, - "type": { - "$ref": "#/components/schemas/ScanType" - } - }, - "required": [ - "id", - "type" - ], - "type": "object" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "type": "object" - } - } - }, - "description": "Returns a list of scan instances", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "List Scans", - "tags": [ - "Cloud" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-04-13~experimental", - "2022-12-21~beta" - ], - "x-snyk-api-resource": "scans", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2022-12-21~beta", - "x-stability-level": "beta" - }, - "post": { - "description": "Create and trigger a new scan for an environment", - "operationId": "createScan", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Organization ID", - "example": "9a46d918-8764-458c-1234-0987abcd6543", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "$ref": "#/components/schemas/ScanCreateAttributes" - }, - "relationships": { - "$ref": "#/components/schemas/ScanCreateRelationships" - }, - "type": { - "$ref": "#/components/schemas/ScanType" - } - }, - "required": [ - "type" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - } - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "description": "Scan resource object", - "properties": { - "attributes": { - "$ref": "#/components/schemas/ScanAttributes" - }, - "id": { - "description": "Scan ID", - "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", - "format": "uuid", - "type": "string" - }, - "relationships": { - "$ref": "#/components/schemas/ScanRelationships" - }, - "type": { - "$ref": "#/components/schemas/ScanType" - } - }, - "required": [ - "id", - "type" - ], - "type": "object" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - } - } - } - }, - "description": "Created scan successfully", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Create Scan", - "tags": [ - "Cloud" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-04-13~experimental", - "2022-12-21~beta" - ], - "x-snyk-api-resource": "scans", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2022-12-21~beta", - "x-stability-level": "beta" - } - }, - "/orgs/{org_id}/cloud/scans/{scan_id}": { - "get": { - "description": "Get a single scan for an organization", - "operationId": "getScan", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Organization ID", - "example": "9a46d918-8764-458c-1234-0987abcd6543", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/ScanId" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "properties": { - "attributes": { - "$ref": "#/components/schemas/ScanAttributes" - }, - "id": { - "description": "Scan ID", - "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", - "format": "uuid", - "type": "string" - }, - "relationships": { - "$ref": "#/components/schemas/ScanRelationships" - }, - "type": { - "$ref": "#/components/schemas/ScanType" - } - }, - "required": [ - "id", - "type" - ], - "type": "object" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "type": "object" - } - } - }, - "description": "Returns a single scan instance", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get scan", - "tags": [ - "Cloud" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-12-21~beta" - ], - "x-snyk-api-resource": "scans", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2022-12-21~beta", - "x-stability-level": "beta" - } - }, - "/orgs/{org_id}/collections": { - "get": { - "description": "Return a list of organization's collections with issues counts and projects count.", - "operationId": "getCollections", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "description": "Return collections sorted by the specified attributes", - "in": "query", - "name": "sort", - "schema": { - "enum": [ - "name", - "projectsCount", - "issues" - ], - "type": "string" - } - }, - { - "description": "Return collections sorted in the specified direction", - "in": "query", - "name": "direction", - "schema": { - "default": "DESC", - "enum": [ - "ASC", - "DESC" - ], - "type": "string" - } - }, - { - "allowEmptyValue": true, - "description": "Return collections which names include the provided string", - "in": "query", - "name": "name", - "schema": { - "maxLength": 255, - "type": "string" - } - }, - { - "allowEmptyValue": true, - "description": "Return collections where is_generated matches the provided boolean", - "in": "query", - "name": "is_generated", - "schema": { - "type": "boolean" - } - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/CollectionResponse" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "type": "object" - } - } - }, - "description": "Returns a list of collections", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get collections", - "tags": [ - "Collection" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-01~beta", - "2023-09-12" - ], - "x-snyk-api-resource": "collections", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-12", - "x-stability-level": "stable" - }, - "post": { - "description": "Create a collection", - "operationId": "createCollection", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/CreateCollectionRequest" - } - } - } - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "description": "collection resource object", - "properties": { - "attributes": { - "$ref": "#/components/schemas/CollectionAttributes" - }, - "id": { - "format": "uuid", - "type": "string" - }, - "relationships": { - "$ref": "#/components/schemas/CollectionRelationships" - }, - "type": { - "$ref": "#/components/schemas/Types" - } - }, - "required": [ - "id", - "attributes", - "relationships" - ], - "type": "object" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/SelfLink" - } - }, - "type": "object" - } - } - }, - "description": "Returned collection", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Create a collection", - "tags": [ - "Collection" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-01~beta", - "2023-09-12" - ], - "x-snyk-api-resource": "collections", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-12", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/collections/{collection_id}": { - "delete": { - "description": "Delete a collection", - "operationId": "deleteCollection", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/CollectionId" - } - ], - "responses": { - "204": { - "description": "Collection was deleted successfully", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Delete a collection", - "tags": [ - "Collection" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-01~beta", - "2023-09-12" - ], - "x-snyk-api-resource": "collections", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-12", - "x-stability-level": "stable" - }, - "get": { - "description": "Get a collection", - "operationId": "getCollection", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/CollectionId" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "description": "collection resource object", - "properties": { - "attributes": { - "$ref": "#/components/schemas/CollectionAttributes" - }, - "id": { - "format": "uuid", - "type": "string" - }, - "relationships": { - "$ref": "#/components/schemas/CollectionRelationships" - }, - "type": { - "$ref": "#/components/schemas/Types" - } - }, - "required": [ - "id", - "attributes", - "relationships" - ], - "type": "object" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/SelfLink" - } - }, - "type": "object" - } - } - }, - "description": "Returned collection", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get a collection", - "tags": [ - "Collection" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-01~beta", - "2023-09-12" - ], - "x-snyk-api-resource": "collections", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-12", - "x-stability-level": "stable" - }, - "patch": { - "description": "Edit a collection", - "operationId": "updateCollection", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/CollectionId" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/UpdateCollectionRequest" - } - } - } - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "description": "collection resource object", - "properties": { - "attributes": { - "$ref": "#/components/schemas/CollectionAttributes" - }, - "id": { - "format": "uuid", - "type": "string" - }, - "relationships": { - "$ref": "#/components/schemas/CollectionRelationships" - }, - "type": { - "$ref": "#/components/schemas/Types" - } - }, - "required": [ - "id", - "attributes", - "relationships" - ], - "type": "object" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/SelfLink" - } - }, - "type": "object" - } - } - }, - "description": "Returned collection", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Edit a collection", - "tags": [ - "Collection" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-01~beta", - "2023-09-12" - ], - "x-snyk-api-resource": "collections", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-12", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/collections/{collection_id}/relationships/projects": { - "delete": { - "description": "Remove projects from a collection by specifying an array of project ids", - "operationId": "deleteProjectsCollection", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/CollectionId" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/DeleteProjectsFromCollectionRequest" - } - } - } - }, - "responses": { - "204": { - "description": "successfully removing projects from a collection", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Remove projects from a collection", - "tags": [ - "Collection" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-01~beta", - "2023-09-12" - ], - "x-snyk-api-resource": "collections", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-12", - "x-stability-level": "stable" - }, - "get": { - "description": "Return a list of organization's projects that are from the specified collection.", - "operationId": "getProjectsOfCollection", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/CollectionId" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "description": "Return projects sorted by the specified attributes", - "in": "query", - "name": "sort", - "schema": { - "enum": [ - "imported", - "last_tested_at", - "issues" - ], - "type": "string" - } - }, - { - "description": "Return projects sorted in the specified direction", - "in": "query", - "name": "direction", - "schema": { - "default": "DESC", - "enum": [ - "ASC", - "DESC" - ], - "type": "string" - } - }, - { - "description": "Return projects that belong to the provided targets", - "in": "query", - "name": "target_id", - "schema": { - "items": { - "format": "uuid", - "type": "string" - }, - "maxItems": 25, - "type": "array" - } - }, - { - "description": "Return projects that are with or without issues", - "in": "query", - "name": "show", - "schema": { - "items": { - "enum": [ - "vuln-groups", - "clean-groups" - ], - "type": "string" - }, - "type": "array" - } - }, - { - "description": "Return projects that match the provided integration types", - "in": "query", - "name": "integration", - "schema": { - "items": { - "enum": [ - "acr", - "api", - "artifactory-cr", - "aws-lambda", - "azure-functions", - "azure-repos", - "bitbucket-cloud", - "bitbucket-connect-app", - "bitbucket-server", - "cli", - "cloud-foundry", - "digitalocean-cr", - "docker-hub", - "ecr", - "gcr", - "github-cr", - "github-enterprise", - "github", - "gitlab-cr", - "gitlab", - "google-artifact-cr", - "harbor-cr", - "heroku", - "ibm-cloud", - "kubernetes", - "nexus-cr", - "pivotal", - "quay-cr", - "terraform-cloud" - ], - "type": "string" - }, - "type": "array" - } - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/GetProjectsOfCollectionResponse" - } - } - }, - "description": "Returns a list of projects from the specified collection", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get projects from the specified collection", - "tags": [ - "Collection" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-01~beta", - "2023-09-12" - ], - "x-snyk-api-resource": "collections", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-12", - "x-stability-level": "stable" - }, - "post": { - "description": "Add projects to a collection by specifying an array of project ids", - "operationId": "updateCollectionWithProjects", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/CollectionId" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/UpdateCollectionWithProjectsRequest" - } - } - } - }, - "responses": { - "204": { - "description": "successfully adding projects to a collection", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Add projects to a collection", - "tags": [ - "Collection" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-01~beta", - "2023-09-12" - ], - "x-snyk-api-resource": "collections", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-12", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/container_images": { - "get": { - "description": "List instances of container image", - "operationId": "listContainerImage", - "parameters": [ - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "example": "f59045b3-f093-40c3-871d-a334ae30c568", - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/ImageIds" - }, - { - "$ref": "#/components/parameters/Platform" - }, - { - "$ref": "#/components/parameters/Names" - }, - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/Image" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "type": "object" - } - } - }, - "description": "Returns a list of container image instances", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "List instances of container image", - "tags": [ - "ContainerImage" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-03-08~beta", - "2023-08-18~beta", - "2023-11-02" - ], - "x-snyk-api-resource": "container_images", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-11-02", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/container_images/{image_id}": { - "get": { - "description": "Get instance of container image", - "operationId": "getContainerImage", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "example": "f59045b3-f093-40c3-871d-a334ae30c568", - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/ImageId20231102" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "$ref": "#/components/schemas/Image" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/SelfLink" - } - }, - "type": "object" - } - } - }, - "description": "Returns an instance of container image", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get instance of container image", - "tags": [ - "ContainerImage" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-03-08~beta", - "2023-11-02" - ], - "x-snyk-api-resource": "container_images", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-11-02", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/container_images/{image_id}/relationships/image_target_refs": { - "get": { - "description": "List instances of image target references for a container image", - "operationId": "listImageTargetRefs", - "parameters": [ - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "example": "f59045b3-f093-40c3-871d-a334ae30c568", - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/ImageId20231102" - }, - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/ImageTargetRef" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "type": "object" - } - } - }, - "description": "Returns a list of image target references for a container image", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "List instances of image target references for a container image", - "tags": [ - "ContainerImage" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-08-18~beta", - "2023-11-02" - ], - "x-snyk-api-resource": "container_images", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-11-02", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/invites": { - "get": { - "description": "List pending user invitations to an organization.", - "operationId": "listOrgInvitation", - "parameters": [ - { - "description": "The id of the org the user is being invited to", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/OrgInvitation" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "List of pending invitations to an organization.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "List pending user invitations to an organization.", - "tags": [ - "Invites" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-11-14" - ], - "x-snyk-api-resource": "org_invitations", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-11-14", - "x-stability-level": "stable" - }, - "post": { - "description": "Invite a user to an organization with a role.", - "operationId": "createOrgInvitation", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "The id of the org the user is being invited to", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/OrgInvitationPostData" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - } - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/OrgInvitation20240621" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data" - ], - "type": "object" - } - } - }, - "description": "A new organization invitation has been created", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "schema": { - "type": "string" - } - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Invite a user to an organization", - "tags": [ - "Invites" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-06-01", - "2023-04-28", - "2024-06-21" - ], - "x-snyk-api-resource": "org_invitations", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-06-21", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/invites/{invite_id}": { - "delete": { - "description": "Cancel a pending user invitations to an organization.", - "operationId": "deleteOrgInvitation", - "parameters": [ - { - "description": "The id of the org the user is being invited to", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "The id of the pending invite to cancel", - "in": "path", - "name": "invite_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "204": { - "$ref": "#/components/responses/204" - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Cancel a pending user invitations to an organization.", - "tags": [ - "Invites" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-11-14" - ], - "x-snyk-api-resource": "org_invitations", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-11-14", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/issues": { - "get": { - "description": "Get a list of an organization's issues.", - "operationId": "listOrgIssues", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "$ref": "#/components/parameters/OrgId" - }, - { - "$ref": "#/components/parameters/ScanItemId" - }, - { - "$ref": "#/components/parameters/ScanItemType" - }, - { - "$ref": "#/components/parameters/Type" - }, - { - "$ref": "#/components/parameters/UpdatedBefore" - }, - { - "$ref": "#/components/parameters/UpdatedAfter" - }, - { - "$ref": "#/components/parameters/CreatedBefore" - }, - { - "$ref": "#/components/parameters/CreatedAfter" - }, - { - "$ref": "#/components/parameters/EffectiveSeverityLevel" - }, - { - "$ref": "#/components/parameters/Status" - }, - { - "$ref": "#/components/parameters/Ignored" - } - ], - "responses": { - "200": { - "$ref": "#/components/responses/ListIssues200" - }, - "401": { - "$ref": "#/components/responses/401__0" - }, - "403": { - "$ref": "#/components/responses/403" - }, - "404": { - "$ref": "#/components/responses/404__0" - }, - "500": { - "$ref": "#/components/responses/500__0" - } - }, - "summary": "Get issues by org ID", - "tags": [ - "Issues" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-03-10~experimental", - "2023-09-29~beta", - "2024-01-23" - ], - "x-snyk-api-resource": "issues", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-01-23", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/issues/{issue_id}": { - "get": { - "description": "Get an issue", - "operationId": "getOrgIssueByIssueID", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/OrgId" - }, - { - "$ref": "#/components/parameters/PathIssueId20240123" - } - ], - "responses": { - "200": { - "$ref": "#/components/responses/GetIssue20020240123" - }, - "400": { - "$ref": "#/components/responses/400__0" - }, - "401": { - "$ref": "#/components/responses/401__0" - }, - "403": { - "$ref": "#/components/responses/403" - }, - "404": { - "$ref": "#/components/responses/404__0" - }, - "409": { - "$ref": "#/components/responses/409" - }, - "500": { - "$ref": "#/components/responses/500__0" - } - }, - "summary": "Get an issue", - "tags": [ - "Issues" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-01-23" - ], - "x-snyk-api-resource": "issues", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-01-23", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/learn/assignments": { - "delete": { - "description": "Allows an admin to delete multiple assignments within their organization.", - "operationId": "deleteOrgAssignments", - "parameters": [ - { - "description": "The unique identifier of the organization.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/ApiVersion" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/DeleteAssignmentsRequest" - } - } - }, - "required": true - }, - "responses": { - "204": { - "description": "Assignments were successfully deleted.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Bulk deletion of assignments in an organization", - "tags": [ - "Learn assignment" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-10-13~beta" - ], - "x-snyk-api-resource": "assignments", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2024-10-13~beta", - "x-stability-level": "beta" - }, - "get": { - "description": "Allows an admin to obtain a comprehensive list of all assignments within their organization.", - "operationId": "listOrgAssignments", - "parameters": [ - { - "description": "The unique identifier of the organization.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/ApiVersion" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/LessonAssignmentDecoratedResource" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/PaginatedLinks" - } - }, - "required": [ - "jsonapi", - "links", - "data" - ], - "type": "object" - } - } - }, - "description": "A list of assignments was successfully retrieved.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Retrieve a list of assignments for an organization", - "tags": [ - "Learn assignment" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-10-13~beta" - ], - "x-snyk-api-resource": "assignments", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2024-10-13~beta", - "x-stability-level": "beta" - }, - "patch": { - "description": "Allows an admin to update the due date for existing assignments within their organization.", - "operationId": "updateOrgAssignments", - "parameters": [ - { - "description": "The unique identifier of the organization.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/ApiVersion" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "$ref": "#/components/schemas/UpdateAssignmentsPayload" - }, - "id": { - "format": "uuid", - "type": "string" - }, - "type": { - "$ref": "#/components/schemas/Types" - } - }, - "required": [ - "id", - "type", - "attributes" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - }, - "required": true - }, - "responses": { - "204": { - "description": "Assignments due date was successfully updated.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Update due date for assignments in an organization.", - "tags": [ - "Learn assignment" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-10-15~beta" - ], - "x-snyk-api-resource": "assignments", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2024-10-15~beta", - "x-stability-level": "beta" - }, - "post": { - "description": "Allows an admin to create assignments in bulk for all or a subset of users within their organization.", - "operationId": "createOrgAssignments", - "parameters": [ - { - "description": "The unique identifier of the organization.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/ApiVersion" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/CreateAssignmentsPayload" - } - } - }, - "required": true - }, - "responses": { - "204": { - "description": "Assignments were successfully created.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Bulk creation of assignments for users in an organization.", - "tags": [ - "Learn assignment" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-10-14~experimental", - "2024-10-15~beta" - ], - "x-snyk-api-resource": "assignments", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2024-10-15~beta", - "x-stability-level": "beta" - } - }, - "/orgs/{org_id}/learn/progress/catalog": { - "get": { - "description": "Shows which users have completed, started or not started a lesson within Snyk Learn, even if they don't have a Snyk Learn account.", - "operationId": "getCatalogProgress", - "parameters": [ - { - "description": "The unique identifier of the organization.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/ApiVersion" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "description": "Filter by the learn catalog resource type", - "in": "query", - "name": "type", - "schema": { - "enum": [ - "learning_path", - "lesson" - ], - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Title" - }, - { - "$ref": "#/components/parameters/Cwes" - }, - { - "$ref": "#/components/parameters/Cves" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/CatalogProgressResponse" - } - } - }, - "description": "Organization reporting users overview", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get learning progress for an organisation", - "tags": [ - "Catalog Progress" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-10-15~beta" - ], - "x-snyk-api-resource": "progress", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2024-10-15~beta", - "x-stability-level": "beta" - } - }, - "/orgs/{org_id}/learn/progress/users": { - "get": { - "description": "List of users within the organization mapped to Snyk Catalog, reporting on users learn progress status for each catalog resource.", - "operationId": "getUsersProgress", - "parameters": [ - { - "description": "The unique identifier of the organization.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/ApiVersion" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "description": "Filter by the learn catalog resource type", - "in": "query", - "name": "type", - "schema": { - "enum": [ - "learning_path", - "lesson" - ], - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Title" - }, - { - "description": "Filter by progress status of the resources", - "in": "query", - "name": "status", - "schema": { - "enum": [ - "completed", - "inProgress", - "todo" - ], - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Emails" - }, - { - "$ref": "#/components/parameters/CompletionInterval" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/UsersProgressResponse" - } - } - }, - "description": "Organization reporting users overview", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get learning progress for organization members", - "tags": [ - "Users Learn Progress" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-10-15~beta" - ], - "x-snyk-api-resource": "progress", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2024-10-15~beta", - "x-stability-level": "beta" - } - }, - "/orgs/{org_id}/memberships": { - "get": { - "description": "Returns all memberships of the org", - "operationId": "listOrgMemberships", - "parameters": [ - { - "description": "The ID of the org", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/SortBy" - }, - { - "$ref": "#/components/parameters/SortOrder" - }, - { - "$ref": "#/components/parameters/EmailFilter" - }, - { - "$ref": "#/components/parameters/UserIdFilter" - }, - { - "$ref": "#/components/parameters/UsernameFilter" - }, - { - "$ref": "#/components/parameters/RoleFilter" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "$ref": "#/components/schemas/OrgMembershipResponseData" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "List of org memberships is returned", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get all memberships of the org", - "tags": [ - "Orgs" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-05-09~experimental", - "2024-08-25" - ], - "x-snyk-api-resource": "orgs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-08-25", - "x-stability-level": "stable" - }, - "post": { - "description": "Create a org membership for a user with role", - "operationId": "createOrgMembership", - "parameters": [ - { - "description": "The ID of the org", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/CreateOrgMembershipRequestBody" - } - } - } - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "$ref": "#/components/schemas/OrgMembership" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "type": "object" - } - } - }, - "description": "Membership for the user is created on the org", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Create a org membership for a user with role", - "tags": [ - "Orgs" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-05-09~experimental", - "2024-08-25" - ], - "x-snyk-api-resource": "orgs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-08-25", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/memberships/{membership_id}": { - "delete": { - "description": "Remove a user's membership of the group.\n", - "operationId": "deleteOrgMembership", - "parameters": [ - { - "$ref": "#/components/parameters/OrgId__0" - }, - { - "$ref": "#/components/parameters/OrgMembershipId" - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "204": { - "description": "Org membership for the user was successfully deleted.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Remove user's org membership", - "tags": [ - "Orgs" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-06-06~experimental", - "2024-08-25" - ], - "x-snyk-api-resource": "org_memberships", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-08-25", - "x-stability-level": "stable" - }, - "patch": { - "description": "Update a org membership for a user with role", - "operationId": "updateOrgMembership", - "parameters": [ - { - "$ref": "#/components/parameters/OrgId__0" - }, - { - "$ref": "#/components/parameters/OrgMembershipId" - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "$ref": "#/components/schemas/UpdateOrgMembershipRequestBody" - } - }, - "type": "object" - } - } - } - }, - "responses": { - "204": { - "description": "The Membership is updated", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Update a org membership for a user with role", - "tags": [ - "Orgs" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-06-06~experimental", - "2024-08-25" - ], - "x-snyk-api-resource": "org_memberships", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-08-25", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/packages/issues": { - "post": { - "description": "This endpoint is not available to all customers. If you are interested please contact support. Query issues for a batch of packages identified by Package URL (purl). Only direct vulnerabilities are returned, transitive vulnerabilities (from dependencies) are not returned because they can vary depending on context.", - "operationId": "listIssuesForManyPurls", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Unique identifier for an organization", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/BulkPackageUrlsRequestBody" - } - } - }, - "required": true - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/IssuesWithPurlsResponse" - } - } - }, - "description": "Returns an array of issues with the purl identifier of the package that caused them", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/Location" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "List issues for a given set of packages (Currently not available to all customers)", - "tags": [ - "Issues" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-01-04~experimental", - "2023-03-29~beta", - "2023-04-17", - "2023-08-21", - "2024-06-26" - ], - "x-snyk-api-resource": "issues", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-06-26", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/packages/{purl}/issues": { - "get": { - "description": "Query issues for a specific package version identified by Package URL (purl). Snyk returns only direct vulnerabilities. Transitive vulnerabilities (from dependencies) are not returned because they can vary depending on context.", - "operationId": "fetchIssuesPerPurl", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/PackageUrl" - }, - { - "description": "Unique identifier for an organization", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "Specify the number of results to skip before returning results. Must be greater than or equal to 0. Default is 0.", - "in": "query", - "name": "offset", - "schema": { - "type": "number" - } - }, - { - "description": "Specify the number of results to return. Must be greater than 0 and less than 1000. Default is 1000.", - "in": "query", - "name": "limit", - "schema": { - "type": "number" - } - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/IssuesResponse" - } - } - }, - "description": "Returns an array of issues", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "List issues for a package", - "tags": [ - "Issues" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-06-29~beta", - "2022-09-15", - "2024-06-26" - ], - "x-snyk-api-resource": "issues", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-06-26", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/projects": { - "get": { - "description": "List all Projects for an Org.", - "operationId": "listOrgProjects", - "parameters": [ - { - "description": "The ID of the org that the projects belong to.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "Return projects that belong to the provided targets", - "in": "query", - "name": "target_id", - "schema": { - "items": { - "format": "uuid", - "type": "string" - }, - "type": "array" - } - }, - { - "description": "Return projects that match the provided target reference", - "in": "query", - "name": "target_reference", - "schema": { - "type": "string" - } - }, - { - "description": "Return projects that match the provided target file", - "in": "query", - "name": "target_file", - "schema": { - "type": "string" - } - }, - { - "description": "Return projects that match the provided target runtime", - "in": "query", - "name": "target_runtime", - "schema": { - "type": "string" - } - }, - { - "description": "The collection count.", - "in": "query", - "name": "meta_count", - "schema": { - "enum": [ - "only" - ], - "type": "string" - } - }, - { - "description": "Return projects that match the provided IDs.", - "explode": false, - "in": "query", - "name": "ids", - "schema": { - "items": { - "format": "uuid", - "type": "string" - }, - "type": "array" - }, - "style": "form" - }, - { - "description": "Return projects that match the provided names.", - "explode": false, - "in": "query", - "name": "names", - "schema": { - "items": { - "type": "string" - }, - "type": "array" - }, - "style": "form" - }, - { - "description": "Return projects with names starting with the specified prefix.", - "explode": false, - "in": "query", - "name": "names_start_with", - "schema": { - "items": { - "type": "string" - }, - "type": "array" - }, - "style": "form" - }, - { - "description": "Return projects that match the provided origins.", - "explode": false, - "in": "query", - "name": "origins", - "schema": { - "items": { - "type": "string" - }, - "type": "array" - }, - "style": "form" - }, - { - "description": "Return projects that match the provided types.", - "explode": false, - "in": "query", - "name": "types", - "schema": { - "items": { - "type": "string" - }, - "type": "array" - }, - "style": "form" - }, - { - "description": "Expand relationships.", - "explode": false, - "in": "query", - "name": "expand", - "schema": { - "items": { - "enum": [ - "target" - ], - "type": "string" - }, - "type": "array" - }, - "style": "form" - }, - { - "description": "Include a summary count for the issues found in the most recent scan of this project", - "in": "query", - "name": "meta.latest_issue_counts", - "schema": { - "type": "boolean" - } - }, - { - "description": "Include the total number of dependencies found in the most recent scan of this project", - "in": "query", - "name": "meta.latest_dependency_total", - "schema": { - "type": "boolean" - } - }, - { - "description": "Filter projects uploaded and monitored before this date (encoded value)", - "example": "2021-05-29T09:50:54.014Z", - "in": "query", - "name": "cli_monitored_before", - "schema": { - "format": "date-time", - "type": "string" - } - }, - { - "description": "Filter projects uploaded and monitored after this date (encoded value)", - "example": "2021-05-29T09:50:54.014Z", - "in": "query", - "name": "cli_monitored_after", - "schema": { - "format": "date-time", - "type": "string" - } - }, - { - "description": "Return projects that match the provided importing user public ids.", - "explode": false, - "in": "query", - "name": "importing_user_public_id", - "schema": { - "items": { - "type": "string" - }, - "type": "array" - }, - "style": "form" - }, - { - "description": "Return projects that match all the provided tags", - "example": [ - "key1:value1", - "key2:value2" - ], - "explode": false, - "in": "query", - "name": "tags", - "schema": { - "items": { - "pattern": "^[a-zA-Z0-9_-]+:[:/?#@\u0026+=%a-zA-Z0-9_.~-]+$", - "type": "string" - }, - "type": "array" - }, - "style": "form" - }, - { - "description": "Return projects that match all the provided business_criticality value", - "explode": false, - "in": "query", - "name": "business_criticality", - "schema": { - "items": { - "enum": [ - "critical", - "high", - "medium", - "low" - ], - "type": "string" - }, - "type": "array" - }, - "style": "form" - }, - { - "description": "Return projects that match all the provided environment values", - "explode": false, - "in": "query", - "name": "environment", - "schema": { - "items": { - "enum": [ - "frontend", - "backend", - "internal", - "external", - "mobile", - "saas", - "onprem", - "hosted", - "distributed" - ], - "type": "string" - }, - "type": "array" - }, - "style": "form" - }, - { - "description": "Return projects that match all the provided lifecycle values", - "explode": false, - "in": "query", - "name": "lifecycle", - "schema": { - "items": { - "enum": [ - "production", - "development", - "sandbox" - ], - "type": "string" - }, - "type": "array" - }, - "style": "form" - }, - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "items": { - "additionalProperties": false, - "properties": { - "attributes": { - "$ref": "#/components/schemas/ProjectAttributes" - }, - "id": { - "description": "Resource ID.", - "format": "uuid", - "type": "string" - }, - "meta": { - "additionalProperties": false, - "properties": { - "cli_monitored_at": { - "description": "The date that the project was last uploaded and monitored using cli.", - "example": "2021-05-29T09:50:54.014Z", - "format": "date-time", - "nullable": true, - "type": "string" - }, - "latest_dependency_total": { - "$ref": "#/components/schemas/LatestDependencyTotal" - }, - "latest_issue_counts": { - "$ref": "#/components/schemas/LatestIssueCounts" - } - }, - "type": "object" - }, - "relationships": { - "$ref": "#/components/schemas/ProjectRelationships" - }, - "type": { - "description": "The Resource type.", - "example": "project", - "type": "string" - } - }, - "required": [ - "id", - "type", - "attributes" - ], - "type": "object" - }, - "type": "array" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - }, - "meta": { - "properties": { - "count": { - "minimum": 0, - "type": "number" - } - }, - "type": "object" - } - }, - "required": [ - "jsonapi", - "links" - ], - "type": "object" - } - } - }, - "description": "A list of projects is returned for the targeted org", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "List all Projects for an Org with the given Org ID.", - "tags": [ - "Projects" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2021-06-04~beta", - "2022-08-12~experimental", - "2022-12-21~experimental", - "2023-02-15", - "2023-08-28", - "2023-09-11", - "2023-11-06", - "2024-05-31" - ], - "x-snyk-api-resource": "projects", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-31", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/projects/{project_id}": { - "delete": { - "description": "Delete one project in the organization by project ID.", - "operationId": "deleteOrgProject", - "parameters": [ - { - "description": "The ID of the org to which the project belongs to.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "The ID of the project.", - "in": "path", - "name": "project_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "204": { - "description": "The project has been deleted", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Delete project by project ID.", - "tags": [ - "Projects" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-11-06", - "2024-05-31" - ], - "x-snyk-api-resource": "projects", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-31", - "x-stability-level": "stable" - }, - "get": { - "description": "Get one project of the organization by project ID.", - "operationId": "getOrgProject", - "parameters": [ - { - "description": "The ID of the org to which the project belongs to.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "The ID of the project.", - "in": "path", - "name": "project_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "Expand relationships.", - "explode": false, - "in": "query", - "name": "expand", - "schema": { - "items": { - "enum": [ - "target" - ], - "type": "string" - }, - "type": "array" - }, - "style": "form" - }, - { - "description": "Include a summary count for the issues found in the most recent scan of this project", - "in": "query", - "name": "meta.latest_issue_counts", - "schema": { - "type": "boolean" - } - }, - { - "description": "Include the total number of dependencies found in the most recent scan of this project", - "in": "query", - "name": "meta.latest_dependency_total", - "schema": { - "type": "boolean" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "$ref": "#/components/schemas/ProjectAttributes" - }, - "id": { - "description": "The Resource ID.", - "format": "uuid", - "type": "string" - }, - "meta": { - "additionalProperties": false, - "properties": { - "cli_monitored_at": { - "description": "The date that the project was last uploaded and monitored using cli.", - "example": "2021-05-29T09:50:54.014Z", - "format": "date-time", - "nullable": true, - "type": "string" - }, - "latest_dependency_total": { - "$ref": "#/components/schemas/LatestDependencyTotal" - }, - "latest_issue_counts": { - "$ref": "#/components/schemas/LatestIssueCounts" - } - }, - "type": "object" - }, - "relationships": { - "$ref": "#/components/schemas/ProjectRelationships" - }, - "type": { - "description": "The Resource type.", - "example": "project", - "type": "string" - } - }, - "required": [ - "id", - "type", - "attributes" - ], - "type": "object" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "A project is returned for the targeted org", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get project by project ID.", - "tags": [ - "Projects" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-02-01~experimental", - "2022-08-12~experimental", - "2022-12-21~experimental", - "2023-02-15", - "2023-08-28", - "2023-09-11", - "2023-11-06", - "2024-05-31" - ], - "x-snyk-api-resource": "projects", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-31", - "x-stability-level": "stable" - }, - "patch": { - "description": "Updates one project of the organization by project ID.", - "operationId": "updateOrgProject", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "The ID of the Org the project belongs to.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "The ID of the project to patch.", - "in": "path", - "name": "project_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "Expand relationships.", - "explode": false, - "in": "query", - "name": "expand", - "schema": { - "items": { - "enum": [ - "target" - ], - "type": "string" - }, - "type": "array" - }, - "style": "form" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/PatchProjectRequest" - } - } - }, - "description": "The project attributes to be updated." - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "$ref": "#/components/schemas/ProjectAttributes" - }, - "id": { - "description": "The Resource ID.", - "example": "331ede0a-de94-456f-b788-166caeca58bf", - "format": "uuid", - "type": "string" - }, - "links": { - "$ref": "#/components/schemas/Links" - }, - "meta": { - "additionalProperties": false, - "properties": { - "cli_monitored_at": { - "description": "The date that the project was last uploaded and monitored using cli.", - "example": "2021-05-29T09:50:54.014Z", - "format": "date-time", - "nullable": true, - "type": "string" - } - }, - "type": "object" - }, - "relationships": { - "$ref": "#/components/schemas/ProjectRelationships" - }, - "type": { - "description": "The Resource type.", - "example": "project", - "type": "string" - } - }, - "required": [ - "type", - "id", - "attributes" - ], - "type": "object" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "A project is updated for the targeted org", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Updates project by project ID.", - "tags": [ - "Projects" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-12-21~experimental", - "2023-02-15", - "2023-08-28", - "2023-09-11", - "2023-11-06", - "2024-05-31" - ], - "x-snyk-api-resource": "projects", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-31", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/projects/{project_id}/sbom": { - "get": { - "description": "This endpoint lets you retrieve the SBOM document of a software project.\nIt supports the following formats:\n* CycloneDX version 1.6 in JSON (set `format` to `cyclonedx1.6+json`).\n* CycloneDX version 1.6 in XML (set `format` to `cyclonedx1.6+xml`).\n* CycloneDX version 1.5 in JSON (set `format` to `cyclonedx1.5+json`).\n* CycloneDX version 1.5 in XML (set `format` to `cyclonedx1.5+xml`).\n* CycloneDX version 1.4 in JSON (set `format` to `cyclonedx1.4+json`).\n* CycloneDX version 1.4 in XML (set `format` to `cyclonedx1.4+xml`).\n* SPDX version 2.3 in JSON (set `format` to `spdx2.3+json`).\n\nBy default it will respond with an empty JSON:API response.", - "operationId": "getSbom", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Unique identifier for an organization", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/ProjectId" - }, - { - "$ref": "#/components/parameters/Format" - }, - { - "$ref": "#/components/parameters/Exclude" - } - ], - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SbomDocument" - } - }, - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/SbomResponse" - } - }, - "application/vnd.cyclonedx+json": { - "schema": { - "$ref": "#/components/schemas/SbomDocument" - } - }, - "application/vnd.cyclonedx+xml": { - "schema": { - "$ref": "#/components/schemas/SbomDocument" - } - } - }, - "description": "Returns the SBOM document of a project", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Get a project’s SBOM document", - "tags": [ - "SBOM" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-03-31~experimental", - "2022-12-06~beta", - "2023-03-20", - "2024-03-12~experimental", - "2024-08-15~beta", - "2024-08-22" - ], - "x-snyk-api-resource": "sboms", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-08-22", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/sbom_tests": { - "post": { - "description": "Create an SBOM test run by supplying an SBOM document. The components contained in the given document will get analyzed for known vulnerabilities. In order for component identification to be successful, they must have a PackageURL (purl) of a supported purl type assigned. Analysis will be skipped for any component that does not fulfill this requirement.\nSupported SBOM formats: CycloneDX 1.4 JSON, CycloneDX 1.5 JSON, CycloneDX 1.6 JSON, SPDX 2.3 JSON\nSupported purl types: apk, deb, cargo, cocoapods, composer, gem, generic, golang, hex, maven, npm, nuget, pypi, rpm, swift\n", - "operationId": "createSbomTestRun", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "$ref": "#/components/schemas/SbomTestCreateAttributes" - }, - "type": { - "$ref": "#/components/schemas/Types" - } - }, - "required": [ - "type" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - } - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "additionalProperties": false, - "description": "SBOM test resource object", - "properties": { - "id": { - "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", - "format": "uuid", - "type": "string" - }, - "type": { - "$ref": "#/components/schemas/Types" - } - }, - "required": [ - "id", - "type" - ], - "type": "object" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "type": "object" - } - } - }, - "description": "Created SBOM test successfully", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "500": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - } - }, - "summary": "Create an SBOM test run", - "tags": [ - "SBOM" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-02~experimental", - "2023-08-31~beta", - "2024-04-22~beta", - "2024-07-10~beta" - ], - "x-snyk-api-resource": "sbom_tests", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2024-07-10~beta", - "x-stability-level": "beta" - } - }, - "/orgs/{org_id}/sbom_tests/{job_id}": { - "get": { - "description": "Get an SBOM test run status", - "operationId": "getSbomTestStatus", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/JobId" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "description": "SBOM test resource object", - "properties": { - "attributes": { - "properties": { - "status": { - "enum": [ - "processing", - "error", - "finished" - ], - "type": "string" - } - }, - "type": "object" - }, - "id": { - "format": "uuid", - "type": "string" - }, - "type": { - "$ref": "#/components/schemas/Types" - } - }, - "required": [ - "id", - "type", - "attributes" - ], - "type": "object" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "type": "object" - } - } - }, - "description": "SBOM test run status", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Unauthorized: the request requires an authentication token.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } - }, - "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Not Found: The resource being operated on could not be found.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" + "id": "55a348e2-c3ad-4bbc-b40e-9b232d1f4122", + "type": "user" } }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "schema": { + "properties": { + "data": { + "$ref": "#/components/schemas/UserPatchRequestBody" + } + }, + "type": "object" } } + } + }, + "responses": { + "204": { + "$ref": "#/components/responses/204" }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" }, "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Update a user's role in a group", + "tags": [ + "Users" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-10-06~beta" + ], + "x-snyk-api-resource": "users", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2022-10-06~beta", + "x-stability-level": "beta" + } + }, + "/learn/catalog": { + "get": { + "description": "List Snyk Learn's catalog resources", + "operationId": "listLearnCatalog", + "parameters": [ + { + "$ref": "#/components/parameters/ApiVersion" + }, + { + "$ref": "#/components/parameters/ContentSource" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], + "data": { "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" + "$ref": "#/components/schemas/EducationResource" }, - "minItems": 1, "type": "array" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" } }, "required": [ - "jsonapi", - "errors" + "data", + "links", + "jsonapi" ], "type": "object" } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Returns a list of catalog resources", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" } }, - "summary": "Gets an SBOM test run status", + "summary": "List Snyk Learn's resources", "tags": [ - "SBOM" + "Catalog Resource" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2023-06-02~experimental", - "2023-08-31~beta", - "2024-04-22~beta", - "2024-07-10~beta" + "2024-05-13~experimental", + "2024-10-13~beta" ], - "x-snyk-api-resource": "sbom_tests", + "x-snyk-api-resource": "catalog", "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2024-07-10~beta", + "x-snyk-api-version": "2024-10-13~beta", "x-stability-level": "beta" } }, - "/orgs/{org_id}/sbom_tests/{job_id}/results": { + "/openapi": { "get": { - "description": "Get an SBOM test run result", - "operationId": "getSbomTestResult", + "description": "List available versions of OpenAPI specification", + "operationId": "listAPIVersions", + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "items": { + "type": "string" + }, + "type": "array" + } + } + }, + "description": "List of available versions is returned", + "headers": { + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "tags": [ + "OpenAPI" + ] + } + }, + "/openapi/{version}": { + "get": { + "description": "Get OpenAPI specification effective at version.", + "operationId": "getAPIVersion", + "parameters": [ + { + "description": "The requested version of the API", + "in": "path", + "name": "version", + "required": true, + "schema": { + "default": "2023-08-31~beta", + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "type": "object" + } + } + }, + "description": "OpenAPI specification matching requested version is returned", + "headers": { + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "tags": [ + "OpenAPI" + ] + } + }, + "/orgs": { + "get": { + "description": "Get a paginated list of organizations you have access to.", + "operationId": "listOrgs", "parameters": [ { "$ref": "#/components/parameters/Version" @@ -145906,17 +21485,54 @@ "$ref": "#/components/parameters/Limit" }, { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, + "description": "If set, only return organizations within the specified group", + "in": "query", + "name": "group_id", "schema": { "format": "uuid", "type": "string" } }, { - "$ref": "#/components/parameters/JobId" + "description": "If true, only return organizations that are not part of a group.", + "in": "query", + "name": "is_personal", + "schema": { + "type": "boolean" + } + }, + { + "description": "Only return orgs whose slug exactly matches this value.", + "in": "query", + "name": "slug", + "schema": { + "maxLength": 100, + "pattern": "^[\\w.-]+$", + "type": "string" + } + }, + { + "description": "Only return orgs whose name contains this value.", + "in": "query", + "name": "name", + "schema": { + "maxLength": 100, + "type": "string" + } + }, + { + "description": "Expand the specified related resources in the response to include their attributes.", + "in": "query", + "name": "expand", + "schema": { + "items": { + "enum": [ + "member_role" + ], + "type": "string" + }, + "type": "array" + } } ], "responses": { @@ -145924,49 +21540,11 @@ "content": { "application/vnd.api+json": { "schema": { + "additionalProperties": false, "properties": { "data": { - "additionalProperties": false, - "description": "SBOM test resource object", - "properties": { - "attributes": { - "$ref": "#/components/schemas/SbomTestResultsAttributes" - }, - "id": { - "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", - "format": "uuid", - "type": "string" - }, - "relationships": { - "properties": { - "affected_packages": { - "properties": { - "data": { - "items": { - "$ref": "#/components/schemas/ResourceReference" - }, - "type": "array" - } - }, - "type": "object" - } - }, - "type": "object" - }, - "type": { - "$ref": "#/components/schemas/Types" - } - }, - "required": [ - "id", - "type" - ], - "type": "object" - }, - "included": { "items": { - "additionalProperties": true, - "type": "object" + "$ref": "#/components/schemas/OrgWithRelationships" }, "type": "array" }, @@ -145974,21 +21552,23 @@ "$ref": "#/components/schemas/JsonApi" }, "links": { - "$ref": "#/components/schemas/Links" + "$ref": "#/components/schemas/PaginatedLinks" } }, + "required": [ + "jsonapi", + "data", + "links" + ], "type": "object" } } }, - "description": "SBOM test results", + "description": "A list of organizations you have access to.", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, "snyk-request-id": { "$ref": "#/components/headers/RequestIdResponseHeader" }, @@ -146005,32 +21585,47 @@ "$ref": "#/components/headers/SunsetHeader" } } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" } }, - "summary": "Gets an SBOM test run result", + "summary": "List accessible organizations", "tags": [ - "SBOM" + "Orgs" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2023-06-02~experimental", - "2023-08-31~beta", - "2024-04-22~beta", - "2024-07-10~beta" + "2022-04-06~experimental", + "2022-12-15~beta", + "2023-05-29", + "2024-02-28" ], - "x-snyk-api-resource": "sbom_tests", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2024-07-10~beta", - "x-stability-level": "beta" + "x-snyk-api-resource": "orgs", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-02-28", + "x-stability-level": "stable" } }, - "/orgs/{org_id}/service_accounts": { + "/orgs/{org_id}": { "get": { - "description": "Get all service accounts for an organization.", - "operationId": "getManyOrgServiceAccounts", + "description": "Returns an org by its ID", + "operationId": "getOrg", "parameters": [ { - "description": "The ID of the Snyk Organization that owns the service accounts.", + "description": "The ID of the org", "in": "path", "name": "org_id", "required": true, @@ -146039,15 +21634,6 @@ "type": "string" } }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, { "$ref": "#/components/parameters/Version" } @@ -146057,13 +21643,9 @@ "content": { "application/vnd.api+json": { "schema": { - "additionalProperties": false, "properties": { "data": { - "items": { - "$ref": "#/components/schemas/ServiceAccount" - }, - "type": "array" + "$ref": "#/components/schemas/Org" }, "jsonapi": { "$ref": "#/components/schemas/JsonApi" @@ -146081,13 +21663,161 @@ } } }, - "description": "A list of service accounts is returned.", + "description": "Org is returned", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" }, - "location": { - "$ref": "#/components/headers/LocationHeader" + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get an org", + "tags": [ + "Orgs" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-02-16~experimental", + "2022-04-06~experimental", + "2022-12-15~beta" + ], + "x-snyk-api-resource": "orgs", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2022-12-15~beta", + "x-stability-level": "beta" + }, + "patch": { + "description": "Update the details of an organization", + "operationId": "updateOrg", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/PathOrgId" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { + "$ref": "#/components/schemas/OrgUpdateAttributes" + }, + "id": { + "description": "The ID of the resource.", + "format": "uuid", + "type": "string" + }, + "type": { + "description": "The type of the resource.", + "enum": [ + "org" + ], + "example": "org", + "type": "string" + } + }, + "required": [ + "id", + "type", + "attributes" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + } + }, + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "additionalProperties": false, + "description": "org resource object", + "properties": { + "attributes": { + "$ref": "#/components/schemas/OrgAttributes" + }, + "id": { + "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", + "format": "uuid", + "type": "string" + }, + "relationships": { + "$ref": "#/components/schemas/OrgRelationships" + }, + "type": { + "enum": [ + "org" + ], + "example": "org", + "type": "string" + } + }, + "required": [ + "id", + "type" + ], + "type": "object" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/SelfLink" + } + }, + "type": "object" + } + } + }, + "description": "Instance of org is updated", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { "$ref": "#/components/headers/RequestIdResponseHeader" @@ -146106,7 +21836,22 @@ } } }, + "204": { + "$ref": "#/components/responses/204" + }, "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -146279,7 +22024,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -146340,7 +22085,124 @@ } } }, - "401": { + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Update organization", + "tags": [ + "Orgs" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-04-06~experimental", + "2022-12-15~beta", + "2023-05-29", + "2024-02-28" + ], + "x-snyk-api-resource": "orgs", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-02-28", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/app_bots": { + "get": { + "deprecated": true, + "description": "Get a list of app bots authorized to an organization. Deprecated, use /orgs/{org_id}/apps/installs instead.", + "operationId": "getAppBots", + "parameters": [ + { + "description": "Expand relationships.", + "explode": false, + "in": "query", + "name": "expand", + "schema": { + "items": { + "enum": [ + "app" + ], + "type": "string" + }, + "type": "array" + }, + "style": "form" + }, + { + "description": "Organization ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "items": { + "$ref": "#/components/schemas/AppBot" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "required": [ + "data", + "jsonapi", + "links" + ], + "type": "object" + } + } + }, + "description": "A list of app bots authorized to the specified organization", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -146513,7 +22375,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -146574,7 +22436,7 @@ } } }, - "403": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -146747,7 +22609,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -146808,6 +22670,9 @@ } } }, + "403": { + "$ref": "#/components/responses/403" + }, "404": { "content": { "application/vnd.api+json": { @@ -147042,7 +22907,7 @@ } } }, - "500": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -147215,7 +23080,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -147275,162 +23140,8 @@ } } } - } - }, - "summary": "Get a list of organization service accounts.", - "tags": [ - "ServiceAccounts" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-09-07" - ], - "x-snyk-api-resource": "service_accounts", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-07", - "x-stability-level": "stable" - }, - "post": { - "description": "Create a service account for an organization. The service account can be used to access the Snyk API.", - "operationId": "createOrgServiceAccount", - "parameters": [ - { - "description": "The ID of the Snyk Organization that is creating and will own the service account.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "additionalProperties": false, - "properties": { - "access_token_ttl_seconds": { - "description": "The time, in seconds, that a generated access token will be valid for. Defaults to 1 hour if unset. Only used when auth_type is one of the oauth_* variants.", - "maximum": 86400, - "minimum": 3600, - "type": "number" - }, - "auth_type": { - "description": "Authentication strategy for the service account:\n * api_key - Regular Snyk API Key.\n * oauth_client_secret - OAuth2 client_credentials grant, which returns a client secret that can be used to retrieve an access token.\n * oauth_private_key_jwt - OAuth2 client_credentials grant, using private_key_jwt client_assertion as laid out in OIDC Connect Core 1.0, section 9.", - "enum": [ - "api_key", - "oauth_client_secret", - "oauth_private_key_jwt" - ], - "type": "string" - }, - "jwks_url": { - "description": "A JWKs URL hosting your public keys, used to verify signed JWT requests. Must be https. Required only when auth_type is oauth_private_key_jwt.", - "type": "string" - }, - "name": { - "description": "A human-friendly name for the service account.", - "type": "string" - }, - "role_id": { - "description": "The ID of the role which the created service account should use. Obtained in the Snyk UI, via \"Group Page\" -\u003e \"Settings\" -\u003e \"Member Roles\" -\u003e \"Create new Role\". Can be shared among multiple accounts.", - "format": "uuid", - "type": "string" - } - }, - "required": [ - "name", - "role_id", - "auth_type" - ], - "type": "object" - }, - "type": { - "description": "The Resource type.", - "enum": [ - "service_account" - ], - "type": "string" - } - }, - "required": [ - "attributes" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - }, - "required": true - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/ServiceAccount" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "A new service account has been created", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } }, - "400": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -147603,7 +23314,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -147663,8 +23374,83 @@ } } } + } + }, + "summary": "Get a list of app bots authorized to an organization.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-03-11" + ], + "x-snyk-api-resource": "app_bots", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2022-03-11", + "x-snyk-sunset-eligible": "2024-07-17", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/app_bots/{bot_id}": { + "delete": { + "deprecated": true, + "description": "Revoke app bot authorization. Deprecated, use /orgs/{org_id}/apps/installs/{install_id} instead.", + "operationId": "deleteAppBot", + "parameters": [ + { + "description": "The ID of the app bot", + "in": "path", + "name": "bot_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } }, - "401": { + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Organization ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "The app bot has been deauthorized", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "schema": { + "type": "string" + } + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -147837,7 +23623,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -147898,7 +23684,7 @@ } } }, - "404": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -148071,7 +23857,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -148132,7 +23918,10 @@ } } }, - "500": { + "403": { + "$ref": "#/components/responses/403" + }, + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -148305,7 +24094,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -148365,76 +24154,8 @@ } } } - } - }, - "summary": "Create a service account for an organization.", - "tags": [ - "ServiceAccounts" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-09-07" - ], - "x-snyk-api-resource": "service_accounts", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-07", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/service_accounts/{serviceaccount_id}": { - "delete": { - "description": "Delete a service account in an organization.", - "operationId": "deleteServiceAccount", - "parameters": [ - { - "description": "The ID of org to which the service account belongs.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "The ID of the service account.", - "in": "path", - "name": "serviceaccount_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "204": { - "description": "The service account has been deleted.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -148607,7 +24328,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -148668,7 +24389,7 @@ } } }, - "401": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -148841,7 +24562,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -148901,8 +24622,104 @@ } } } + } + }, + "summary": "Revoke app bot authorization", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-03-11" + ], + "x-snyk-api-resource": "app_bots", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2022-03-11", + "x-snyk-sunset-eligible": "2024-07-17", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/apps": { + "get": { + "deprecated": true, + "description": "Get a list of apps created by an organization. Deprecated, use /orgs/{org_id}/apps/creations instead.", + "operationId": "getApps", + "parameters": [ + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } }, - "403": { + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "items": { + "$ref": "#/components/schemas/AppData20220311" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "required": [ + "data", + "jsonapi", + "links" + ], + "type": "object" + } + } + }, + "description": "A list of apps created by the specified organization", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -149075,7 +24892,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -149136,7 +24953,7 @@ } } }, - "404": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -149309,7 +25126,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -149370,7 +25187,10 @@ } } }, - "500": { + "403": { + "$ref": "#/components/responses/403" + }, + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -149543,7 +25363,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -149603,101 +25423,242 @@ } } } - } - }, - "summary": "Delete a service account in an organization.", - "tags": [ - "ServiceAccounts" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-09-07" - ], - "x-snyk-api-resource": "service_accounts", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-07", - "x-stability-level": "stable" - }, - "get": { - "description": "Get an organization-level service account by its ID.", - "operationId": "getOneOrgServiceAccount", - "parameters": [ - { - "description": "The ID of the Snyk Organization that owns the service account.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } }, - { - "description": "The ID of the service account.", - "in": "path", - "name": "serviceaccount_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "responses": { - "200": { + "409": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, + "example": { + "errors": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "jsonapi": { + "version": "1.0" + } + }, "properties": { - "data": { - "$ref": "#/components/schemas/ServiceAccount" + "errors": { + "example": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "items": { + "additionalProperties": false, + "example": { + "detail": "Not Found", + "status": "404" + }, + "properties": { + "code": { + "description": "An application-specific error code, expressed as a string value.", + "example": "entity-not-found", + "type": "string" + }, + "detail": { + "description": "A human-readable explanation specific to this occurrence of the problem.", + "example": "The request was missing these required fields: ...", + "type": "string" + }, + "id": { + "description": "A unique identifier for this particular occurrence of the problem.", + "example": "f16c31b5-6129-4571-add8-d589da9be524", + "format": "uuid", + "type": "string" + }, + "links": { + "additionalProperties": false, + "description": "A link that leads to further details about this particular occurrance of the problem.", + "example": { + "about": "https://example.com/about_this_error" + }, + "properties": { + "about": { + "example": "https://example.com/api/resource", + "oneOf": [ + { + "description": "A string containing the link’s URL.", + "example": "https://example.com/api/resource", + "type": "string" + }, + { + "additionalProperties": false, + "example": { + "href": "https://example.com/api/resource" + }, + "properties": { + "href": { + "description": "A string containing the link’s URL.", + "example": "https://example.com/api/resource", + "type": "string" + }, + "meta": { + "additionalProperties": true, + "description": "Free-form object that may contain non-standard information.", + "example": { + "key1": "value1", + "key2": { + "sub_key": "sub_value" + }, + "key3": [ + "array_value1", + "array_value2" + ] + }, + "type": "object" + } + }, + "required": [ + "href" + ], + "type": "object" + } + ] + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": true, + "example": { + "key": "value" + }, + "type": "object" + }, + "source": { + "additionalProperties": false, + "example": { + "pointer": "/data/attributes" + }, + "properties": { + "parameter": { + "description": "A string indicating which URI query parameter caused the error.", + "example": "param1", + "type": "string" + }, + "pointer": { + "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", + "example": "/data/attributes", + "type": "string" + } + }, + "type": "object" + }, + "status": { + "description": "The HTTP status code applicable to this problem, expressed as a string value.", + "example": "400", + "pattern": "^[45]\\d\\d$", + "type": "string" + }, + "title": { + "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", + "example": "Bad request", + "type": "string" + } + }, + "required": [ + "status", + "detail" + ], + "type": "object" + }, + "minItems": 1, + "type": "array" }, "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" + "additionalProperties": false, + "example": { + "version": "1.0" + }, + "properties": { + "version": { + "description": "Version of the JSON API specification this server supports.", + "example": "1.0", + "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "type": "string" + } + }, + "required": [ + "version" + ], + "type": "object" } }, "required": [ "jsonapi", - "data", - "links" + "errors" ], "type": "object" } } }, - "description": "Service account is returned.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" + "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", + "example": "2021-07-01T00:00:00Z", + "schema": { + "format": "date-time", + "type": "string" + } }, "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" + "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", + "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", + "schema": { + "format": "uuid", + "type": "string" + } }, "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" + "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", + "schema": { + "enum": [ + "wip", + "experimental", + "beta", + "ga", + "deprecated", + "sunset" + ], + "example": "ga", + "type": "string" + } }, "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" + "description": "A header containing the version of the endpoint requested by the caller.", + "example": "2021-06-04", + "schema": { + "description": "Requested API version", + "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", + "type": "string" + } }, "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" + "description": "A header containing the version of the endpoint that was served by the API.", + "example": "2021-06-04", + "schema": { + "description": "Resolved API version", + "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", + "type": "string" + } }, "sunset": { - "$ref": "#/components/headers/SunsetHeader" + "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", + "example": "2021-08-02", + "schema": { + "format": "date", + "type": "string" + } } } }, - "400": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -149870,7 +25831,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -149930,242 +25891,88 @@ } } } + } + }, + "summary": "Get a list of apps created by an organization.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-03-11" + ], + "x-snyk-api-resource": "apps", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2022-03-11", + "x-snyk-sunset-eligible": "2024-07-17", + "x-stability-level": "stable" + }, + "post": { + "deprecated": true, + "description": "Create a new app for an organization. Deprecated, use /orgs/{org_id}/apps/creations instead.", + "operationId": "createApp", + "parameters": [ + { + "$ref": "#/components/parameters/Version" }, - "401": { + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/AppPostRequest20220311" + } + } + }, + "description": "app to be created" + }, + "responses": { + "201": { "content": { "application/vnd.api+json": { "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" + "$ref": "#/components/schemas/AppPostResponse20220311" } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Created Snyk App successfully", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { "schema": { - "format": "date-time", "type": "string" } }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, - "403": { + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -150338,7 +26145,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -150399,7 +26206,7 @@ } } }, - "404": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -150572,7 +26379,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -150633,7 +26440,10 @@ } } }, - "500": { + "403": { + "$ref": "#/components/responses/403" + }, + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -150806,7 +26616,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -150866,153 +26676,8 @@ } } } - } - }, - "summary": "Get an organization service account.", - "tags": [ - "ServiceAccounts" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-09-07" - ], - "x-snyk-api-resource": "service_accounts", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-07", - "x-stability-level": "stable" - }, - "patch": { - "description": "Update the name of an organization-level service account by its ID.", - "operationId": "updateOrgServiceAccount", - "parameters": [ - { - "description": "The ID of the Snyk Organization that owns the service account.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } }, - { - "description": "The ID of the service account.", - "in": "path", - "name": "serviceaccount_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/Version" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "additionalProperties": false, - "properties": { - "name": { - "description": "A human-friendly name for the service account. Must be unique within the organization.", - "type": "string" - } - }, - "required": [ - "name" - ], - "type": "object" - }, - "id": { - "description": "The ID of the service account. Must match the id in the url path.", - "format": "uuid", - "type": "string" - }, - "type": { - "description": "The Resource type.", - "enum": [ - "service_account" - ], - "type": "string" - } - }, - "required": [ - "type", - "id", - "attributes" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - }, - "required": true - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/ServiceAccount" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "Service account is returned.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -151185,7 +26850,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -151246,7 +26911,7 @@ } } }, - "401": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -151419,7 +27084,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -151479,8 +27144,103 @@ } } } + } + }, + "summary": "Create a new app for an organization.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-03-11" + ], + "x-snyk-api-resource": "apps", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2022-03-11", + "x-snyk-sunset-eligible": "2024-07-17", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/apps/creations": { + "get": { + "description": "Get a list of apps created by an organization.", + "operationId": "getOrgApps", + "parameters": [ + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } }, - "403": { + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "items": { + "$ref": "#/components/schemas/AppData" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "required": [ + "data", + "jsonapi", + "links" + ], + "type": "object" + } + } + }, + "description": "A list of apps created by the specified organization", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -151653,7 +27413,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -151714,7 +27474,7 @@ } } }, - "404": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -151887,7 +27647,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -151948,7 +27708,10 @@ } } }, - "500": { + "403": { + "$ref": "#/components/responses/403" + }, + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -152121,7 +27884,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -152181,157 +27944,8 @@ } } } - } - }, - "summary": "Update an organization service account.", - "tags": [ - "ServiceAccounts" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-09-07" - ], - "x-snyk-api-resource": "service_accounts", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-07", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/service_accounts/{serviceaccount_id}/secrets": { - "post": { - "description": "Manage the client secret of an organization service account by the service account ID.", - "operationId": "updateOrgServiceAccountSecret", - "parameters": [ - { - "description": "The ID of the Snyk Organization that owns the service account.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "description": "The ID of the service account.", - "in": "path", - "name": "serviceaccount_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } }, - { - "$ref": "#/components/parameters/Version" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "additionalProperties": false, - "properties": { - "mode": { - "description": "Operation to perform:\n * `replace` - Replace existing secrets with a new generated secret.\n * `create` - Add a new secret, preserving existing secrets. A maximum of to two secrets can exist at a time.\n * `delete` - Remove an existing secret by value. At least one secret must remain per service account.\n", - "enum": [ - "replace", - "create", - "delete" - ], - "type": "string" - }, - "secret": { - "description": "Secret to delete when using `delete` mode", - "type": "string" - } - }, - "required": [ - "mode" - ], - "type": "object" - }, - "type": { - "description": "The Resource type.", - "enum": [ - "service_account" - ], - "type": "string" - } - }, - "required": [ - "attributes", - "type" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - }, - "required": true - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/ServiceAccount" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data" - ], - "type": "object" - } - } - }, - "description": "Service account client secret has been updated.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -152504,7 +28118,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -152565,7 +28179,7 @@ } } }, - "401": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -152738,7 +28352,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -152798,8 +28412,87 @@ } } } + } + }, + "summary": "Get a list of apps created by an organization.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-19~experimental", + "2023-11-03" + ], + "x-snyk-api-resource": "apps", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-11-03", + "x-stability-level": "stable" + }, + "post": { + "description": "Create a new Snyk App for an organization.", + "operationId": "createOrgApp", + "parameters": [ + { + "$ref": "#/components/parameters/Version" }, - "403": { + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/AppPostRequest" + } + } + }, + "description": "Snyk App details for app to be created." + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/AppPostResponse" + } + } + }, + "description": "Created Snyk App successfully.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "schema": { + "type": "string" + } + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -152972,7 +28665,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -153033,7 +28726,7 @@ } } }, - "404": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -153206,7 +28899,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -153267,7 +28960,10 @@ } } }, - "500": { + "403": { + "$ref": "#/components/responses/403" + }, + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -153440,7 +29136,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -153500,90 +29196,8 @@ } } } - } - }, - "summary": "Manage an organization service account's client secret.", - "tags": [ - "ServiceAccounts" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-09-07" - ], - "x-snyk-api-resource": "service_accounts", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-07", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/settings/iac": { - "get": { - "description": "Get the Infrastructure as Code Settings for an org.", - "operationId": "getIacSettingsForOrg", - "parameters": [ - { - "$ref": "#/components/parameters/Version" }, - { - "description": "The id of the org whose Infrastructure as Code settings are requested.", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/OrgIacSettingsResponse" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "The Infrastructure as Code Settings of the org.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -153756,7 +29370,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -153817,7 +29431,7 @@ } } }, - "401": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -153990,7 +29604,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -154050,8 +29664,75 @@ } } } + } + }, + "summary": "Create a new Snyk App for an organization.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-19~experimental", + "2023-11-03" + ], + "x-snyk-api-resource": "apps", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-11-03", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/apps/creations/{app_id}": { + "delete": { + "description": "Delete an app by its App ID.", + "operationId": "deleteAppByID", + "parameters": [ + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } }, - "403": { + { + "$ref": "#/components/parameters/AppId" + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "204": { + "description": "The app has been deleted", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "schema": { + "type": "string" + } + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -154224,7 +29905,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -154285,7 +29966,7 @@ } } }, - "404": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -154458,7 +30139,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -154519,7 +30200,10 @@ } } }, - "500": { + "403": { + "$ref": "#/components/responses/403" + }, + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -154692,7 +30376,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -154752,102 +30436,8 @@ } } } - } - }, - "summary": "Get the Infrastructure as Code Settings for an org.", - "tags": [ - "IacSettings" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2021-12-09" - ], - "x-snyk-api-resource": "iac_settings", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2021-12-09", - "x-stability-level": "stable" - }, - "patch": { - "description": "Update the Infrastructure as Code Settings for an org.", - "operationId": "updateIacSettingsForOrg", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "The id of the org whose Infrastructure as Code settings are getting updated", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "$ref": "#/components/schemas/OrgIacSettingsRequest" - } - }, - "type": "object" - } - } - } - }, - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/OrgIacSettingsResponse" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "The Infrastructure as Code Settings of the org were updated.", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } }, - "400": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -155020,7 +30610,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -155081,7 +30671,7 @@ } } }, - "401": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -155254,7 +30844,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -155314,242 +30904,87 @@ } } } + } + }, + "summary": "Delete an app by its App ID.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-19~experimental", + "2023-11-03" + ], + "x-snyk-api-resource": "apps", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-11-03", + "x-stability-level": "stable" + }, + "get": { + "description": "Get a Snyk App by its App ID.", + "operationId": "getAppByID", + "parameters": [ + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } }, - "403": { + { + "$ref": "#/components/parameters/AppId" + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" + "data": { + "$ref": "#/components/schemas/AppData" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/SelfLink" } }, - "required": [ - "jsonapi", - "errors" - ], "type": "object" } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "The requested app", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, - "404": { + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -155722,7 +31157,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -155783,7 +31218,7 @@ } } }, - "500": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -155956,7 +31391,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -156016,90 +31451,245 @@ } } } - } - }, - "summary": "Update the Infrastructure as Code Settings for an org", - "tags": [ - "IacSettings" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2021-12-09" - ], - "x-snyk-api-resource": "iac_settings", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2021-12-09", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/settings/sast": { - "get": { - "description": "Retrieves the SAST settings for an org", - "operationId": "getSastSettings", - "parameters": [ - { - "$ref": "#/components/parameters/Version" }, - { - "description": "The id of the org for which we want to retrieve the SAST settings", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "responses": { - "200": { + "403": { + "$ref": "#/components/responses/403" + }, + "404": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, + "example": { + "errors": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "jsonapi": { + "version": "1.0" + } + }, "properties": { - "data": { - "$ref": "#/components/schemas/SastEnablement" + "errors": { + "example": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "items": { + "additionalProperties": false, + "example": { + "detail": "Not Found", + "status": "404" + }, + "properties": { + "code": { + "description": "An application-specific error code, expressed as a string value.", + "example": "entity-not-found", + "type": "string" + }, + "detail": { + "description": "A human-readable explanation specific to this occurrence of the problem.", + "example": "The request was missing these required fields: ...", + "type": "string" + }, + "id": { + "description": "A unique identifier for this particular occurrence of the problem.", + "example": "f16c31b5-6129-4571-add8-d589da9be524", + "format": "uuid", + "type": "string" + }, + "links": { + "additionalProperties": false, + "description": "A link that leads to further details about this particular occurrance of the problem.", + "example": { + "about": "https://example.com/about_this_error" + }, + "properties": { + "about": { + "example": "https://example.com/api/resource", + "oneOf": [ + { + "description": "A string containing the link’s URL.", + "example": "https://example.com/api/resource", + "type": "string" + }, + { + "additionalProperties": false, + "example": { + "href": "https://example.com/api/resource" + }, + "properties": { + "href": { + "description": "A string containing the link’s URL.", + "example": "https://example.com/api/resource", + "type": "string" + }, + "meta": { + "additionalProperties": true, + "description": "Free-form object that may contain non-standard information.", + "example": { + "key1": "value1", + "key2": { + "sub_key": "sub_value" + }, + "key3": [ + "array_value1", + "array_value2" + ] + }, + "type": "object" + } + }, + "required": [ + "href" + ], + "type": "object" + } + ] + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": true, + "example": { + "key": "value" + }, + "type": "object" + }, + "source": { + "additionalProperties": false, + "example": { + "pointer": "/data/attributes" + }, + "properties": { + "parameter": { + "description": "A string indicating which URI query parameter caused the error.", + "example": "param1", + "type": "string" + }, + "pointer": { + "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", + "example": "/data/attributes", + "type": "string" + } + }, + "type": "object" + }, + "status": { + "description": "The HTTP status code applicable to this problem, expressed as a string value.", + "example": "400", + "pattern": "^[45]\\d\\d$", + "type": "string" + }, + "title": { + "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", + "example": "Bad request", + "type": "string" + } + }, + "required": [ + "status", + "detail" + ], + "type": "object" + }, + "minItems": 1, + "type": "array" }, "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" + "additionalProperties": false, + "example": { + "version": "1.0" + }, + "properties": { + "version": { + "description": "Version of the JSON API specification this server supports.", + "example": "1.0", + "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "type": "string" + } + }, + "required": [ + "version" + ], + "type": "object" } }, "required": [ "jsonapi", - "data", - "links" + "errors" ], "type": "object" } } }, - "description": "The SAST settings for the org are being retrieved", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" + "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", + "example": "2021-07-01T00:00:00Z", + "schema": { + "format": "date-time", + "type": "string" + } }, "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" + "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", + "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", + "schema": { + "format": "uuid", + "type": "string" + } }, "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" + "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", + "schema": { + "enum": [ + "wip", + "experimental", + "beta", + "ga", + "deprecated", + "sunset" + ], + "example": "ga", + "type": "string" + } }, "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" + "description": "A header containing the version of the endpoint requested by the caller.", + "example": "2021-06-04", + "schema": { + "description": "Requested API version", + "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", + "type": "string" + } }, "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" + "description": "A header containing the version of the endpoint that was served by the API.", + "example": "2021-06-04", + "schema": { + "description": "Resolved API version", + "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", + "type": "string" + } }, "sunset": { - "$ref": "#/components/headers/SunsetHeader" + "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", + "example": "2021-08-02", + "schema": { + "format": "date", + "type": "string" + } } } }, - "400": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -156272,7 +31862,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -156333,7 +31923,7 @@ } } }, - "401": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -156506,7 +32096,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -156566,242 +32156,96 @@ } } } + } + }, + "summary": "Get a Snyk App by its App ID.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-19~experimental", + "2023-11-03" + ], + "x-snyk-api-resource": "apps", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-11-03", + "x-stability-level": "stable" + }, + "patch": { + "description": "Update app creation attributes with App ID.", + "operationId": "updateAppCreationByID", + "parameters": [ + { + "$ref": "#/components/parameters/Version" }, - "403": { + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/AppId" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/AppPatchRequest" + } + } + } + }, + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" + "data": { + "$ref": "#/components/schemas/AppData" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/SelfLink" } }, - "required": [ - "jsonapi", - "errors" - ], "type": "object" } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "The update app.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, - "404": { + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -156974,7 +32418,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -157035,7 +32479,7 @@ } } }, - "500": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -157208,7 +32652,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -157268,135 +32712,11 @@ } } } - } - }, - "summary": "Retrieves the SAST settings for an org", - "tags": [ - "SastSettings" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-06-22" - ], - "x-snyk-api-resource": "sast_settings", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-06-22", - "x-stability-level": "stable" - }, - "patch": { - "description": "Enable/Disable the Snyk Code settings for an org", - "operationId": "updateOrgSastSettings", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "The id of the org for which we want to update the Snyk Code setting", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "additionalProperties": false, - "properties": { - "sast_enabled": { - "description": "The value of the updated settings for sastEnabled setting", - "type": "boolean" - } - }, - "required": [ - "sast_enabled" - ], - "type": "object" - }, - "id": { - "format": "uuid", - "type": "string" - }, - "type": { - "type": "string" - } - }, - "required": [ - "id", - "type", - "attributes" - ], - "type": "object" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } }, - "required": true - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/SastEnablement" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "The SAST settings for the org are being updated", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } + "403": { + "$ref": "#/components/responses/403" }, - "400": { + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -157569,7 +32889,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -157630,7 +32950,7 @@ } } }, - "401": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -157803,7 +33123,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -157864,7 +33184,7 @@ } } }, - "403": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -158037,7 +33357,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -158097,8 +33417,142 @@ } } } + } + }, + "summary": "Update app creation attributes such as name, redirect URIs, and access token time to live using the App ID.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-19~experimental", + "2023-11-03" + ], + "x-snyk-api-resource": "apps", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-11-03", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/apps/creations/{app_id}/secrets": { + "post": { + "description": "Manage client secret for the Snyk App.", + "operationId": "manageAppCreationSecret", + "parameters": [ + { + "$ref": "#/components/parameters/Version" }, - "404": { + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/AppId" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { + "additionalProperties": false, + "properties": { + "mode": { + "description": "Operation to perform:\n * `replace` - Replace existing secrets with a new generated\nsecret\n * `create` - Add a new secret, preserving existing secrets\n * `delete` - Remove an existing secret by value\n", + "enum": [ + "replace", + "create", + "delete" + ], + "type": "string" + }, + "secret": { + "description": "Secret to delete when using `delete` mode", + "type": "string" + } + }, + "required": [ + "mode" + ], + "type": "object" + }, + "type": { + "enum": [ + "app" + ], + "type": "string" + } + }, + "required": [ + "attributes", + "type" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + } + }, + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/AppDataWithSecret" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/SelfLink" + } + }, + "type": "object" + } + } + }, + "description": "Secret has been updated.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -158271,7 +33725,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -158332,7 +33786,7 @@ } } }, - "500": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -158505,7 +33959,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -158565,304 +34019,11 @@ } } } - } - }, - "summary": "Enable/Disable the Snyk Code settings for an org", - "tags": [ - "SastSettings" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2023-08-24~experimental", - "2023-09-11" - ], - "x-snyk-api-resource": "sast_settings", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-09-11", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/slack_app/{bot_id}": { - "delete": { - "description": "Remove the given Slack App integration", - "operationId": "deleteSlackDefaultNotificationSettings", - "parameters": [ - { - "$ref": "#/components/parameters/Version" }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/BotId" - } - ], - "responses": { - "204": { - "description": "Slack App integration successfully removed", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } + "403": { + "$ref": "#/components/responses/403" }, - "401": { + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -159035,7 +34196,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -159096,7 +34257,7 @@ } } }, - "403": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -159269,7 +34430,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -159330,7 +34491,7 @@ } } }, - "404": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -159503,7 +34664,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -159563,242 +34724,119 @@ } } } + } + }, + "summary": "Manage client secret for the Snyk App.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-19~experimental", + "2023-11-03" + ], + "x-snyk-api-resource": "apps", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-11-03", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/apps/installs": { + "get": { + "description": "Get a list of apps installed for an organization.", + "operationId": "getAppInstallsForOrg", + "parameters": [ + { + "description": "Expand relationships.", + "explode": false, + "in": "query", + "name": "expand", + "schema": { + "items": { + "enum": [ + "app" + ], + "type": "string" + }, + "type": "array" + }, + "style": "form" + }, + { + "description": "Organization ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } }, - "409": { + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], + "data": { "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" + "$ref": "#/components/schemas/AppInstallData" }, - "minItems": 1, "type": "array" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" } }, "required": [ + "data", "jsonapi", - "errors" + "links" ], "type": "object" } } }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", + "description": "A list of apps installed for the specified organization.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, - "500": { + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -159971,7 +35009,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -160031,87 +35069,245 @@ } } } - } - }, - "summary": "Remove the given Slack App integration", - "tags": [ - "SlackSettings" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-11-07~experimental", - "2022-12-14" - ], - "x-snyk-api-resource": "settings", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-12-14", - "x-stability-level": "stable" - }, - "get": { - "description": "Get Slack integration default notification settings for the provided tenant ID and bot ID.", - "operationId": "getSlackDefaultNotificationSettings", - "parameters": [ - { - "$ref": "#/components/parameters/Version" }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/BotId" - } - ], - "responses": { - "200": { + "401": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, + "example": { + "errors": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "jsonapi": { + "version": "1.0" + } + }, "properties": { - "data": { - "$ref": "#/components/schemas/SlackDefaultSettingsData" + "errors": { + "example": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "items": { + "additionalProperties": false, + "example": { + "detail": "Not Found", + "status": "404" + }, + "properties": { + "code": { + "description": "An application-specific error code, expressed as a string value.", + "example": "entity-not-found", + "type": "string" + }, + "detail": { + "description": "A human-readable explanation specific to this occurrence of the problem.", + "example": "The request was missing these required fields: ...", + "type": "string" + }, + "id": { + "description": "A unique identifier for this particular occurrence of the problem.", + "example": "f16c31b5-6129-4571-add8-d589da9be524", + "format": "uuid", + "type": "string" + }, + "links": { + "additionalProperties": false, + "description": "A link that leads to further details about this particular occurrance of the problem.", + "example": { + "about": "https://example.com/about_this_error" + }, + "properties": { + "about": { + "example": "https://example.com/api/resource", + "oneOf": [ + { + "description": "A string containing the link’s URL.", + "example": "https://example.com/api/resource", + "type": "string" + }, + { + "additionalProperties": false, + "example": { + "href": "https://example.com/api/resource" + }, + "properties": { + "href": { + "description": "A string containing the link’s URL.", + "example": "https://example.com/api/resource", + "type": "string" + }, + "meta": { + "additionalProperties": true, + "description": "Free-form object that may contain non-standard information.", + "example": { + "key1": "value1", + "key2": { + "sub_key": "sub_value" + }, + "key3": [ + "array_value1", + "array_value2" + ] + }, + "type": "object" + } + }, + "required": [ + "href" + ], + "type": "object" + } + ] + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": true, + "example": { + "key": "value" + }, + "type": "object" + }, + "source": { + "additionalProperties": false, + "example": { + "pointer": "/data/attributes" + }, + "properties": { + "parameter": { + "description": "A string indicating which URI query parameter caused the error.", + "example": "param1", + "type": "string" + }, + "pointer": { + "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", + "example": "/data/attributes", + "type": "string" + } + }, + "type": "object" + }, + "status": { + "description": "The HTTP status code applicable to this problem, expressed as a string value.", + "example": "400", + "pattern": "^[45]\\d\\d$", + "type": "string" + }, + "title": { + "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", + "example": "Bad request", + "type": "string" + } + }, + "required": [ + "status", + "detail" + ], + "type": "object" + }, + "minItems": 1, + "type": "array" }, "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/SelfLink" + "additionalProperties": false, + "example": { + "version": "1.0" + }, + "properties": { + "version": { + "description": "Version of the JSON API specification this server supports.", + "example": "1.0", + "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "type": "string" + } + }, + "required": [ + "version" + ], + "type": "object" } }, + "required": [ + "jsonapi", + "errors" + ], "type": "object" } } }, - "description": "Default settings created successfully", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" + "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", + "example": "2021-07-01T00:00:00Z", + "schema": { + "format": "date-time", + "type": "string" + } }, "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" + "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", + "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", + "schema": { + "format": "uuid", + "type": "string" + } }, "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" + "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", + "schema": { + "enum": [ + "wip", + "experimental", + "beta", + "ga", + "deprecated", + "sunset" + ], + "example": "ga", + "type": "string" + } }, "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" + "description": "A header containing the version of the endpoint requested by the caller.", + "example": "2021-06-04", + "schema": { + "description": "Requested API version", + "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", + "type": "string" + } }, "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" + "description": "A header containing the version of the endpoint that was served by the API.", + "example": "2021-06-04", + "schema": { + "description": "Resolved API version", + "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", + "type": "string" + } }, "sunset": { - "$ref": "#/components/headers/SunsetHeader" + "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", + "example": "2021-08-02", + "schema": { + "format": "date", + "type": "string" + } } } }, - "400": { + "403": { + "$ref": "#/components/responses/403" + }, + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -160284,7 +35480,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -160345,7 +35541,7 @@ } } }, - "401": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -160518,7 +35714,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -160579,7 +35775,7 @@ } } }, - "403": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -160752,7 +35948,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -160812,8 +36008,162 @@ } } } + } + }, + "summary": "Get a list of apps installed for an organization.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-19~experimental", + "2023-11-03", + "2024-05-23" + ], + "x-snyk-api-resource": "app_installs", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-23", + "x-stability-level": "stable" + }, + "post": { + "description": "Install a Snyk Apps to this organization, the Snyk App must use unattended authentication eg client credentials.", + "operationId": "createOrgAppInstall", + "parameters": [ + { + "$ref": "#/components/parameters/Version" }, - "404": { + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "properties": { + "type": { + "enum": [ + "app_install" + ], + "example": "app_install", + "type": "string" + } + }, + "type": "object" + }, + "relationships": { + "additionalProperties": false, + "properties": { + "app": { + "additionalProperties": false, + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "id": { + "$ref": "#/components/schemas/Uuid" + }, + "type": { + "enum": [ + "app" + ], + "example": "app", + "type": "string" + } + }, + "required": [ + "id", + "type" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + }, + "required": [ + "app" + ], + "type": "object" + } + }, + "required": [ + "data", + "relationships" + ], + "type": "object" + } + } + }, + "description": "App Install to be created" + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/AppInstallWithClient" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "required": [ + "data", + "jsonapi", + "links" + ], + "type": "object" + } + } + }, + "description": "The newly created app install.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "schema": { + "type": "string" + } + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -160986,7 +36336,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -161047,7 +36397,7 @@ } } }, - "409": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -161220,7 +36570,7 @@ } } }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -161281,7 +36631,10 @@ } } }, - "500": { + "403": { + "$ref": "#/components/responses/403" + }, + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -161454,7 +36807,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -161514,100 +36867,8 @@ } } } - } - }, - "summary": "Get Slack integration default notification settings.", - "tags": [ - "SlackSettings" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-11-07~experimental", - "2022-12-14" - ], - "x-snyk-api-resource": "settings", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-12-14", - "x-stability-level": "stable" - }, - "post": { - "description": "Create new Slack notification default settings for a given tenant.", - "operationId": "createSlackDefaultNotificationSettings", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/BotId" - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/SettingsRequest" - } - } - }, - "description": "Create new Slack notification default settings for a tenant." - }, - "responses": { - "201": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/SlackDefaultSettingsData" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/SelfLink" - } - }, - "type": "object" - } - } - }, - "description": "Default settings created successfully", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } }, - "400": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -161780,7 +37041,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -161841,7 +37102,7 @@ } } }, - "401": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -162014,7 +37275,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -162074,8 +37335,76 @@ } } } + } + }, + "summary": "Install a Snyk Apps to this organization.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-19~experimental", + "2023-11-03", + "2024-05-23" + ], + "x-snyk-api-resource": "app_installs", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-23", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/apps/installs/{install_id}": { + "delete": { + "description": "Revoke app authorization for an Snyk Organization with install ID.", + "operationId": "deleteAppOrgInstallById", + "parameters": [ + { + "$ref": "#/components/parameters/Version" }, - "403": { + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/InstallId" + } + ], + "responses": { + "204": { + "description": "The app install has been revoked.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "schema": { + "type": "string" + } + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -162248,7 +37577,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -162309,7 +37638,7 @@ } } }, - "404": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -162482,7 +37811,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -162543,7 +37872,10 @@ } } }, - "409": { + "403": { + "$ref": "#/components/responses/403" + }, + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -162716,7 +38048,7 @@ } } }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -162777,7 +38109,7 @@ } } }, - "500": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -162950,7 +38282,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -163010,86 +38342,8 @@ } } } - } - }, - "summary": "Create new Slack notification default settings.", - "tags": [ - "SlackSettings" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2022-11-07~experimental", - "2022-12-14" - ], - "x-snyk-api-resource": "settings", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-12-14", - "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/slack_app/{bot_id}/projects": { - "get": { - "description": "Slack notification settings overrides for projects. These settings overrides the default settings configured for the tenant.", - "operationId": "getSlackProjectNotificationSettingsCollection", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "description": "Org ID", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/BotId" - } - ], - "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/GetProjectSettingsCollection" - } - } - }, - "description": "Return default settings for a tenant", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } }, - "400": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -163262,7 +38516,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -163322,8 +38576,148 @@ } } } + } + }, + "summary": "Revoke app authorization for an Snyk Organization with install ID.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-19~experimental", + "2023-11-03", + "2024-05-23" + ], + "x-snyk-api-resource": "app_installs", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-23", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/apps/installs/{install_id}/secrets": { + "post": { + "description": "Manage client secret for non-interactive Snyk App installations.", + "operationId": "updateOrgAppInstallSecret", + "parameters": [ + { + "$ref": "#/components/parameters/Version" }, - "401": { + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/InstallId" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { + "additionalProperties": false, + "properties": { + "mode": { + "description": "Operation to perform:\n * `replace` - Replace existing secrets with a new generated\nsecret\n * `create` - Add a new secret, preserving existing secrets\n * `delete` - Remove an existing secret by value\n", + "enum": [ + "replace", + "create", + "delete" + ], + "type": "string" + }, + "secret": { + "description": "Secret to delete when using `delete` mode", + "type": "string" + } + }, + "required": [ + "mode" + ], + "type": "object" + }, + "type": { + "enum": [ + "app" + ], + "type": "string" + } + }, + "required": [ + "attributes", + "type" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + } + }, + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/AppInstallDataWithSecret" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/SelfLink" + } + }, + "type": "object" + } + } + }, + "description": "Secret has been updated.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "schema": { + "type": "string" + } + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -163496,7 +38890,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -163557,7 +38951,7 @@ } } }, - "403": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -163730,7 +39124,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -163791,6 +39185,9 @@ } } }, + "403": { + "$ref": "#/components/responses/403" + }, "404": { "content": { "application/vnd.api+json": { @@ -164494,25 +39891,27 @@ } } }, - "summary": "Slack notification settings overrides for projects", + "summary": "Manage client secret for non-interactive Snyk App installations.", "tags": [ - "SlackSettings" + "Apps" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2022-11-07~experimental", - "2022-12-14" + "2023-06-19~experimental", + "2023-11-03", + "2024-05-23" ], - "x-snyk-api-resource": "settings", + "x-snyk-api-resource": "app_installs", "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-12-14", + "x-snyk-api-version": "2024-05-23", "x-stability-level": "stable" } }, - "/orgs/{org_id}/slack_app/{bot_id}/projects/{project_id}": { + "/orgs/{org_id}/apps/{client_id}": { "delete": { - "description": "Remove Slack settings override for a project.", - "operationId": "deleteSlackProjectNotificationSettings", + "deprecated": true, + "description": "Delete an app by app id. Deprecated, use /orgs/{org_id}/apps/creations/{app_id} instead.", + "operationId": "deleteApp", "parameters": [ { "$ref": "#/components/parameters/Version" @@ -164528,26 +39927,21 @@ } }, { - "description": "Project ID", - "in": "path", - "name": "project_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/BotId" + "$ref": "#/components/parameters/ClientId" } ], "responses": { "204": { - "description": "Slack settings override for the project removed successfully.", + "description": "The app has been deleted", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" }, + "location": { + "schema": { + "type": "string" + } + }, "snyk-request-id": { "$ref": "#/components/headers/RequestIdResponseHeader" }, @@ -165034,238 +40428,7 @@ } }, "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } + "$ref": "#/components/responses/403" }, "404": { "content": { @@ -165970,27 +41133,25 @@ } } }, - "summary": "Remove Slack settings override for a project.", + "summary": "Delete an app", "tags": [ - "SlackSettings" + "Apps" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2022-11-07~experimental", - "2022-12-14" + "2022-03-11" ], - "x-snyk-api-resource": "settings", + "x-snyk-api-resource": "apps", "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-12-14", + "x-snyk-api-version": "2022-03-11", + "x-snyk-sunset-eligible": "2024-07-17", "x-stability-level": "stable" }, - "patch": { - "description": "Update Slack notification settings for a project.", - "operationId": "updateSlackProjectNotificationSettings", + "get": { + "deprecated": true, + "description": "Get an App by client id. Deprecated, use /orgs/{org_id}/apps/creations/{app_id} instead.", + "operationId": "getApp", "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, { "description": "Org ID", "in": "path", @@ -166002,29 +41163,12 @@ } }, { - "$ref": "#/components/parameters/BotId" + "$ref": "#/components/parameters/ClientId" }, { - "description": "Project ID", - "in": "path", - "name": "project_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/parameters/Version" } ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "$ref": "#/components/schemas/ProjectSettingsPatchRequest" - } - } - }, - "description": "Update existing project specific settings for a project." - }, "responses": { "200": { "content": { @@ -166033,7 +41177,7 @@ "additionalProperties": false, "properties": { "data": { - "$ref": "#/components/schemas/ProjectSettingsData" + "$ref": "#/components/schemas/AppData20220311" }, "jsonapi": { "$ref": "#/components/schemas/JsonApi" @@ -166046,7 +41190,7 @@ } } }, - "description": "Slack notification settings for a project updated successfully.", + "description": "The requested app", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" @@ -166537,238 +41681,7 @@ } }, "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } + "$ref": "#/components/responses/403" }, "404": { "content": { @@ -167473,23 +42386,24 @@ } } }, - "summary": "Update Slack notification settings for a project.", + "summary": "Get an app by client id", "tags": [ - "SlackSettings" + "Apps" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2022-11-07~experimental", - "2022-12-14" + "2022-03-11" ], - "x-snyk-api-resource": "settings", + "x-snyk-api-resource": "apps", "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-12-14", + "x-snyk-api-version": "2022-03-11", + "x-snyk-sunset-eligible": "2024-07-17", "x-stability-level": "stable" }, - "post": { - "description": "Create Slack settings override for a project.", - "operationId": "createSlackProjectNotificationSettings", + "patch": { + "deprecated": true, + "description": "Update app attributes. Deprecated, use /orgs/{org_id}/apps/creations/{app_id} instead.", + "operationId": "updateApp", "parameters": [ { "$ref": "#/components/parameters/Version" @@ -167505,38 +42419,27 @@ } }, { - "description": "Project ID", - "in": "path", - "name": "project_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } - }, - { - "$ref": "#/components/parameters/BotId" + "$ref": "#/components/parameters/ClientId" } ], "requestBody": { "content": { "application/vnd.api+json": { "schema": { - "$ref": "#/components/schemas/SettingsRequest" + "$ref": "#/components/schemas/AppPatchRequest20220311" } } - }, - "description": "Create new Slack notification default settings for a tenant." + } }, "responses": { - "201": { + "200": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, "properties": { "data": { - "$ref": "#/components/schemas/ProjectSettingsData" + "$ref": "#/components/schemas/AppData20220311" }, "jsonapi": { "$ref": "#/components/schemas/JsonApi" @@ -167549,14 +42452,11 @@ } } }, - "description": "Project settings created successfully", + "description": "The update app.", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, "snyk-request-id": { "$ref": "#/components/headers/RequestIdResponseHeader" }, @@ -168043,238 +42943,7 @@ } }, "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } + "$ref": "#/components/responses/403" }, "404": { "content": { @@ -168979,35 +43648,27 @@ } } }, - "summary": "Create a new Slack settings override for a given project.", + "summary": "Update app attributes that are name, redirect URIs, and access token time to live", "tags": [ - "SlackSettings" + "Apps" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2022-11-07~experimental", - "2022-12-14" + "2022-03-11" ], - "x-snyk-api-resource": "settings", + "x-snyk-api-resource": "apps", "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-12-14", + "x-snyk-api-version": "2022-03-11", + "x-snyk-sunset-eligible": "2024-07-17", "x-stability-level": "stable" } }, - "/orgs/{org_id}/slack_app/{tenant_id}/channels": { - "get": { - "description": "Requires the Snyk Slack App to be set up for this org, will retrieve a list of channels the Snyk Slack App can access. Note that it is currently only possible to page forwards through this collection, no prev links will be generated and the ending_before parameter will not function.", - "operationId": "listChannels", + "/orgs/{org_id}/apps/{client_id}/secrets": { + "post": { + "deprecated": true, + "description": "Manage client secrets for an app. Deprecated, use /orgs/{org_id}/apps/creations/{app_id}/secrets instead.", + "operationId": "manageSecrets", "parameters": [ - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/ChannelLimit" - }, { "$ref": "#/components/parameters/Version" }, @@ -169022,16 +43683,37 @@ } }, { - "description": "Tenant ID", - "in": "path", - "name": "tenant_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/parameters/ClientId" } ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "mode": { + "description": "Operation to perform:\n * `replace` - Replace existing secrets with a new generated\nsecret\n * `create` - Add a new secret, preserving existing secrets\n * `delete` - Remove an existing secret by value\n", + "enum": [ + "replace", + "create", + "delete" + ], + "type": "string" + }, + "secret": { + "description": "Secret to delete when using `delete` mode", + "type": "string" + } + }, + "required": [ + "mode" + ], + "type": "object" + } + } + } + }, "responses": { "200": { "content": { @@ -169040,28 +43722,20 @@ "additionalProperties": false, "properties": { "data": { - "items": { - "$ref": "#/components/schemas/SlackChannel" - }, - "type": "array" + "$ref": "#/components/schemas/AppDataWithSecret20220311" }, "jsonapi": { "$ref": "#/components/schemas/JsonApi" }, "links": { - "$ref": "#/components/schemas/PaginatedLinks" + "$ref": "#/components/schemas/SelfLink" } }, - "required": [ - "data", - "jsonapi", - "links" - ], "type": "object" } } }, - "description": "List of Slack channels", + "description": "Secrets have been updated.", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" @@ -169552,238 +44226,7 @@ } }, "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } + "$ref": "#/components/responses/403" }, "404": { "content": { @@ -170488,30 +44931,32 @@ } } }, - "summary": "Get a list of Slack channels", + "summary": "Manage client secrets for an app.", "tags": [ - "Slack" + "Apps" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2022-11-07" + "2022-03-11" ], - "x-snyk-api-resource": "channels", + "x-snyk-api-resource": "apps", "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-11-07", + "x-snyk-api-version": "2022-03-11", + "x-snyk-sunset-eligible": "2024-07-17", "x-stability-level": "stable" } }, - "/orgs/{org_id}/slack_app/{tenant_id}/channels/{channel_id}": { + "/orgs/{org_id}/audit_logs/search": { "get": { - "description": "Requires the Snyk Slack App to be set up for this org. It will return the Slack channel name for the provided Slack channel ID.", - "operationId": "getChannelNameById", + "description": "Search audit logs for an Organization. \"api.access\" events are omitted from results unless explicitly requested using the events parameter. Supported event types:\n - api.access\n - org.app_bot.create\n - org.app.create\n - org.app.delete\n - org.app.edit\n - org.cloud_config.settings.edit\n - org.collection.create\n - org.collection.delete\n - org.collection.edit\n - org.create\n - org.delete\n - org.edit\n - org.ignore_policy.edit\n - org.integration.create\n - org.integration.delete\n - org.integration.edit\n - org.integration.settings.edit\n - org.language_settings.edit\n - org.notification_settings.edit\n - org.org_source.create\n - org.org_source.delete\n - org.org_source.edit\n - org.policy.edit\n - org.project_filter.create\n - org.project_filter.delete\n - org.project.add\n - org.project.attributes.edit\n - org.project.delete\n - org.project.edit\n - org.project.fix_pr.auto_open\n - org.project.fix_pr.manual_open\n - org.project.ignore.create\n - org.project.ignore.delete\n - org.project.ignore.edit\n - org.project.monitor\n - org.project.pr_check.edit\n - org.project.remove\n - org.project.settings.delete\n - org.project.settings.edit\n - org.project.stop_monitor\n - org.project.tag.add\n - org.project.tag.remove\n - org.project.test\n - org.request_access_settings.edit\n - org.sast_settings.edit\n - org.service_account.create\n - org.service_account.delete\n - org.service_account.edit\n - org.settings.feature_flag.edit\n - org.target.create\n - org.target.delete\n - org.user.add\n - org.user.invite\n - org.user.invite.accept\n - org.user.invite.revoke\n - org.user.invite_link.accept\n - org.user.invite_link.create\n - org.user.invite_link.revoke\n - org.user.leave\n - org.user.provision.accept\n - org.user.provision.create\n - org.user.provision.delete\n - org.user.remove\n - org.user.role.create\n - org.user.role.delete\n - org.user.role.details.edit\n - org.user.role.edit\n - org.user.role.permissions.edit\n - org.webhook.add\n - org.webhook.delete\n - user.org.notification_settings.edit\n", + "operationId": "listOrgAuditLogs", "parameters": [ { "$ref": "#/components/parameters/Version" }, { - "description": "Org ID", + "description": "The ID of the organization.", + "example": "0d3728ec-eebf-484d-9907-ba238019f10b", "in": "path", "name": "org_id", "required": true, @@ -170521,17 +44966,56 @@ } }, { - "$ref": "#/components/parameters/ChannelId" + "$ref": "#/components/parameters/Cursor" }, { - "description": "Tenant ID", - "in": "path", - "name": "tenant_id", - "required": true, + "$ref": "#/components/parameters/From" + }, + { + "$ref": "#/components/parameters/To" + }, + { + "$ref": "#/components/parameters/Size" + }, + { + "description": "Order in which results are returned.", + "example": "ASC", + "in": "query", + "name": "sort_order", + "schema": { + "default": "DESC", + "enum": [ + "ASC", + "DESC" + ], + "type": "string" + } + }, + { + "description": "Filter logs by user ID.", + "example": "0d3728ec-eebf-484d-9907-ba238019f10b", + "in": "query", + "name": "user_id", "schema": { "format": "uuid", "type": "string" } + }, + { + "description": "Filter logs by project ID.", + "example": "0d3728ec-eebf-484d-9907-ba238019f10b", + "in": "query", + "name": "project_id", + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Events" + }, + { + "$ref": "#/components/parameters/ExcludeEvents" } ], "responses": { @@ -170542,25 +45026,217 @@ "additionalProperties": false, "properties": { "data": { - "$ref": "#/components/schemas/SlackChannel" + "$ref": "#/components/schemas/AuditLogSearch" }, "jsonapi": { "$ref": "#/components/schemas/JsonApi" }, "links": { - "$ref": "#/components/schemas/SelfLink" + "$ref": "#/components/schemas/Links" } }, "required": [ - "data", "jsonapi", - "links" + "data" ], "type": "object" } } }, - "description": "List of Slack channels", + "description": "Organization Audit Logs.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "schema": { + "type": "string" + } + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Search Organization audit logs.", + "tags": [ + "Audit Logs" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-09-11", + "2024-04-29" + ], + "x-snyk-api-resource": "audit-logs", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-04-29", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/cloud/environments": { + "get": { + "description": "List environments for an organization", + "operationId": "listEnvironments", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Organization ID", + "example": "9a46d918-8764-458c-1234-0987abcd6543", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "Return environments created after this date", + "example": "2022-05-06T12:25:15-04:00", + "in": "query", + "name": "created_after", + "schema": { + "format": "date-time", + "type": "string" + } + }, + { + "description": "Return environments created before this date", + "example": "2022-05-06T12:25:15-04:00", + "in": "query", + "name": "created_before", + "schema": { + "format": "date-time", + "type": "string" + } + }, + { + "description": "Return environments updated after this date", + "example": "2022-05-06T12:25:15-04:00", + "in": "query", + "name": "updated_after", + "schema": { + "format": "date-time", + "type": "string" + } + }, + { + "description": "Return environments updated before this date", + "example": "2022-05-06T12:25:15-04:00", + "in": "query", + "name": "updated_before", + "schema": { + "format": "date-time", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/NameInQuery" + }, + { + "$ref": "#/components/parameters/KindInQuery" + }, + { + "$ref": "#/components/parameters/StatusInQuery" + }, + { + "$ref": "#/components/parameters/IdInQuery" + }, + { + "description": "Filter environments by project ID", + "example": "9a46d918-8764-458c-1234-0987abcd6543", + "in": "query", + "name": "project_id", + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "items": { + "properties": { + "attributes": { + "$ref": "#/components/schemas/EnvironmentAttributes" + }, + "id": { + "description": "Environment ID", + "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", + "format": "uuid", + "type": "string" + }, + "relationships": { + "$ref": "#/components/schemas/EnvironmentRelationships" + }, + "type": { + "$ref": "#/components/schemas/EnvironmentType" + } + }, + "required": [ + "id", + "type" + ], + "type": "object" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "type": "object" + } + } + }, + "description": "Returns a list of environments", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" @@ -170583,6 +45259,18 @@ } }, "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -170755,7 +45443,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -170816,241 +45504,153 @@ } } }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "List Environments", + "tags": [ + "Cloud" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-04-13~experimental", + "2022-12-21~beta", + "2023-10-19~beta" + ], + "x-snyk-api-resource": "environments", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2023-10-19~beta", + "x-stability-level": "beta" + }, + "post": { + "description": "Create a new environment and run a scan", + "operationId": "createEnvironment", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Organization ID", + "example": "9a46d918-8764-458c-1234-0987abcd6543", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { + "$ref": "#/components/schemas/EnvironmentCreateAttributes" }, - "minItems": 1, - "type": "array" + "type": { + "$ref": "#/components/schemas/EnvironmentType" + } }, - "jsonapi": { + "required": [ + "type" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + } + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { "additionalProperties": false, - "example": { - "version": "1.0" - }, + "description": "Environment resource object", "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "attributes": { + "$ref": "#/components/schemas/EnvironmentAttributes" + }, + "id": { + "description": "Environment ID", + "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", + "format": "uuid", "type": "string" + }, + "relationships": { + "$ref": "#/components/schemas/EnvironmentRelationships" + }, + "type": { + "$ref": "#/components/schemas/EnvironmentType" } }, "required": [ - "version" + "id", + "type" ], "type": "object" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" + } } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Created environment successfully", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -171223,7 +45823,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -171284,7 +45884,86 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Create New Environment", + "tags": [ + "Cloud" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-04-13~experimental", + "2022-12-21~beta", + "2023-10-19~beta" + ], + "x-snyk-api-resource": "environments", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2023-10-19~beta", + "x-stability-level": "beta" + } + }, + "/orgs/{org_id}/cloud/environments/{environment_id}": { + "delete": { + "description": "Delete an environment", + "operationId": "deleteEnvironment", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Organization ID", + "example": "9a46d918-8764-458c-1234-0987abcd6543", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/EnvironmentId" + } + ], + "responses": { + "204": { + "description": "Returns an empty response", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -171457,7 +46136,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -171518,6 +46197,158 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Delete Environment", + "tags": [ + "Cloud" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-04-13~experimental", + "2022-12-21~beta", + "2023-10-19~beta" + ], + "x-snyk-api-resource": "environments", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2023-10-19~beta", + "x-stability-level": "beta" + }, + "patch": { + "description": "Update an environment", + "operationId": "updateEnvironment", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Organization ID", + "example": "9a46d918-8764-458c-1234-0987abcd6543", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/EnvironmentId" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { + "$ref": "#/components/schemas/EnvironmentUpdateAttributes" + }, + "id": { + "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", + "format": "uuid", + "type": "string" + }, + "type": { + "$ref": "#/components/schemas/EnvironmentType" + } + }, + "required": [ + "id", + "type" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + } + }, + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "additionalProperties": false, + "description": "environment resource object", + "properties": { + "attributes": { + "$ref": "#/components/schemas/EnvironmentAttributes" + }, + "id": { + "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", + "format": "uuid", + "type": "string" + }, + "relationships": { + "$ref": "#/components/schemas/EnvironmentRelationships" + }, + "type": { + "$ref": "#/components/schemas/EnvironmentType" + } + }, + "required": [ + "id", + "type" + ], + "type": "object" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "type": "object" + } + } + }, + "description": "Updated an environment successfully", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, "409": { "content": { "application/vnd.api+json": { @@ -171752,7 +46583,155 @@ } } }, - "500": { + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Update Environment", + "tags": [ + "Cloud" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-04-13~experimental", + "2022-12-21~beta", + "2023-10-19~beta" + ], + "x-snyk-api-resource": "environments", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2023-10-19~beta", + "x-stability-level": "beta" + } + }, + "/orgs/{org_id}/cloud/permissions": { + "post": { + "description": "Generate IAC template for Snyk to access your cloud resources", + "operationId": "getPermissions", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Organization ID", + "example": "9a46d918-8764-458c-1234-0987abcd6543", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { + "$ref": "#/components/schemas/CreatePermissionsAttributes" + }, + "type": { + "example": "permission", + "type": "string" + } + }, + "required": [ + "type", + "attributes" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + } + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "additionalProperties": false, + "description": "permissions resource object", + "properties": { + "attributes": { + "$ref": "#/components/schemas/PermissionsAttributes" + }, + "id": { + "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", + "format": "uuid", + "type": "string" + }, + "type": { + "example": "permission", + "type": "string" + } + }, + "required": [ + "attributes", + "id", + "type" + ], + "type": "object" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + } + } + } + }, + "description": "Created permissions successfully", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -171925,7 +46904,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -171985,59 +46964,35 @@ } } } + }, + "500": { + "$ref": "#/components/responses/500" } }, - "summary": "Get Slack Channel name by Slack Channel ID.", + "summary": "Generate Cloud Provider Permissions", "tags": [ - "Slack" + "Cloud" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2022-11-07" + "2022-04-13~experimental", + "2022-12-21~beta", + "2023-10-19~beta" ], - "x-snyk-api-resource": "channels", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-11-07", - "x-stability-level": "stable" + "x-snyk-api-resource": "permissions", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2023-10-19~beta", + "x-stability-level": "beta" } }, - "/orgs/{org_id}/targets": { + "/orgs/{org_id}/cloud/resources": { "get": { - "description": "Get a list of an organization's targets.", - "operationId": "getOrgsTargets", + "description": "List resources for an organization", + "operationId": "listResources", "parameters": [ { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "description": "Calculate total amount of filtered results", - "in": "query", - "name": "count", - "schema": { - "type": "boolean" - } - }, - { - "description": "Number of results to return per page", - "example": 10, - "in": "query", - "name": "limit", - "schema": { - "default": 10, - "format": "int32", - "maximum": 100, - "minimum": 1, - "type": "integer" - } - }, - { - "description": "The id of the org to return a list of targets", + "description": "Organization ID", + "example": "9a46d918-8764-458c-1234-0987abcd6543", "in": "path", "name": "org_id", "required": true, @@ -172047,95 +47002,54 @@ } }, { - "description": "Return targets that match the provided value of is_private", - "in": "query", - "name": "is_private", - "schema": { - "type": "boolean" - } + "$ref": "#/components/parameters/EnvironmentIdQuery" }, { - "description": "Return only the targets that has projects", - "in": "query", - "name": "exclude_empty", - "schema": { - "default": true, - "type": "boolean" - } + "$ref": "#/components/parameters/ResourceType" }, { - "description": "Return targets that match the provided remote_url.", - "in": "query", - "name": "url", - "schema": { - "type": "string" - } + "$ref": "#/components/parameters/ResourceId" }, { - "description": "Return targets that match the provided source_types", + "$ref": "#/components/parameters/NativeId" + }, + { + "$ref": "#/components/parameters/Id" + }, + { + "description": "Filter resources by platform (multi-value, comma-separated): aws", + "example": "aws", "explode": false, "in": "query", - "name": "source_types", + "name": "platform", "schema": { - "items": { - "enum": [ - "bitbucket-server", - "gitlab", - "github-enterprise", - "bitbucket-cloud", - "bitbucket-connect-app", - "azure-repos", - "github", - "github-cloud-app", - "github-server-app", - "cli", - "docker-hub", - "in-memory-fs", - "acr", - "ecr", - "gcr", - "artifactory-cr", - "harbor-cr", - "quay-cr", - "github-cr", - "nexus-cr", - "nexus-private-repo", - "digitalocean-cr", - "gitlab-cr", - "google-artifact-cr", - "heroku", - "kubernetes", - "api", - "aws-lambda", - "azure-functions", - "cloud-foundry", - "pivotal", - "ibm-cloud", - "terraform-cloud" - ], - "type": "string" - }, - "type": "array" + "type": "string" }, "style": "form" }, { - "description": "Return targets with display names starting with the provided string", - "in": "query", - "name": "display_name", - "schema": { - "type": "string" - } + "$ref": "#/components/parameters/Name" }, { - "description": "Return only targets which have been created at or after the specified date.\n", - "example": "2022-01-01T16:00:00Z", - "in": "query", - "name": "created_gte", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/parameters/Kind" + }, + { + "$ref": "#/components/parameters/Location" + }, + { + "$ref": "#/components/parameters/Removed" + }, + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" } ], "responses": { @@ -172143,11 +47057,31 @@ "content": { "application/vnd.api+json": { "schema": { - "additionalProperties": false, "properties": { "data": { "items": { - "$ref": "#/components/schemas/PublicTarget" + "properties": { + "attributes": { + "$ref": "#/components/schemas/ResourceAttributes" + }, + "id": { + "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", + "format": "uuid", + "type": "string" + }, + "relationships": { + "$ref": "#/components/schemas/ResourceRelationships" + }, + "type": { + "example": "resource", + "type": "string" + } + }, + "required": [ + "id", + "type" + ], + "type": "object" }, "type": "array" }, @@ -172155,31 +47089,14 @@ "$ref": "#/components/schemas/JsonApi" }, "links": { - "$ref": "#/components/schemas/Links" - }, - "meta": { - "additionalProperties": false, - "example": { - "count": 3 - }, - "properties": { - "count": { - "type": "number" - } - }, - "type": "object" + "$ref": "#/components/schemas/PaginatedLinks" } }, - "required": [ - "jsonapi", - "data", - "links" - ], "type": "object" } } }, - "description": "A list of targets is returned for the targeted org", + "description": "Returns a list of resources", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" @@ -172202,6 +47119,18 @@ } }, "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -172374,7 +47303,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -172435,7 +47364,134 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "List Resources", + "tags": [ + "Cloud" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-04-13~experimental", + "2022-12-21~beta", + "2023-10-19~beta" + ], + "x-snyk-api-resource": "resources", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2023-10-19~beta", + "x-stability-level": "beta" + } + }, + "/orgs/{org_id}/cloud/scans": { + "get": { + "description": "List scans for an organization", + "operationId": "listScan", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "description": "Organization ID", + "example": "9a46d918-8764-458c-1234-0987abcd6543", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "items": { + "properties": { + "attributes": { + "$ref": "#/components/schemas/ScanAttributes" + }, + "id": { + "description": "Scan ID", + "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", + "format": "uuid", + "type": "string" + }, + "relationships": { + "$ref": "#/components/schemas/ScanRelationships" + }, + "type": { + "$ref": "#/components/schemas/ScanType" + } + }, + "required": [ + "id", + "type" + ], + "type": "object" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "type": "object" + } + } + }, + "description": "Returns a list of scan instances", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -172583,93 +47639,241 @@ }, "jsonapi": { "additionalProperties": false, - "example": { - "version": "1.0" - }, + "example": { + "version": "1.0" + }, + "properties": { + "version": { + "description": "Version of the JSON API specification this server supports.", + "example": "1.0", + "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "type": "string" + } + }, + "required": [ + "version" + ], + "type": "object" + } + }, + "required": [ + "jsonapi", + "errors" + ], + "type": "object" + } + } + }, + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", + "headers": { + "deprecation": { + "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", + "example": "2021-07-01T00:00:00Z", + "schema": { + "format": "date-time", + "type": "string" + } + }, + "snyk-request-id": { + "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", + "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", + "schema": { + "format": "uuid", + "type": "string" + } + }, + "snyk-version-lifecycle-stage": { + "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", + "schema": { + "enum": [ + "wip", + "experimental", + "beta", + "ga", + "deprecated", + "sunset" + ], + "example": "ga", + "type": "string" + } + }, + "snyk-version-requested": { + "description": "A header containing the version of the endpoint requested by the caller.", + "example": "2021-06-04", + "schema": { + "description": "Requested API version", + "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", + "type": "string" + } + }, + "snyk-version-served": { + "description": "A header containing the version of the endpoint that was served by the API.", + "example": "2021-06-04", + "schema": { + "description": "Resolved API version", + "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", + "type": "string" + } + }, + "sunset": { + "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", + "example": "2021-08-02", + "schema": { + "format": "date", + "type": "string" + } + } + } + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "List Scans", + "tags": [ + "Cloud" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-04-13~experimental", + "2022-12-21~beta" + ], + "x-snyk-api-resource": "scans", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2022-12-21~beta", + "x-stability-level": "beta" + }, + "post": { + "description": "Create and trigger a new scan for an environment", + "operationId": "createScan", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Organization ID", + "example": "9a46d918-8764-458c-1234-0987abcd6543", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { + "$ref": "#/components/schemas/ScanCreateAttributes" + }, + "relationships": { + "$ref": "#/components/schemas/ScanCreateRelationships" + }, + "type": { + "$ref": "#/components/schemas/ScanType" + } + }, + "required": [ + "type" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + } + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "additionalProperties": false, + "description": "Scan resource object", "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "attributes": { + "$ref": "#/components/schemas/ScanAttributes" + }, + "id": { + "description": "Scan ID", + "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", + "format": "uuid", "type": "string" + }, + "relationships": { + "$ref": "#/components/schemas/ScanRelationships" + }, + "type": { + "$ref": "#/components/schemas/ScanType" } }, "required": [ - "version" + "id", + "type" ], "type": "object" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" + } } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Created scan successfully", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -172842,7 +48046,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -172903,7 +48107,124 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Create Scan", + "tags": [ + "Cloud" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-04-13~experimental", + "2022-12-21~beta" + ], + "x-snyk-api-resource": "scans", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2022-12-21~beta", + "x-stability-level": "beta" + } + }, + "/orgs/{org_id}/cloud/scans/{scan_id}": { + "get": { + "description": "Get a single scan for an organization", + "operationId": "getScan", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Organization ID", + "example": "9a46d918-8764-458c-1234-0987abcd6543", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/ScanId" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "properties": { + "attributes": { + "$ref": "#/components/schemas/ScanAttributes" + }, + "id": { + "description": "Scan ID", + "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", + "format": "uuid", + "type": "string" + }, + "relationships": { + "$ref": "#/components/schemas/ScanRelationships" + }, + "type": { + "$ref": "#/components/schemas/ScanType" + } + }, + "required": [ + "id", + "type" + ], + "type": "object" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "type": "object" + } + } + }, + "description": "Returns a single scan instance", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -173076,7 +48397,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -173138,6 +48459,278 @@ } }, "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get scan", + "tags": [ + "Cloud" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-12-21~beta" + ], + "x-snyk-api-resource": "scans", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2022-12-21~beta", + "x-stability-level": "beta" + } + }, + "/orgs/{org_id}/collections": { + "get": { + "description": "Return a list of organization's collections with issues counts and projects count.", + "operationId": "getCollections", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "description": "Return collections sorted by the specified attributes", + "in": "query", + "name": "sort", + "schema": { + "enum": [ + "name", + "projectsCount", + "issues" + ], + "type": "string" + } + }, + { + "description": "Return collections sorted in the specified direction", + "in": "query", + "name": "direction", + "schema": { + "default": "DESC", + "enum": [ + "ASC", + "DESC" + ], + "type": "string" + } + }, + { + "allowEmptyValue": true, + "description": "Return collections which names include the provided string", + "in": "query", + "name": "name", + "schema": { + "maxLength": 255, + "type": "string" + } + }, + { + "allowEmptyValue": true, + "description": "Return collections where is_generated matches the provided boolean", + "in": "query", + "name": "is_generated", + "schema": { + "type": "boolean" + } + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "items": { + "$ref": "#/components/schemas/CollectionResponse" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "type": "object" + } + } + }, + "description": "Returns a list of collections", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get collections", + "tags": [ + "Collection" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-01~beta", + "2023-09-12" + ], + "x-snyk-api-resource": "collections", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-12", + "x-stability-level": "stable" + }, + "post": { + "description": "Create a collection", + "operationId": "createCollection", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/CreateCollectionRequest" + } + } + } + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "additionalProperties": false, + "description": "collection resource object", + "properties": { + "attributes": { + "$ref": "#/components/schemas/CollectionAttributes" + }, + "id": { + "format": "uuid", + "type": "string" + }, + "relationships": { + "$ref": "#/components/schemas/CollectionRelationships" + }, + "type": { + "$ref": "#/components/schemas/Types" + } + }, + "required": [ + "id", + "attributes", + "relationships" + ], + "type": "object" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/SelfLink" + } + }, + "type": "object" + } + } + }, + "description": "Returned collection", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -173310,7 +48903,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -173370,33 +48963,36 @@ } } } + }, + "500": { + "$ref": "#/components/responses/500" } }, - "summary": "Get targets by org ID", + "summary": "Create a collection", "tags": [ - "Targets" + "Collection" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2021-08-20~beta", - "2024-02-21" + "2023-06-01~beta", + "2023-09-12" ], - "x-snyk-api-resource": "targets", + "x-snyk-api-resource": "collections", "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-02-21", + "x-snyk-api-version": "2023-09-12", "x-stability-level": "stable" } }, - "/orgs/{org_id}/targets/{target_id}": { + "/orgs/{org_id}/collections/{collection_id}": { "delete": { - "description": "Delete the specified target.", - "operationId": "deleteOrgsTarget", + "description": "Delete a collection", + "operationId": "deleteCollection", "parameters": [ { "$ref": "#/components/parameters/Version" }, { - "description": "The id of the org to delete", + "description": "Org ID", "in": "path", "name": "org_id", "required": true, @@ -173406,23 +49002,19 @@ } }, { - "description": "The id of the target to delete", - "in": "path", - "name": "target_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/parameters/CollectionId" } ], "responses": { "204": { - "description": "The target is deleted with all projects, if it is found in the specified org.", + "description": "Collection was deleted successfully", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, "snyk-request-id": { "$ref": "#/components/headers/RequestIdResponseHeader" }, @@ -173441,6 +49033,18 @@ } }, "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -173613,7 +49217,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -173674,7 +49278,125 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Delete a collection", + "tags": [ + "Collection" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-01~beta", + "2023-09-12" + ], + "x-snyk-api-resource": "collections", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-12", + "x-stability-level": "stable" + }, + "get": { + "description": "Get a collection", + "operationId": "getCollection", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/CollectionId" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "additionalProperties": false, + "description": "collection resource object", + "properties": { + "attributes": { + "$ref": "#/components/schemas/CollectionAttributes" + }, + "id": { + "format": "uuid", + "type": "string" + }, + "relationships": { + "$ref": "#/components/schemas/CollectionRelationships" + }, + "type": { + "$ref": "#/components/schemas/Types" + } + }, + "required": [ + "id", + "attributes", + "relationships" + ], + "type": "object" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/SelfLink" + } + }, + "type": "object" + } + } + }, + "description": "Returned collection", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -173847,7 +49569,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -173866,49 +49588,176 @@ } }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", + "schema": { + "enum": [ + "wip", + "experimental", + "beta", + "ga", + "deprecated", + "sunset" + ], + "example": "ga", + "type": "string" + } + }, + "snyk-version-requested": { + "description": "A header containing the version of the endpoint requested by the caller.", + "example": "2021-06-04", + "schema": { + "description": "Requested API version", + "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", + "type": "string" + } + }, + "snyk-version-served": { + "description": "A header containing the version of the endpoint that was served by the API.", + "example": "2021-06-04", + "schema": { + "description": "Resolved API version", + "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", + "type": "string" + } + }, + "sunset": { + "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", + "example": "2021-08-02", + "schema": { + "format": "date", + "type": "string" + } + } + } + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get a collection", + "tags": [ + "Collection" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-01~beta", + "2023-09-12" + ], + "x-snyk-api-resource": "collections", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-12", + "x-stability-level": "stable" + }, + "patch": { + "description": "Edit a collection", + "operationId": "updateCollection", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/CollectionId" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/UpdateCollectionRequest" + } + } + } + }, + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "additionalProperties": false, + "description": "collection resource object", + "properties": { + "attributes": { + "$ref": "#/components/schemas/CollectionAttributes" + }, + "id": { + "format": "uuid", + "type": "string" + }, + "relationships": { + "$ref": "#/components/schemas/CollectionRelationships" + }, + "type": { + "$ref": "#/components/schemas/Types" + } + }, + "required": [ + "id", + "attributes", + "relationships" + ], + "type": "object" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/SelfLink" + } + }, + "type": "object" + } + } + }, + "description": "Returned collection", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -174081,7 +49930,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -174143,6 +49992,95 @@ } }, "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Edit a collection", + "tags": [ + "Collection" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-01~beta", + "2023-09-12" + ], + "x-snyk-api-resource": "collections", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-12", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/collections/{collection_id}/relationships/projects": { + "delete": { + "description": "Remove projects from a collection by specifying an array of project ids", + "operationId": "deleteProjectsCollection", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/CollectionId" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/DeleteProjectsFromCollectionRequest" + } + } + } + }, + "responses": { + "204": { + "description": "successfully removing projects from a collection", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -174315,7 +50253,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -174375,32 +50313,34 @@ } } } + }, + "500": { + "$ref": "#/components/responses/500" } }, - "summary": "Delete target by target ID", + "summary": "Remove projects from a collection", "tags": [ - "Targets" + "Collection" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2021-09-29~beta", - "2023-06-23~beta", - "2024-02-21" + "2023-06-01~beta", + "2023-09-12" ], - "x-snyk-api-resource": "targets", + "x-snyk-api-resource": "collections", "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-02-21", + "x-snyk-api-version": "2023-09-12", "x-stability-level": "stable" }, "get": { - "description": "Get a specified target for an organization.", - "operationId": "getOrgsTarget", + "description": "Return a list of organization's projects that are from the specified collection.", + "operationId": "getProjectsOfCollection", "parameters": [ { "$ref": "#/components/parameters/Version" }, { - "description": "The id of the org to return the target from", + "description": "Org ID", "in": "path", "name": "org_id", "required": true, @@ -174410,14 +50350,112 @@ } }, { - "description": "The id of the target to return", - "in": "path", - "name": "target_id", - "required": true, + "$ref": "#/components/parameters/CollectionId" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "description": "Return projects sorted by the specified attributes", + "in": "query", + "name": "sort", "schema": { - "format": "uuid", + "enum": [ + "imported", + "last_tested_at", + "issues" + ], + "type": "string" + } + }, + { + "description": "Return projects sorted in the specified direction", + "in": "query", + "name": "direction", + "schema": { + "default": "DESC", + "enum": [ + "ASC", + "DESC" + ], "type": "string" } + }, + { + "description": "Return projects that belong to the provided targets", + "in": "query", + "name": "target_id", + "schema": { + "items": { + "format": "uuid", + "type": "string" + }, + "maxItems": 25, + "type": "array" + } + }, + { + "description": "Return projects that are with or without issues", + "in": "query", + "name": "show", + "schema": { + "items": { + "enum": [ + "vuln-groups", + "clean-groups" + ], + "type": "string" + }, + "type": "array" + } + }, + { + "description": "Return projects that match the provided integration types", + "in": "query", + "name": "integration", + "schema": { + "items": { + "enum": [ + "acr", + "api", + "artifactory-cr", + "aws-lambda", + "azure-functions", + "azure-repos", + "bitbucket-cloud", + "bitbucket-connect-app", + "bitbucket-server", + "cli", + "cloud-foundry", + "digitalocean-cr", + "docker-hub", + "ecr", + "gcr", + "github-cr", + "github-enterprise", + "github", + "gitlab-cr", + "gitlab", + "google-artifact-cr", + "harbor-cr", + "heroku", + "ibm-cloud", + "kubernetes", + "nexus-cr", + "pivotal", + "quay-cr", + "terraform-cloud" + ], + "type": "string" + }, + "type": "array" + } } ], "responses": { @@ -174425,31 +50463,102 @@ "content": { "application/vnd.api+json": { "schema": { - "additionalProperties": false, - "properties": { - "data": { - "$ref": "#/components/schemas/PublicTarget" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data" - ], - "type": "object" + "$ref": "#/components/schemas/GetProjectsOfCollectionResponse" } } }, - "description": "A single target is returned if it is found in the specified org", + "description": "Returns a list of projects from the specified collection", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get projects from the specified collection", + "tags": [ + "Collection" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-01~beta", + "2023-09-12" + ], + "x-snyk-api-resource": "collections", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-12", + "x-stability-level": "stable" + }, + "post": { + "description": "Add projects to a collection by specifying an array of project ids", + "operationId": "updateCollectionWithProjects", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/CollectionId" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/UpdateCollectionWithProjectsRequest" + } + } + } + }, + "responses": { + "204": { + "description": "successfully adding projects to a collection", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, "snyk-request-id": { "$ref": "#/components/headers/RequestIdResponseHeader" }, @@ -174468,6 +50577,18 @@ } }, "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -174640,7 +50761,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -174701,7 +50822,121 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Add projects to a collection", + "tags": [ + "Collection" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-01~beta", + "2023-09-12" + ], + "x-snyk-api-resource": "collections", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-12", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/container_images": { + "get": { + "description": "List instances of container image", + "operationId": "listContainerImage", + "parameters": [ + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "example": "f59045b3-f093-40c3-871d-a334ae30c568", + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/ImageIds" + }, + { + "$ref": "#/components/parameters/Platform" + }, + { + "$ref": "#/components/parameters/Names" + }, + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "items": { + "$ref": "#/components/schemas/Image" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "type": "object" + } + } + }, + "description": "Returns a list of container image instances", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -174874,7 +51109,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -174935,7 +51170,104 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "List instances of container image", + "tags": [ + "ContainerImage" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-03-08~beta", + "2023-08-18~beta", + "2023-11-02" + ], + "x-snyk-api-resource": "container_images", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-11-02", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/container_images/{image_id}": { + "get": { + "description": "Get instance of container image", + "operationId": "getContainerImage", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "example": "f59045b3-f093-40c3-871d-a334ae30c568", + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/ImageId20231102" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "$ref": "#/components/schemas/Image" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/SelfLink" + } + }, + "type": "object" + } + } + }, + "description": "Returns an instance of container image", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -175108,7 +51440,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -175170,6 +51502,114 @@ } }, "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get instance of container image", + "tags": [ + "ContainerImage" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-03-08~beta", + "2023-11-02" + ], + "x-snyk-api-resource": "container_images", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-11-02", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/container_images/{image_id}/relationships/image_target_refs": { + "get": { + "description": "List instances of image target references for a container image", + "operationId": "listImageTargetRefs", + "parameters": [ + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "example": "f59045b3-f093-40c3-871d-a334ae30c568", + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/ImageId20231102" + }, + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "items": { + "$ref": "#/components/schemas/ImageTargetRef" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "type": "object" + } + } + }, + "description": "Returns a list of image target references for a container image", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -175342,7 +51782,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -175402,128 +51842,185 @@ } } } + }, + "500": { + "$ref": "#/components/responses/500" } }, - "summary": "Get target by target ID", + "summary": "List instances of image target references for a container image", "tags": [ - "Targets" + "ContainerImage" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2021-08-20~beta", - "2024-02-21" + "2023-08-18~beta", + "2023-11-02" + ], + "x-snyk-api-resource": "container_images", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-11-02", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/invites": { + "get": { + "description": "List pending user invitations to an organization.", + "operationId": "listOrgInvitation", + "parameters": [ + { + "description": "The id of the org the user is being invited to", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "items": { + "$ref": "#/components/schemas/OrgInvitation" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" + } + }, + "required": [ + "jsonapi", + "data", + "links" + ], + "type": "object" + } + } + }, + "description": "List of pending invitations to an organization.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "List pending user invitations to an organization.", + "tags": [ + "Invites" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-11-14" ], - "x-snyk-api-resource": "targets", + "x-snyk-api-resource": "org_invitations", "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-02-21", + "x-snyk-api-version": "2022-11-14", "x-stability-level": "stable" - } - }, - "/orgs/{org_id}/users/{id}": { - "get": { - "description": "Get a summary of user.\n\nNote that Service Accounts are not returned by this endpoint. Please use the Service Accounts endpoints.\n", - "operationId": "getUser", + }, + "post": { + "description": "Invite a user to an organization with a role.", + "operationId": "createOrgInvitation", "parameters": [ { - "description": "The id of the org", - "in": "path", - "name": "org_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/parameters/Version" }, { - "description": "The id of the user", + "description": "The id of the org the user is being invited to", "in": "path", - "name": "id", + "name": "org_id", "required": true, "schema": { "format": "uuid", "type": "string" } - }, - { - "$ref": "#/components/parameters/Version" } ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/OrgInvitationPostData" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + } + }, "responses": { - "200": { + "201": { "content": { "application/vnd.api+json": { "schema": { + "additionalProperties": false, "properties": { "data": { - "additionalProperties": false, - "properties": { - "attributes": { - "additionalProperties": false, - "properties": { - "active": { - "description": "Whether the user status is enabled or not", - "example": true, - "type": "boolean" - }, - "email": { - "description": "The email of the user.", - "example": "user@someorg.com", - "type": "string" - }, - "membership": { - "properties": { - "created_at": { - "description": "The date the membership was established.", - "example": "2022-09-14T09:19:29.206Z", - "format": "date-time", - "type": "string" - }, - "strategy": { - "description": "Whether the membership is a direct, or indirect membership.", - "enum": [ - "direct", - "indirect" - ], - "example": "direct", - "type": "string" - } - }, - "type": "object" - }, - "name": { - "description": "The name of the user.", - "example": "user", - "type": "string" - }, - "username": { - "description": "The username of the user.", - "example": "username", - "type": "string" - } - }, - "type": "object" - }, - "id": { - "description": "The Snyk ID corresponding to this user", - "example": "55a348e2-c3ad-4bbc-b40e-9b232d1f4121", - "format": "uuid", - "type": "string" - }, - "type": { - "description": "Content type.", - "example": "user", - "type": "string" - } - }, - "required": [ - "type", - "id", - "attributes" - ], - "type": "object" + "$ref": "#/components/schemas/OrgInvitation20240621" }, "jsonapi": { "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ @@ -175534,11 +52031,16 @@ } } }, - "description": "User details", + "description": "A new organization invitation has been created", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" }, + "location": { + "schema": { + "type": "string" + } + }, "snyk-request-id": { "$ref": "#/components/headers/RequestIdResponseHeader" }, @@ -175557,6 +52059,197 @@ } }, "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Invite a user to an organization", + "tags": [ + "Invites" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-06-01", + "2023-04-28", + "2024-06-21" + ], + "x-snyk-api-resource": "org_invitations", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-06-21", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/invites/{invite_id}": { + "delete": { + "description": "Cancel a pending user invitations to an organization.", + "operationId": "deleteOrgInvitation", + "parameters": [ + { + "description": "The id of the org the user is being invited to", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "The id of the pending invite to cancel", + "in": "path", + "name": "invite_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "204": { + "$ref": "#/components/responses/204" + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Cancel a pending user invitations to an organization.", + "tags": [ + "Invites" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-11-14" + ], + "x-snyk-api-resource": "org_invitations", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2022-11-14", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/issues": { + "get": { + "description": "Get a list of an organization's issues.", + "operationId": "listOrgIssues", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "example": "4a18d42f-0706-4ad0-b127-24078731fbed", + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/ScanItemId" + }, + { + "$ref": "#/components/parameters/ScanItemType" + }, + { + "description": "An issue type to filter issues.", + "in": "query", + "name": "type", + "schema": { + "description": "The type of an issue.", + "enum": [ + "package_vulnerability", + "license", + "cloud", + "code", + "custom", + "config" + ], + "example": "cloud", + "type": "string" + }, + "style": "form" + }, + { + "$ref": "#/components/parameters/UpdatedBefore" + }, + { + "$ref": "#/components/parameters/UpdatedAfter" + }, + { + "$ref": "#/components/parameters/CreatedBefore" + }, + { + "$ref": "#/components/parameters/CreatedAfter" + }, + { + "$ref": "#/components/parameters/EffectiveSeverityLevel" + }, + { + "description": "An issue's status", + "explode": false, + "in": "query", + "name": "status", + "schema": { + "items": { + "enum": [ + "open", + "resolved" + ], + "type": "string" + }, + "type": "array" + }, + "style": "form" + }, + { + "$ref": "#/components/parameters/Ignored" + } + ], + "responses": { + "200": { + "$ref": "#/components/responses/ListIssues200" + }, + "401": { + "$ref": "#/components/responses/401__0" + }, + "403": { "content": { "application/vnd.api+json": { "schema": { @@ -175603,58 +52296,6 @@ "format": "uuid", "type": "string" }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, "meta": { "additionalProperties": true, "example": { @@ -175729,10 +52370,10 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Unauthorized: the request requires an authentication token or a token with more permissions.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", + "description": "The deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", "example": "2021-07-01T00:00:00Z", "schema": { "format": "date-time", @@ -175740,7 +52381,7 @@ } }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", + "description": "A unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", "schema": { "format": "uuid", @@ -175748,7 +52389,7 @@ } }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", + "description": "The version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", "schema": { "enum": [ "wip", @@ -175763,7 +52404,7 @@ } }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", + "description": "The version of the endpoint requested by the caller.", "example": "2021-06-04", "schema": { "description": "Requested API version", @@ -175772,7 +52413,7 @@ } }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", + "description": "The version of the endpoint that was served by the API.", "example": "2021-06-04", "schema": { "description": "Resolved API version", @@ -175790,104 +52431,108 @@ } } }, - "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" + "404": { + "$ref": "#/components/responses/404__0" + }, + "500": { + "$ref": "#/components/responses/500__0" + } + }, + "summary": "Get issues by org ID", + "tags": [ + "Issues" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-03-10~experimental", + "2023-09-29~beta", + "2024-01-23" + ], + "x-snyk-api-resource": "issues", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-01-23", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/issues/{issue_id}": { + "get": { + "description": "Get an issue", + "operationId": "getOrgIssueByIssueID", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "example": "4a18d42f-0706-4ad0-b127-24078731fbed", + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/PathIssueId20240123" + } + ], + "responses": { + "200": { + "$ref": "#/components/responses/GetIssue20020240123" + }, + "400": { + "$ref": "#/components/responses/400__0" + }, + "401": { + "$ref": "#/components/responses/401__0" + }, + "403": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "example": { + "errors": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "jsonapi": { + "version": "1.0" + } + }, + "properties": { + "errors": { + "example": [ + { + "detail": "Permission denied for this resource", + "status": "403" + } + ], + "items": { + "additionalProperties": false, + "example": { + "detail": "Not Found", + "status": "404" + }, + "properties": { + "code": { + "description": "An application-specific error code, expressed as a string value.", + "example": "entity-not-found", + "type": "string" + }, + "detail": { + "description": "A human-readable explanation specific to this occurrence of the problem.", + "example": "The request was missing these required fields: ...", + "type": "string" + }, + "id": { + "description": "A unique identifier for this particular occurrence of the problem.", + "example": "f16c31b5-6129-4571-add8-d589da9be524", + "format": "uuid", + "type": "string" }, "meta": { "additionalProperties": true, @@ -175963,536 +52608,825 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Unauthorized: the request requires an authentication token or a token with more permissions.", + "headers": { + "deprecation": { + "description": "The deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", + "example": "2021-07-01T00:00:00Z", + "schema": { + "format": "date-time", + "type": "string" + } + }, + "snyk-request-id": { + "description": "A unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", + "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", + "schema": { + "format": "uuid", + "type": "string" + } + }, + "snyk-version-lifecycle-stage": { + "description": "The version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", + "schema": { + "enum": [ + "wip", + "experimental", + "beta", + "ga", + "deprecated", + "sunset" + ], + "example": "ga", + "type": "string" + } + }, + "snyk-version-requested": { + "description": "The version of the endpoint requested by the caller.", + "example": "2021-06-04", + "schema": { + "description": "Requested API version", + "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", + "type": "string" + } + }, + "snyk-version-served": { + "description": "The version of the endpoint that was served by the API.", + "example": "2021-06-04", + "schema": { + "description": "Resolved API version", + "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", + "type": "string" + } + }, + "sunset": { + "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", + "example": "2021-08-02", + "schema": { + "format": "date", + "type": "string" + } + } + } + }, + "404": { + "$ref": "#/components/responses/404__0" + }, + "409": { + "$ref": "#/components/responses/409" + }, + "500": { + "$ref": "#/components/responses/500__0" + } + }, + "summary": "Get an issue", + "tags": [ + "Issues" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-01-23" + ], + "x-snyk-api-resource": "issues", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-01-23", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/learn/assignments": { + "delete": { + "description": "Allows an admin to delete multiple assignments within their organization.", + "operationId": "deleteOrgAssignments", + "parameters": [ + { + "$ref": "#/components/parameters/OrgId" + }, + { + "$ref": "#/components/parameters/ApiVersion" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/DeleteAssignmentsRequest" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Assignments were successfully deleted.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Bulk deletion of assignments in an organization", + "tags": [ + "Learn assignment" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-10-13~beta" + ], + "x-snyk-api-resource": "assignments", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2024-10-13~beta", + "x-stability-level": "beta" + }, + "get": { + "description": "Allows an admin to obtain a comprehensive list of all assignments within their organization.", + "operationId": "listOrgAssignments", + "parameters": [ + { + "$ref": "#/components/parameters/OrgId" + }, + { + "$ref": "#/components/parameters/ApiVersion" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "items": { + "$ref": "#/components/schemas/LessonAssignmentDecoratedResource" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "required": [ + "jsonapi", + "links", + "data" + ], + "type": "object" + } + } + }, + "description": "A list of assignments was successfully retrieved.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Retrieve a list of assignments for an organization", + "tags": [ + "Learn assignment" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-10-13~beta" + ], + "x-snyk-api-resource": "assignments", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2024-10-13~beta", + "x-stability-level": "beta" + }, + "patch": { + "description": "Allows an admin to update the due date for existing assignments within their organization.", + "operationId": "updateOrgAssignments", + "parameters": [ + { + "$ref": "#/components/parameters/OrgId" + }, + { + "$ref": "#/components/parameters/ApiVersion" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { + "$ref": "#/components/schemas/UpdateAssignmentsPayload" + }, + "id": { + "format": "uuid", + "type": "string" + }, + "type": { + "$ref": "#/components/schemas/Types" + } + }, + "required": [ + "id", + "type", + "attributes" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Assignments due date was successfully updated.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Update due date for assignments in an organization.", + "tags": [ + "Learn assignment" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-10-15~beta" + ], + "x-snyk-api-resource": "assignments", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2024-10-15~beta", + "x-stability-level": "beta" + }, + "post": { + "description": "Allows an admin to create assignments in bulk for all or a subset of users within their organization.", + "operationId": "createOrgAssignments", + "parameters": [ + { + "$ref": "#/components/parameters/OrgId" + }, + { + "$ref": "#/components/parameters/ApiVersion" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/CreateAssignmentsPayload" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Assignments were successfully created.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Bulk creation of assignments for users in an organization.", + "tags": [ + "Learn assignment" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-10-14~experimental", + "2024-10-15~beta" + ], + "x-snyk-api-resource": "assignments", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2024-10-15~beta", + "x-stability-level": "beta" + } + }, + "/orgs/{org_id}/learn/progress/catalog": { + "get": { + "description": "Shows which users have completed, started or not started a lesson within Snyk Learn, even if they don't have a Snyk Learn account.", + "operationId": "getCatalogProgress", + "parameters": [ + { + "$ref": "#/components/parameters/OrgId" + }, + { + "$ref": "#/components/parameters/ApiVersion" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/Type" + }, + { + "$ref": "#/components/parameters/Title" + }, + { + "$ref": "#/components/parameters/Cwes" + }, + { + "$ref": "#/components/parameters/Cves" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/CatalogProgressResponse" + } + } + }, + "description": "Organization reporting users overview", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get learning progress for an organisation", + "tags": [ + "Catalog Progress" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-10-15~beta" + ], + "x-snyk-api-resource": "progress", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2024-10-15~beta", + "x-stability-level": "beta" + } + }, + "/orgs/{org_id}/learn/progress/users": { + "get": { + "description": "List of users within the organization mapped to Snyk Catalog, reporting on users learn progress status for each catalog resource.", + "operationId": "getUsersProgress", + "parameters": [ + { + "$ref": "#/components/parameters/OrgId" + }, + { + "$ref": "#/components/parameters/ApiVersion" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/Type" + }, + { + "$ref": "#/components/parameters/Title" + }, + { + "$ref": "#/components/parameters/Status" + }, + { + "$ref": "#/components/parameters/Emails" + }, + { + "$ref": "#/components/parameters/CompletionInterval" + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" + "$ref": "#/components/schemas/UsersProgressResponse" } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Organization reporting users overview", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "403": { + "$ref": "#/components/responses/403" + }, "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get learning progress for organization members", + "tags": [ + "Users Learn Progress" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-10-15~beta" + ], + "x-snyk-api-resource": "progress", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2024-10-15~beta", + "x-stability-level": "beta" + } + }, + "/orgs/{org_id}/memberships": { + "get": { + "description": "Returns all memberships of the org", + "operationId": "listOrgMemberships", + "parameters": [ + { + "description": "The ID of the org", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/SortBy" + }, + { + "$ref": "#/components/parameters/SortOrder" + }, + { + "$ref": "#/components/parameters/EmailFilter" + }, + { + "$ref": "#/components/parameters/UserIdFilter" + }, + { + "$ref": "#/components/parameters/UsernameFilter" + }, + { + "$ref": "#/components/parameters/RoleFilter" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "$ref": "#/components/schemas/OrgMembershipResponseData" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "List of org memberships is returned", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get all memberships of the org", + "tags": [ + "Orgs" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-05-09~experimental", + "2024-08-25" + ], + "x-snyk-api-resource": "orgs", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-08-25", + "x-stability-level": "stable" + }, + "post": { + "description": "Create a org membership for a user with role", + "operationId": "createOrgMembership", + "parameters": [ + { + "description": "The ID of the org", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/CreateOrgMembershipRequestBody" + } + } + } + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { "schema": { - "format": "date", - "type": "string" + "properties": { + "data": { + "$ref": "#/components/schemas/OrgMembership" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" + } + }, + "type": "object" } } + }, + "description": "Membership for the user is created on the org", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } } }, - "500": { + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -176665,7 +53599,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -176725,57 +53659,44 @@ } } } + }, + "500": { + "$ref": "#/components/responses/500" } }, - "summary": "Get user by ID", + "summary": "Create a org membership for a user with role", "tags": [ - "Users" + "Orgs" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2021-09-13~beta" + "2024-05-09~experimental", + "2024-08-25" ], - "x-snyk-api-resource": "users", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2021-09-13~beta", - "x-stability-level": "beta" + "x-snyk-api-resource": "orgs", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-08-25", + "x-stability-level": "stable" } }, - "/self": { - "get": { - "description": "Retrieves information about the the user making the request.", - "operationId": "getSelf", + "/orgs/{org_id}/memberships/{membership_id}": { + "delete": { + "description": "Remove a user's membership of the group.\n", + "operationId": "deleteOrgMembership", "parameters": [ + { + "$ref": "#/components/parameters/OrgId__0" + }, + { + "$ref": "#/components/parameters/OrgMembershipId" + }, { "$ref": "#/components/parameters/Version" } ], "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "$ref": "#/components/schemas/Principal20240422" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "required": [ - "jsonapi", - "data", - "links" - ], - "type": "object" - } - } - }, - "description": "Current user is returned", + "204": { + "description": "Org membership for the user was successfully deleted.", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" @@ -176798,240 +53719,100 @@ } }, "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Remove user's org membership", + "tags": [ + "Orgs" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-06-06~experimental", + "2024-08-25" + ], + "x-snyk-api-resource": "org_memberships", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-08-25", + "x-stability-level": "stable" + }, + "patch": { + "description": "Update a org membership for a user with role", + "operationId": "updateOrgMembership", + "parameters": [ + { + "$ref": "#/components/parameters/OrgId__0" + }, + { + "$ref": "#/components/parameters/OrgMembershipId" + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "$ref": "#/components/schemas/UpdateOrgMembershipRequestBody" + } + }, + "type": "object" } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + } + } + }, + "responses": { + "204": { + "description": "The Membership is updated", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -177204,7 +53985,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -177265,7 +54046,101 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Update a org membership for a user with role", + "tags": [ + "Orgs" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-06-06~experimental", + "2024-08-25" + ], + "x-snyk-api-resource": "org_memberships", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-08-25", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/packages/issues": { + "post": { + "description": "This endpoint is not available to all customers. If you are interested please contact support. Query issues for a batch of packages identified by Package URL (purl). Only direct vulnerabilities are returned, transitive vulnerabilities (from dependencies) are not returned because they can vary depending on context.", + "operationId": "listIssuesForManyPurls", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Unique identifier for an organization", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/BulkPackageUrlsRequestBody" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/IssuesWithPurlsResponse" + } + } + }, + "description": "Returns an array of issues with the purl identifier of the package that caused them", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/Location" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -177438,7 +54313,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -177499,7 +54374,110 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "List issues for a given set of packages (Currently not available to all customers)", + "tags": [ + "Issues" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-01-04~experimental", + "2023-03-29~beta", + "2023-04-17", + "2023-08-21", + "2024-06-26" + ], + "x-snyk-api-resource": "issues", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-06-26", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/packages/{purl}/issues": { + "get": { + "description": "Query issues for a specific package version identified by Package URL (purl). Snyk returns only direct vulnerabilities. Transitive vulnerabilities (from dependencies) are not returned because they can vary depending on context.", + "operationId": "fetchIssuesPerPurl", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/PackageUrl" + }, + { + "description": "Unique identifier for an organization", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "Specify the number of results to skip before returning results. Must be greater than or equal to 0. Default is 0.", + "in": "query", + "name": "offset", + "schema": { + "type": "number" + } + }, + { + "description": "Specify the number of results to return. Must be greater than 0 and less than 1000. Default is 1000.", + "in": "query", + "name": "limit", + "schema": { + "type": "number" + } + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/IssuesResponse" + } + } + }, + "description": "Returns an array of issues", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -177672,7 +54650,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -177682,327 +54660,642 @@ "type": "string" } }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "snyk-request-id": { + "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", + "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", + "schema": { + "format": "uuid", + "type": "string" + } + }, + "snyk-version-lifecycle-stage": { + "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", + "schema": { + "enum": [ + "wip", + "experimental", + "beta", + "ga", + "deprecated", + "sunset" + ], + "example": "ga", + "type": "string" + } + }, + "snyk-version-requested": { + "description": "A header containing the version of the endpoint requested by the caller.", + "example": "2021-06-04", + "schema": { + "description": "Requested API version", + "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", + "type": "string" + } + }, + "snyk-version-served": { + "description": "A header containing the version of the endpoint that was served by the API.", + "example": "2021-06-04", + "schema": { + "description": "Resolved API version", + "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", + "type": "string" + } + }, + "sunset": { + "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", + "example": "2021-08-02", + "schema": { + "format": "date", + "type": "string" + } + } + } + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "List issues for a package", + "tags": [ + "Issues" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-06-29~beta", + "2022-09-15", + "2024-06-26" + ], + "x-snyk-api-resource": "issues", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-06-26", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/projects": { + "get": { + "description": "List all Projects for an Org.", + "operationId": "listOrgProjects", + "parameters": [ + { + "description": "The ID of the org that the projects belong to.", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "Return projects that belong to the provided targets", + "in": "query", + "name": "target_id", + "schema": { + "items": { + "format": "uuid", + "type": "string" + }, + "type": "array" + } + }, + { + "description": "Return projects that match the provided target reference", + "in": "query", + "name": "target_reference", + "schema": { + "type": "string" + } + }, + { + "description": "Return projects that match the provided target file", + "in": "query", + "name": "target_file", + "schema": { + "type": "string" + } + }, + { + "description": "Return projects that match the provided target runtime", + "in": "query", + "name": "target_runtime", + "schema": { + "type": "string" + } + }, + { + "description": "The collection count.", + "in": "query", + "name": "meta_count", + "schema": { + "enum": [ + "only" + ], + "type": "string" + } + }, + { + "description": "Return projects that match the provided IDs.", + "explode": false, + "in": "query", + "name": "ids", + "schema": { + "items": { + "format": "uuid", + "type": "string" + }, + "type": "array" + }, + "style": "form" + }, + { + "description": "Return projects that match the provided names.", + "explode": false, + "in": "query", + "name": "names", + "schema": { + "items": { + "type": "string" + }, + "type": "array" + }, + "style": "form" + }, + { + "description": "Return projects with names starting with the specified prefix.", + "explode": false, + "in": "query", + "name": "names_start_with", + "schema": { + "items": { + "type": "string" + }, + "type": "array" + }, + "style": "form" + }, + { + "description": "Return projects that match the provided origins.", + "explode": false, + "in": "query", + "name": "origins", + "schema": { + "items": { + "type": "string" + }, + "type": "array" + }, + "style": "form" + }, + { + "description": "Return projects that match the provided types.", + "explode": false, + "in": "query", + "name": "types", + "schema": { + "items": { + "type": "string" + }, + "type": "array" + }, + "style": "form" + }, + { + "description": "Expand relationships.", + "explode": false, + "in": "query", + "name": "expand", + "schema": { + "items": { + "enum": [ + "target" + ], + "type": "string" + }, + "type": "array" + }, + "style": "form" + }, + { + "description": "Include a summary count for the issues found in the most recent scan of this project", + "in": "query", + "name": "meta.latest_issue_counts", + "schema": { + "type": "boolean" + } + }, + { + "description": "Include the total number of dependencies found in the most recent scan of this project", + "in": "query", + "name": "meta.latest_dependency_total", + "schema": { + "type": "boolean" + } + }, + { + "description": "Filter projects uploaded and monitored before this date (encoded value)", + "example": "2021-05-29T09:50:54.014Z", + "in": "query", + "name": "cli_monitored_before", + "schema": { + "format": "date-time", + "type": "string" + } + }, + { + "description": "Filter projects uploaded and monitored after this date (encoded value)", + "example": "2021-05-29T09:50:54.014Z", + "in": "query", + "name": "cli_monitored_after", + "schema": { + "format": "date-time", + "type": "string" + } + }, + { + "description": "Return projects that match the provided importing user public ids.", + "explode": false, + "in": "query", + "name": "importing_user_public_id", + "schema": { + "items": { + "type": "string" + }, + "type": "array" + }, + "style": "form" + }, + { + "description": "Return projects that match all the provided tags", + "example": [ + "key1:value1", + "key2:value2" + ], + "explode": false, + "in": "query", + "name": "tags", + "schema": { + "items": { + "pattern": "^[a-zA-Z0-9_-]+:[:/?#@\u0026+=%a-zA-Z0-9_.~-]+$", + "type": "string" }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "type": "array" + }, + "style": "form" + }, + { + "description": "Return projects that match all the provided business_criticality value", + "explode": false, + "in": "query", + "name": "business_criticality", + "schema": { + "items": { + "enum": [ + "critical", + "high", + "medium", + "low" + ], + "type": "string" }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "type": "array" + }, + "style": "form" + }, + { + "description": "Return projects that match all the provided environment values", + "explode": false, + "in": "query", + "name": "environment", + "schema": { + "items": { + "enum": [ + "frontend", + "backend", + "internal", + "external", + "mobile", + "saas", + "onprem", + "hosted", + "distributed" + ], + "type": "string" }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "type": "array" + }, + "style": "form" + }, + { + "description": "Return projects that match all the provided lifecycle values", + "explode": false, + "in": "query", + "name": "lifecycle", + "schema": { + "items": { + "enum": [ + "production", + "development", + "sandbox" + ], + "type": "string" }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } + "type": "array" + }, + "style": "form" }, - "500": { + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], + "data": { "items": { "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" + "attributes": { + "$ref": "#/components/schemas/ProjectAttributes" }, "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", + "description": "Resource ID.", "format": "uuid", "type": "string" }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", + "cli_monitored_at": { + "description": "The date that the project was last uploaded and monitored using cli.", + "example": "2021-05-29T09:50:54.014Z", + "format": "date-time", + "nullable": true, "type": "string" }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" + "latest_dependency_total": { + "$ref": "#/components/schemas/LatestDependencyTotal" + }, + "latest_issue_counts": { + "$ref": "#/components/schemas/LatestIssueCounts" } }, "type": "object" }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" + "relationships": { + "$ref": "#/components/schemas/ProjectRelationships" }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", + "type": { + "description": "The Resource type.", + "example": "project", "type": "string" } }, "required": [ - "status", - "detail" + "id", + "type", + "attributes" ], "type": "object" }, - "minItems": 1, "type": "array" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" + }, + "meta": { "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" + "count": { + "minimum": 0, + "type": "number" } }, - "required": [ - "version" - ], "type": "object" } }, "required": [ "jsonapi", - "errors" + "links" ], "type": "object" } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "A list of projects is returned for the targeted org", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" } }, - "summary": "My User Details", + "summary": "List all Projects for an Org with the given Org ID.", "tags": [ - "Users" + "Projects" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2022-03-01~experimental", - "2022-09-14~experimental", - "2024-04-22" + "2021-06-04~beta", + "2022-08-12~experimental", + "2022-12-21~experimental", + "2023-02-15", + "2023-08-28", + "2023-09-11", + "2023-11-06", + "2024-05-31" ], - "x-snyk-api-resource": "self", + "x-snyk-api-resource": "projects", "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-04-22", + "x-snyk-api-version": "2024-05-31", "x-stability-level": "stable" } }, - "/self/access_requests": { + "/orgs/{org_id}/projects/{project_id}": { + "delete": { + "description": "Delete one project in the organization by project ID.", + "operationId": "deleteOrgProject", + "parameters": [ + { + "description": "The ID of the org to which the project belongs to.", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "The ID of the project.", + "in": "path", + "name": "project_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "204": { + "description": "The project has been deleted", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Delete project by project ID.", + "tags": [ + "Projects" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-11-06", + "2024-05-31" + ], + "x-snyk-api-resource": "projects", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-31", + "x-stability-level": "stable" + }, "get": { - "description": "Get a list of user's access requests", - "operationId": "getAccessRequests", + "description": "Get one project of the organization by project ID.", + "operationId": "getOrgProject", "parameters": [ { - "$ref": "#/components/parameters/Version" + "description": "The ID of the org to which the project belongs to.", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "The ID of the project.", + "in": "path", + "name": "project_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } }, { - "$ref": "#/components/parameters/StartingAfter" + "description": "Expand relationships.", + "explode": false, + "in": "query", + "name": "expand", + "schema": { + "items": { + "enum": [ + "target" + ], + "type": "string" + }, + "type": "array" + }, + "style": "form" }, { - "$ref": "#/components/parameters/EndingBefore" + "description": "Include a summary count for the issues found in the most recent scan of this project", + "in": "query", + "name": "meta.latest_issue_counts", + "schema": { + "type": "boolean" + } }, { - "$ref": "#/components/parameters/Limit" + "description": "Include the total number of dependencies found in the most recent scan of this project", + "in": "query", + "name": "meta.latest_dependency_total", + "schema": { + "type": "boolean" + } }, { - "$ref": "#/components/parameters/OrgIdFilter" + "$ref": "#/components/parameters/Version" } ], "responses": { @@ -178013,10 +55306,50 @@ "additionalProperties": false, "properties": { "data": { - "items": { - "$ref": "#/components/schemas/AccessRequest" + "additionalProperties": false, + "properties": { + "attributes": { + "$ref": "#/components/schemas/ProjectAttributes" + }, + "id": { + "description": "The Resource ID.", + "format": "uuid", + "type": "string" + }, + "meta": { + "additionalProperties": false, + "properties": { + "cli_monitored_at": { + "description": "The date that the project was last uploaded and monitored using cli.", + "example": "2021-05-29T09:50:54.014Z", + "format": "date-time", + "nullable": true, + "type": "string" + }, + "latest_dependency_total": { + "$ref": "#/components/schemas/LatestDependencyTotal" + }, + "latest_issue_counts": { + "$ref": "#/components/schemas/LatestIssueCounts" + } + }, + "type": "object" + }, + "relationships": { + "$ref": "#/components/schemas/ProjectRelationships" + }, + "type": { + "description": "The Resource type.", + "example": "project", + "type": "string" + } }, - "type": "array" + "required": [ + "id", + "type", + "attributes" + ], + "type": "object" }, "jsonapi": { "$ref": "#/components/schemas/JsonApi" @@ -178034,7 +55367,7 @@ } } }, - "description": "A list of access requests are returned", + "description": "A project is returned for the targeted org", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" @@ -178057,474 +55390,306 @@ } }, "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } + "$ref": "#/components/responses/400" }, "401": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get project by project ID.", + "tags": [ + "Projects" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-02-01~experimental", + "2022-08-12~experimental", + "2022-12-21~experimental", + "2023-02-15", + "2023-08-28", + "2023-09-11", + "2023-11-06", + "2024-05-31" + ], + "x-snyk-api-resource": "projects", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-31", + "x-stability-level": "stable" + }, + "patch": { + "description": "Updates one project of the organization by project ID.", + "operationId": "updateOrgProject", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "The ID of the Org the project belongs to.", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "The ID of the project to patch.", + "in": "path", + "name": "project_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "Expand relationships.", + "explode": false, + "in": "query", + "name": "expand", + "schema": { + "items": { + "enum": [ + "target" + ], + "type": "string" + }, + "type": "array" + }, + "style": "form" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/PatchProjectRequest" + } + } + }, + "description": "The project attributes to be updated." + }, + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { "additionalProperties": false, - "example": { - "version": "1.0" - }, "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "attributes": { + "$ref": "#/components/schemas/ProjectAttributes" + }, + "id": { + "description": "The Resource ID.", + "example": "331ede0a-de94-456f-b788-166caeca58bf", + "format": "uuid", + "type": "string" + }, + "links": { + "$ref": "#/components/schemas/Links" + }, + "meta": { + "additionalProperties": false, + "properties": { + "cli_monitored_at": { + "description": "The date that the project was last uploaded and monitored using cli.", + "example": "2021-05-29T09:50:54.014Z", + "format": "date-time", + "nullable": true, + "type": "string" + } + }, + "type": "object" + }, + "relationships": { + "$ref": "#/components/schemas/ProjectRelationships" + }, + "type": { + "description": "The Resource type.", + "example": "project", "type": "string" } }, "required": [ - "version" + "type", + "id", + "attributes" ], "type": "object" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "A project is updated for the targeted org", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Updates project by project ID.", + "tags": [ + "Projects" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-12-21~experimental", + "2023-02-15", + "2023-08-28", + "2023-09-11", + "2023-11-06", + "2024-05-31" + ], + "x-snyk-api-resource": "projects", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-05-31", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/projects/{project_id}/sbom": { + "get": { + "description": "This endpoint lets you retrieve the SBOM document of a software project.\nIt supports the following formats:\n* CycloneDX version 1.6 in JSON (set `format` to `cyclonedx1.6+json`).\n* CycloneDX version 1.6 in XML (set `format` to `cyclonedx1.6+xml`).\n* CycloneDX version 1.5 in JSON (set `format` to `cyclonedx1.5+json`).\n* CycloneDX version 1.5 in XML (set `format` to `cyclonedx1.5+xml`).\n* CycloneDX version 1.4 in JSON (set `format` to `cyclonedx1.4+json`).\n* CycloneDX version 1.4 in XML (set `format` to `cyclonedx1.4+xml`).\n* SPDX version 2.3 in JSON (set `format` to `spdx2.3+json`).\n\nBy default it will respond with an empty JSON:API response.", + "operationId": "getSbom", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Unique identifier for an organization", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/ProjectId" + }, + { + "$ref": "#/components/parameters/Format" + }, + { + "$ref": "#/components/parameters/Exclude" + } + ], + "responses": { + "200": { + "content": { + "application/json": { "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" + "$ref": "#/components/schemas/SbomDocument" } }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", + "application/vnd.api+json": { "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" + "$ref": "#/components/schemas/SbomResponse" } }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", + "application/vnd.cyclonedx+json": { "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" + "$ref": "#/components/schemas/SbomDocument" } }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", + "application/vnd.cyclonedx+xml": { "schema": { - "format": "date", - "type": "string" + "$ref": "#/components/schemas/SbomDocument" } } + }, + "description": "Returns the SBOM document of a project", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -178697,7 +55862,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -178758,241 +55923,151 @@ } } }, - "404": { + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get a project’s SBOM document", + "tags": [ + "SBOM" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-03-31~experimental", + "2022-12-06~beta", + "2023-03-20", + "2024-03-12~experimental", + "2024-08-15~beta", + "2024-08-22" + ], + "x-snyk-api-resource": "sboms", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-08-22", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/sbom_tests": { + "post": { + "description": "Create an SBOM test run by supplying an SBOM document. The components contained in the given document will get analyzed for known vulnerabilities. In order for component identification to be successful, they must have a PackageURL (purl) of a supported purl type assigned. Analysis will be skipped for any component that does not fulfill this requirement.\nSupported SBOM formats: CycloneDX 1.4 JSON, CycloneDX 1.5 JSON, CycloneDX 1.6 JSON, SPDX 2.3 JSON\nSupported purl types: apk, deb, cargo, cocoapods, composer, gem, generic, golang, hex, maven, npm, nuget, pypi, rpm, swift\n", + "operationId": "createSbomTestRun", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { + "$ref": "#/components/schemas/SbomTestCreateAttributes" + }, + "type": { + "$ref": "#/components/schemas/Types" + } + }, + "required": [ + "type" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + } + }, + "responses": { + "201": { "content": { "application/vnd.api+json": { "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { + "data": { "additionalProperties": false, - "example": { - "version": "1.0" - }, + "description": "SBOM test resource object", "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "id": { + "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", + "format": "uuid", "type": "string" + }, + "type": { + "$ref": "#/components/schemas/Types" } }, "required": [ - "version" + "id", + "type" ], "type": "object" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, - "required": [ - "jsonapi", - "errors" - ], "type": "object" } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Created SBOM test successfully", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, - "500": { + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -179165,7 +56240,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -179225,39 +56300,48 @@ } } } + }, + "500": { + "$ref": "#/components/responses/500" } }, - "summary": "Get access requests", + "summary": "Create an SBOM test run", "tags": [ - "AccessRequests" + "SBOM" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2023-12-01~experimental", - "2023-12-21~beta" + "2023-06-02~experimental", + "2023-08-31~beta", + "2024-04-22~beta", + "2024-07-10~beta" ], - "x-snyk-api-resource": "self", + "x-snyk-api-resource": "sbom_tests", "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2023-12-21~beta", + "x-snyk-api-version": "2024-07-10~beta", "x-stability-level": "beta" } }, - "/self/apps": { + "/orgs/{org_id}/sbom_tests/{job_id}": { "get": { - "description": "Get a list of apps that can act on your behalf.", - "operationId": "getUserInstalledApps", + "description": "Get an SBOM test run status", + "operationId": "getSbomTestStatus", "parameters": [ { "$ref": "#/components/parameters/Version" }, { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } }, { - "$ref": "#/components/parameters/Limit" + "$ref": "#/components/parameters/JobId" } ], "responses": { @@ -179265,35 +56349,57 @@ "content": { "application/vnd.api+json": { "schema": { - "additionalProperties": false, "properties": { "data": { - "items": { - "$ref": "#/components/schemas/PublicApp" + "description": "SBOM test resource object", + "properties": { + "attributes": { + "properties": { + "status": { + "enum": [ + "processing", + "error", + "finished" + ], + "type": "string" + } + }, + "type": "object" + }, + "id": { + "format": "uuid", + "type": "string" + }, + "type": { + "$ref": "#/components/schemas/Types" + } }, - "type": "array" + "required": [ + "id", + "type", + "attributes" + ], + "type": "object" }, "jsonapi": { "$ref": "#/components/schemas/JsonApi" }, "links": { - "$ref": "#/components/schemas/PaginatedLinks" + "$ref": "#/components/schemas/Links" } }, - "required": [ - "data", - "jsonapi", - "links" - ], "type": "object" } } }, - "description": "A list of apps install that can act on your behalf", + "description": "SBOM test run status", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, "snyk-request-id": { "$ref": "#/components/headers/RequestIdResponseHeader" }, @@ -179312,6 +56418,18 @@ } }, "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -179484,7 +56602,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -179545,1223 +56663,1179 @@ } } }, - "401": { + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Gets an SBOM test run status", + "tags": [ + "SBOM" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-02~experimental", + "2023-08-31~beta", + "2024-04-22~beta", + "2024-07-10~beta" + ], + "x-snyk-api-resource": "sbom_tests", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2024-07-10~beta", + "x-stability-level": "beta" + } + }, + "/orgs/{org_id}/sbom_tests/{job_id}/results": { + "get": { + "description": "Get an SBOM test run result", + "operationId": "getSbomTestResult", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/JobId" + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], + "properties": { + "data": { + "additionalProperties": false, + "description": "SBOM test resource object", + "properties": { + "attributes": { + "$ref": "#/components/schemas/SbomTestResultsAttributes" + }, + "id": { + "example": "d5b640e5-d88c-4c17-9bf0-93597b7a1ce2", + "format": "uuid", + "type": "string" + }, + "relationships": { + "properties": { + "affected_packages": { + "properties": { + "data": { + "items": { + "$ref": "#/components/schemas/ResourceReference" + }, + "type": "array" + } + }, + "type": "object" + } + }, + "type": "object" + }, + "type": { + "$ref": "#/components/schemas/Types" + } + }, + "required": [ + "id", + "type" + ], + "type": "object" + }, + "included": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, "jsonapi": { - "version": "1.0" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, + "type": "object" + } + } + }, + "description": "SBOM test results", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + } + }, + "summary": "Gets an SBOM test run result", + "tags": [ + "SBOM" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-02~experimental", + "2023-08-31~beta", + "2024-04-22~beta", + "2024-07-10~beta" + ], + "x-snyk-api-resource": "sbom_tests", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2024-07-10~beta", + "x-stability-level": "beta" + } + }, + "/orgs/{org_id}/service_accounts": { + "get": { + "description": "Get all service accounts for an organization.", + "operationId": "getManyOrgServiceAccounts", + "parameters": [ + { + "description": "The ID of the Snyk Organization that owns the service accounts.", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], + "data": { "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" + "$ref": "#/components/schemas/ServiceAccount" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" + } + }, + "required": [ + "jsonapi", + "data", + "links" + ], + "type": "object" + } + } + }, + "description": "A list of service accounts is returned.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get a list of organization service accounts.", + "tags": [ + "ServiceAccounts" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-09-07" + ], + "x-snyk-api-resource": "service_accounts", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-07", + "x-stability-level": "stable" + }, + "post": { + "description": "Create a service account for an organization. The service account can be used to access the Snyk API.", + "operationId": "createOrgServiceAccount", + "parameters": [ + { + "description": "The ID of the Snyk Organization that is creating and will own the service account.", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { + "additionalProperties": false, + "properties": { + "access_token_ttl_seconds": { + "description": "The time, in seconds, that a generated access token will be valid for. Defaults to 1 hour if unset. Only used when auth_type is one of the oauth_* variants.", + "maximum": 86400, + "minimum": 3600, + "type": "number" }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" + "auth_type": { + "description": "Authentication strategy for the service account:\n * api_key - Regular Snyk API Key.\n * oauth_client_secret - OAuth2 client_credentials grant, which returns a client secret that can be used to retrieve an access token.\n * oauth_private_key_jwt - OAuth2 client_credentials grant, using private_key_jwt client_assertion as laid out in OIDC Connect Core 1.0, section 9.", + "enum": [ + "api_key", + "oauth_client_secret", + "oauth_private_key_jwt" + ], + "type": "string" }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" + "jwks_url": { + "description": "A JWKs URL hosting your public keys, used to verify signed JWT requests. Must be https. Required only when auth_type is oauth_private_key_jwt.", + "type": "string" }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", + "name": { + "description": "A human-friendly name for the service account.", "type": "string" }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", + "role_id": { + "description": "The ID of the role which the created service account should use. Obtained in the Snyk UI, via \"Group Page\" -\u003e \"Settings\" -\u003e \"Member Roles\" -\u003e \"Create new Role\". Can be shared among multiple accounts.", + "format": "uuid", "type": "string" } }, "required": [ - "status", - "detail" + "name", + "role_id", + "auth_type" ], "type": "object" }, - "minItems": 1, - "type": "array" + "type": { + "description": "The Resource type.", + "enum": [ + "service_account" + ], + "type": "string" + } + }, + "required": [ + "attributes" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + }, + "required": true + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/ServiceAccount" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "A new service account has been created", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Create a service account for an organization.", + "tags": [ + "ServiceAccounts" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-09-07" + ], + "x-snyk-api-resource": "service_accounts", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-07", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/service_accounts/{serviceaccount_id}": { + "delete": { + "description": "Delete a service account in an organization.", + "operationId": "deleteServiceAccount", + "parameters": [ + { + "description": "The ID of org to which the service account belongs.", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "The ID of the service account.", + "in": "path", + "name": "serviceaccount_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "204": { + "description": "The service account has been deleted.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Delete a service account in an organization.", + "tags": [ + "ServiceAccounts" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-09-07" + ], + "x-snyk-api-resource": "service_accounts", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-07", + "x-stability-level": "stable" + }, + "get": { + "description": "Get an organization-level service account by its ID.", + "operationId": "getOneOrgServiceAccount", + "parameters": [ + { + "description": "The ID of the Snyk Organization that owns the service account.", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "The ID of the service account.", + "in": "path", + "name": "serviceaccount_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" + "data": { + "$ref": "#/components/schemas/ServiceAccount" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Service account is returned.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, "404": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get an organization service account.", + "tags": [ + "ServiceAccounts" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-09-07" + ], + "x-snyk-api-resource": "service_accounts", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-07", + "x-stability-level": "stable" + }, + "patch": { + "description": "Update the name of an organization-level service account by its ID.", + "operationId": "updateOrgServiceAccount", + "parameters": [ + { + "description": "The ID of the Snyk Organization that owns the service account.", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "The ID of the service account.", + "in": "path", + "name": "serviceaccount_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", + "name": { + "description": "A human-friendly name for the service account. Must be unique within the organization.", "type": "string" } }, "required": [ - "status", - "detail" + "name" ], "type": "object" }, - "minItems": 1, - "type": "array" + "id": { + "description": "The ID of the service account. Must match the id in the url path.", + "format": "uuid", + "type": "string" + }, + "type": { + "description": "The Resource type.", + "enum": [ + "service_account" + ], + "type": "string" + } + }, + "required": [ + "type", + "id", + "attributes" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/ServiceAccount" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Service account is returned.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, - "409": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Update an organization service account.", + "tags": [ + "ServiceAccounts" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-09-07" + ], + "x-snyk-api-resource": "service_accounts", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-07", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/service_accounts/{serviceaccount_id}/secrets": { + "post": { + "description": "Manage the client secret of an organization service account by the service account ID.", + "operationId": "updateOrgServiceAccountSecret", + "parameters": [ + { + "description": "The ID of the Snyk Organization that owns the service account.", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "The ID of the service account.", + "in": "path", + "name": "serviceaccount_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { + "additionalProperties": false, + "properties": { + "mode": { + "description": "Operation to perform:\n * `replace` - Replace existing secrets with a new generated secret.\n * `create` - Add a new secret, preserving existing secrets. A maximum of to two secrets can exist at a time.\n * `delete` - Remove an existing secret by value. At least one secret must remain per service account.\n", + "enum": [ + "replace", + "create", + "delete" + ], "type": "string" }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", + "secret": { + "description": "Secret to delete when using `delete` mode", "type": "string" } }, "required": [ - "status", - "detail" + "mode" ], "type": "object" }, - "minItems": 1, - "type": "array" + "type": { + "description": "The Resource type.", + "enum": [ + "service_account" + ], + "type": "string" + } + }, + "required": [ + "attributes", + "type" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/ServiceAccount" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data" ], "type": "object" } } }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", + "description": "Service account client secret has been updated.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Manage an organization service account's client secret.", + "tags": [ + "ServiceAccounts" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-09-07" + ], + "x-snyk-api-resource": "service_accounts", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-07", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/settings/iac": { + "get": { + "description": "Get the Infrastructure as Code Settings for an org.", + "operationId": "getIacSettingsForOrg", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "The id of the org whose Infrastructure as Code settings are requested.", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], + "properties": { + "data": { + "$ref": "#/components/schemas/OrgIacSettingsResponse" + }, "jsonapi": { - "version": "1.0" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, + "required": [ + "jsonapi", + "data", + "links" + ], + "type": "object" + } + } + }, + "description": "The Infrastructure as Code Settings of the org.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get the Infrastructure as Code Settings for an org.", + "tags": [ + "IacSettings" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2021-12-09" + ], + "x-snyk-api-resource": "iac_settings", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2021-12-09", + "x-stability-level": "stable" + }, + "patch": { + "description": "Update the Infrastructure as Code Settings for an org.", + "operationId": "updateIacSettingsForOrg", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "The id of the org whose Infrastructure as Code settings are getting updated", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "$ref": "#/components/schemas/OrgIacSettingsRequest" + } + }, + "type": "object" + } + } + } + }, + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" + "data": { + "$ref": "#/components/schemas/OrgIacSettingsResponse" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "The Infrastructure as Code Settings of the org were updated.", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" } }, - "summary": "Get a list of apps that can act on your behalf.", + "summary": "Update the Infrastructure as Code Settings for an org", "tags": [ - "Apps" + "IacSettings" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2022-03-11" + "2021-12-09" ], - "x-snyk-api-resource": "user_app_installs", + "x-snyk-api-resource": "iac_settings", "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2022-03-11", + "x-snyk-api-version": "2021-12-09", "x-stability-level": "stable" } }, - "/self/apps/installs": { + "/orgs/{org_id}/settings/sast": { "get": { - "description": "Get a list of apps installed for an user.", - "operationId": "getAppInstallsForUser", + "description": "Retrieves the SAST settings for an org", + "operationId": "getSastSettings", "parameters": [ - { - "description": "Expand relationships.", - "explode": false, - "in": "query", - "name": "expand", - "schema": { - "items": { - "enum": [ - "app" - ], - "type": "string" - }, - "type": "array" - }, - "style": "form" - }, { "$ref": "#/components/parameters/Version" }, { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" + "description": "The id of the org for which we want to retrieve the SAST settings", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } } ], "responses": { @@ -180772,28 +57846,25 @@ "additionalProperties": false, "properties": { "data": { - "items": { - "$ref": "#/components/schemas/AppInstallData" - }, - "type": "array" + "$ref": "#/components/schemas/SastEnablement" }, "jsonapi": { "$ref": "#/components/schemas/JsonApi" }, "links": { - "$ref": "#/components/schemas/PaginatedLinks" + "$ref": "#/components/schemas/Links" } }, "required": [ - "data", "jsonapi", + "data", "links" ], "type": "object" } } }, - "description": "A list of apps installed for the specified organization.", + "description": "The SAST settings for the org are being retrieved", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" @@ -180816,240 +57887,237 @@ } }, "400": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Retrieves the SAST settings for an org", + "tags": [ + "SastSettings" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-06-22" + ], + "x-snyk-api-resource": "sast_settings", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-06-22", + "x-stability-level": "stable" + }, + "patch": { + "description": "Enable/Disable the Snyk Code settings for an org", + "operationId": "updateOrgSastSettings", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "The id of the org for which we want to update the Snyk Code setting", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "additionalProperties": false, + "properties": { + "attributes": { "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" + "sast_enabled": { + "description": "The value of the updated settings for sastEnabled setting", + "type": "boolean" } }, "required": [ - "status", - "detail" + "sast_enabled" ], "type": "object" }, - "minItems": 1, - "type": "array" + "id": { + "format": "uuid", + "type": "string" + }, + "type": { + "type": "string" + } + }, + "required": [ + "id", + "type", + "attributes" + ], + "type": "object" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + }, + "required": true + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/SastEnablement" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "The SAST settings for the org are being updated", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Enable/Disable the Snyk Code settings for an org", + "tags": [ + "SastSettings" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-08-24~experimental", + "2023-09-11" + ], + "x-snyk-api-resource": "sast_settings", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-09-11", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/slack_app/{bot_id}": { + "delete": { + "description": "Remove the given Slack App integration", + "operationId": "deleteSlackDefaultNotificationSettings", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/BotId" + } + ], + "responses": { + "204": { + "description": "Slack App integration successfully removed", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -181222,7 +58290,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -181283,7 +58351,101 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Remove the given Slack App integration", + "tags": [ + "SlackSettings" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-11-07~experimental", + "2022-12-14" + ], + "x-snyk-api-resource": "settings", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2022-12-14", + "x-stability-level": "stable" + }, + "get": { + "description": "Get Slack integration default notification settings for the provided tenant ID and bot ID.", + "operationId": "getSlackDefaultNotificationSettings", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/BotId" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/SlackDefaultSettingsData" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/SelfLink" + } + }, + "type": "object" + } + } + }, + "description": "Default settings created successfully", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -181456,7 +58618,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -181517,7 +58679,114 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get Slack integration default notification settings.", + "tags": [ + "SlackSettings" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-11-07~experimental", + "2022-12-14" + ], + "x-snyk-api-resource": "settings", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2022-12-14", + "x-stability-level": "stable" + }, + "post": { + "description": "Create new Slack notification default settings for a given tenant.", + "operationId": "createSlackDefaultNotificationSettings", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/BotId" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/SettingsRequest" + } + } + }, + "description": "Create new Slack notification default settings for a tenant." + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/SlackDefaultSettingsData" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/SelfLink" + } + }, + "type": "object" + } + } + }, + "description": "Default settings created successfully", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -181690,7 +58959,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -181751,6 +59020,99 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Create new Slack notification default settings.", + "tags": [ + "SlackSettings" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-11-07~experimental", + "2022-12-14" + ], + "x-snyk-api-resource": "settings", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2022-12-14", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/slack_app/{bot_id}/projects": { + "get": { + "description": "Slack notification settings overrides for projects. These settings overrides the default settings configured for the tenant.", + "operationId": "getSlackProjectNotificationSettingsCollection", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/BotId" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/GetProjectSettingsCollection" + } + } + }, + "description": "Return default settings for a tenant", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, "409": { "content": { "application/vnd.api+json": { @@ -181986,6 +59348,93 @@ } }, "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Slack notification settings overrides for projects", + "tags": [ + "SlackSettings" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-11-07~experimental", + "2022-12-14" + ], + "x-snyk-api-resource": "settings", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2022-12-14", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/slack_app/{bot_id}/projects/{project_id}": { + "delete": { + "description": "Remove Slack settings override for a project.", + "operationId": "deleteSlackProjectNotificationSettings", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "Project ID", + "in": "path", + "name": "project_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/BotId" + } + ], + "responses": { + "204": { + "description": "Slack settings override for the project removed successfully.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -182158,7 +59607,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -182218,48 +59667,92 @@ } } } + }, + "500": { + "$ref": "#/components/responses/500" } }, - "summary": "Get a list of apps installed for an user.", + "summary": "Remove Slack settings override for a project.", "tags": [ - "Apps" + "SlackSettings" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03", - "2024-05-23" + "2022-11-07~experimental", + "2022-12-14" ], - "x-snyk-api-resource": "app_installs", + "x-snyk-api-resource": "settings", "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-23", + "x-snyk-api-version": "2022-12-14", "x-stability-level": "stable" - } - }, - "/self/apps/installs/{install_id}": { - "delete": { - "description": "Revoke access for an app by install ID.", - "operationId": "deleteUserAppInstallById", + }, + "patch": { + "description": "Update Slack notification settings for a project.", + "operationId": "updateSlackProjectNotificationSettings", "parameters": [ { "$ref": "#/components/parameters/Version" }, { - "$ref": "#/components/parameters/InstallId" + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/BotId" + }, + { + "description": "Project ID", + "in": "path", + "name": "project_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } } ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/ProjectSettingsPatchRequest" + } + } + }, + "description": "Update existing project specific settings for a project." + }, "responses": { - "204": { - "description": "The app install has been revoked.", + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/ProjectSettingsData" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/SelfLink" + } + }, + "type": "object" + } + } + }, + "description": "Slack notification settings for a project updated successfully.", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" }, - "location": { - "schema": { - "type": "string" - } - }, "snyk-request-id": { "$ref": "#/components/headers/RequestIdResponseHeader" }, @@ -182278,6 +59771,18 @@ } }, "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -182450,7 +59955,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -182484,34 +59989,151 @@ } }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "description": "A header containing the version of the endpoint requested by the caller.", + "example": "2021-06-04", + "schema": { + "description": "Requested API version", + "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", + "type": "string" + } + }, + "snyk-version-served": { + "description": "A header containing the version of the endpoint that was served by the API.", + "example": "2021-06-04", + "schema": { + "description": "Resolved API version", + "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", + "type": "string" + } + }, + "sunset": { + "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", + "example": "2021-08-02", + "schema": { + "format": "date", + "type": "string" + } + } + } + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Update Slack notification settings for a project.", + "tags": [ + "SlackSettings" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-11-07~experimental", + "2022-12-14" + ], + "x-snyk-api-resource": "settings", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2022-12-14", + "x-stability-level": "stable" + }, + "post": { + "description": "Create Slack settings override for a project.", + "operationId": "createSlackProjectNotificationSettings", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "Project ID", + "in": "path", + "name": "project_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/BotId" + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/SettingsRequest" + } + } + }, + "description": "Create new Slack notification default settings for a tenant." + }, + "responses": { + "201": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/ProjectSettingsData" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/SelfLink" + } + }, + "type": "object" + } + } + }, + "description": "Project settings created successfully", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -182684,7 +60306,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -182745,7 +60367,127 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Create a new Slack settings override for a given project.", + "tags": [ + "SlackSettings" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-11-07~experimental", + "2022-12-14" + ], + "x-snyk-api-resource": "settings", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2022-12-14", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/slack_app/{tenant_id}/channels": { + "get": { + "description": "Requires the Snyk Slack App to be set up for this org, will retrieve a list of channels the Snyk Slack App can access. Note that it is currently only possible to page forwards through this collection, no prev links will be generated and the ending_before parameter will not function.", + "operationId": "listChannels", + "parameters": [ + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/ChannelLimit" + }, + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "Tenant ID", + "in": "path", + "name": "tenant_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "items": { + "$ref": "#/components/schemas/SlackChannel" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "required": [ + "data", + "jsonapi", + "links" + ], + "type": "object" + } + } + }, + "description": "List of Slack channels", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -182918,7 +60660,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -182979,7 +60721,117 @@ } } }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get a list of Slack channels", + "tags": [ + "Slack" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-11-07" + ], + "x-snyk-api-resource": "channels", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2022-11-07", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/slack_app/{tenant_id}/channels/{channel_id}": { + "get": { + "description": "Requires the Snyk Slack App to be set up for this org. It will return the Slack channel name for the provided Slack channel ID.", + "operationId": "getChannelNameById", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Org ID", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/ChannelId" + }, + { + "description": "Tenant ID", + "in": "path", + "name": "tenant_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "$ref": "#/components/schemas/SlackChannel" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/SelfLink" + } + }, + "required": [ + "data", + "jsonapi", + "links" + ], + "type": "object" + } + } + }, + "description": "List of Slack channels", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -183122,606 +60974,940 @@ ], "type": "object" }, - "minItems": 1, + "minItems": 1, + "type": "array" + }, + "jsonapi": { + "additionalProperties": false, + "example": { + "version": "1.0" + }, + "properties": { + "version": { + "description": "Version of the JSON API specification this server supports.", + "example": "1.0", + "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "type": "string" + } + }, + "required": [ + "version" + ], + "type": "object" + } + }, + "required": [ + "jsonapi", + "errors" + ], + "type": "object" + } + } + }, + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", + "headers": { + "deprecation": { + "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", + "example": "2021-07-01T00:00:00Z", + "schema": { + "format": "date-time", + "type": "string" + } + }, + "snyk-request-id": { + "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", + "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", + "schema": { + "format": "uuid", + "type": "string" + } + }, + "snyk-version-lifecycle-stage": { + "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", + "schema": { + "enum": [ + "wip", + "experimental", + "beta", + "ga", + "deprecated", + "sunset" + ], + "example": "ga", + "type": "string" + } + }, + "snyk-version-requested": { + "description": "A header containing the version of the endpoint requested by the caller.", + "example": "2021-06-04", + "schema": { + "description": "Requested API version", + "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", + "type": "string" + } + }, + "snyk-version-served": { + "description": "A header containing the version of the endpoint that was served by the API.", + "example": "2021-06-04", + "schema": { + "description": "Resolved API version", + "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", + "type": "string" + } + }, + "sunset": { + "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", + "example": "2021-08-02", + "schema": { + "format": "date", + "type": "string" + } + } + } + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get Slack Channel name by Slack Channel ID.", + "tags": [ + "Slack" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-11-07" + ], + "x-snyk-api-resource": "channels", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2022-11-07", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/targets": { + "get": { + "description": "Get a list of an organization's targets.", + "operationId": "getOrgsTargets", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "description": "Calculate total amount of filtered results", + "in": "query", + "name": "count", + "schema": { + "type": "boolean" + } + }, + { + "description": "Number of results to return per page", + "example": 10, + "in": "query", + "name": "limit", + "schema": { + "default": 10, + "format": "int32", + "maximum": 100, + "minimum": 1, + "type": "integer" + } + }, + { + "description": "The id of the org to return a list of targets", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "Return targets that match the provided value of is_private", + "in": "query", + "name": "is_private", + "schema": { + "type": "boolean" + } + }, + { + "description": "Return only the targets that has projects", + "in": "query", + "name": "exclude_empty", + "schema": { + "default": true, + "type": "boolean" + } + }, + { + "description": "Return targets that match the provided remote_url.", + "in": "query", + "name": "url", + "schema": { + "type": "string" + } + }, + { + "description": "Return targets that match the provided source_types", + "explode": false, + "in": "query", + "name": "source_types", + "schema": { + "items": { + "enum": [ + "bitbucket-server", + "gitlab", + "github-enterprise", + "bitbucket-cloud", + "bitbucket-connect-app", + "azure-repos", + "github", + "github-cloud-app", + "github-server-app", + "cli", + "docker-hub", + "in-memory-fs", + "acr", + "ecr", + "gcr", + "artifactory-cr", + "harbor-cr", + "quay-cr", + "github-cr", + "nexus-cr", + "nexus-private-repo", + "digitalocean-cr", + "gitlab-cr", + "google-artifact-cr", + "heroku", + "kubernetes", + "api", + "aws-lambda", + "azure-functions", + "cloud-foundry", + "pivotal", + "ibm-cloud", + "terraform-cloud" + ], + "type": "string" + }, + "type": "array" + }, + "style": "form" + }, + { + "description": "Return targets with display names starting with the provided string", + "in": "query", + "name": "display_name", + "schema": { + "type": "string" + } + }, + { + "description": "Return only targets which have been created at or after the specified date.\n", + "example": "2022-01-01T16:00:00Z", + "in": "query", + "name": "created_gte", + "schema": { + "format": "date-time", + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "items": { + "$ref": "#/components/schemas/PublicTarget" + }, "type": "array" }, "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" + }, + "meta": { "additionalProperties": false, "example": { - "version": "1.0" + "count": 3 }, "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" + "count": { + "type": "number" } }, - "required": [ - "version" - ], "type": "object" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "A list of targets is returned for the targeted org", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, - "409": { + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get targets by org ID", + "tags": [ + "Targets" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2021-08-20~beta", + "2024-02-21" + ], + "x-snyk-api-resource": "targets", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-02-21", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/targets/{target_id}": { + "delete": { + "description": "Delete the specified target.", + "operationId": "deleteOrgsTarget", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "The id of the org to delete", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "The id of the target to delete", + "in": "path", + "name": "target_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "The target is deleted with all projects, if it is found in the specified org.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Delete target by target ID", + "tags": [ + "Targets" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2021-09-29~beta", + "2023-06-23~beta", + "2024-02-21" + ], + "x-snyk-api-resource": "targets", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-02-21", + "x-stability-level": "stable" + }, + "get": { + "description": "Get a specified target for an organization.", + "operationId": "getOrgsTarget", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "The id of the org to return the target from", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "The id of the target to return", + "in": "path", + "name": "target_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], + "properties": { + "data": { + "$ref": "#/components/schemas/PublicTarget" + }, "jsonapi": { - "version": "1.0" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, + "required": [ + "jsonapi", + "data" + ], + "type": "object" + } + } + }, + "description": "A single target is returned if it is found in the specified org", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get target by target ID", + "tags": [ + "Targets" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2021-08-20~beta", + "2024-02-21" + ], + "x-snyk-api-resource": "targets", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-02-21", + "x-stability-level": "stable" + } + }, + "/orgs/{org_id}/users/{id}": { + "get": { + "description": "Get a summary of user.\n\nNote that Service Accounts are not returned by this endpoint. Please use the Service Accounts endpoints.\n", + "operationId": "getUser", + "parameters": [ + { + "description": "The id of the org", + "in": "path", + "name": "org_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "description": "The id of the user", + "in": "path", + "name": "id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" + "data": { + "additionalProperties": false, + "properties": { + "attributes": { + "additionalProperties": false, + "properties": { + "active": { + "description": "Whether the user status is enabled or not", + "example": true, + "type": "boolean" }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" + "email": { + "description": "The email of the user.", + "example": "user@someorg.com", + "type": "string" }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" + "membership": { + "properties": { + "created_at": { + "description": "The date the membership was established.", + "example": "2022-09-14T09:19:29.206Z", + "format": "date-time", + "type": "string" + }, + "strategy": { + "description": "Whether the membership is a direct, or indirect membership.", + "enum": [ + "direct", + "indirect" + ], + "example": "direct", + "type": "string" + } }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } + "type": "object" }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", + "name": { + "description": "The name of the user.", + "example": "user", + "type": "string" + }, + "username": { + "description": "The username of the user.", + "example": "username", + "type": "string" + } + }, + "type": "object" + }, + "id": { + "description": "The Snyk ID corresponding to this user", + "example": "55a348e2-c3ad-4bbc-b40e-9b232d1f4121", + "format": "uuid", + "type": "string" + }, + "type": { + "description": "Content type.", + "example": "user", "type": "string" } }, "required": [ - "version" + "type", + "id", + "attributes" ], "type": "object" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" } }, "required": [ "jsonapi", - "errors" + "data" ], "type": "object" } } }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", + "description": "User details", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get user by ID", + "tags": [ + "Users" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2021-09-13~beta" + ], + "x-snyk-api-resource": "users", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2021-09-13~beta", + "x-stability-level": "beta" + } + }, + "/self": { + "get": { + "description": "Retrieves information about the the user making the request.", + "operationId": "getSelf", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" + "properties": { + "data": { + "$ref": "#/components/schemas/Principal20240422" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" + } + }, + "required": [ + "jsonapi", + "data", + "links" ], - "example": "ga", - "type": "string" + "type": "object" } + } + }, + "description": "Current user is returned", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "My User Details", + "tags": [ + "Users" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2022-03-01~experimental", + "2022-09-14~experimental", + "2024-04-22" + ], + "x-snyk-api-resource": "self", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2024-04-22", + "x-stability-level": "stable" + } + }, + "/self/access_requests": { + "get": { + "description": "Get a list of user's access requests", + "operationId": "getAccessRequests", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/OrgIdFilter" + } + ], + "responses": { + "200": { "content": { "application/vnd.api+json": { "schema": { "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], + "data": { "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" + "$ref": "#/components/schemas/AccessRequest" }, - "minItems": 1, "type": "array" }, "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" } }, "required": [ "jsonapi", - "errors" + "data", + "links" ], "type": "object" } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "A list of access requests are returned", "headers": { "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } + "$ref": "#/components/headers/DeprecationHeader" }, "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/headers/RequestIdResponseHeader" }, "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } + "$ref": "#/components/headers/VersionStageResponseHeader" }, "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } + "$ref": "#/components/headers/VersionRequestedResponseHeader" }, "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } + "$ref": "#/components/headers/VersionServedResponseHeader" }, "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } + "$ref": "#/components/headers/SunsetHeader" } } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" } }, - "summary": "Revoke access for an app by install ID.", + "summary": "Get access requests", "tags": [ - "Apps" + "AccessRequests" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2023-06-19~experimental", - "2023-11-03", - "2024-05-23" + "2023-12-01~experimental", + "2023-12-21~beta" ], - "x-snyk-api-resource": "app_installs", - "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2024-05-23", - "x-stability-level": "stable" + "x-snyk-api-resource": "self", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2023-12-21~beta", + "x-stability-level": "beta" } }, - "/self/apps/{app_id}": { - "delete": { - "description": "Revoke access for an app by app id", - "operationId": "revokeUserInstalledApp", + "/self/apps": { + "get": { + "description": "Get a list of apps that can act on your behalf.", + "operationId": "getUserInstalledApps", "parameters": [ { "$ref": "#/components/parameters/Version" }, { - "$ref": "#/components/parameters/AppId" + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" } ], "responses": { - "204": { - "description": "The app has been revoked", + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "items": { + "$ref": "#/components/schemas/PublicApp" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "required": [ + "data", + "jsonapi", + "links" + ], + "type": "object" + } + } + }, + "description": "A list of apps install that can act on your behalf", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" }, - "location": { - "schema": { - "type": "string" - } - }, "snyk-request-id": { "$ref": "#/components/headers/RequestIdResponseHeader" }, @@ -184208,238 +62394,7 @@ } }, "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } + "$ref": "#/components/responses/403" }, "404": { "content": { @@ -185144,7 +63099,7 @@ } } }, - "summary": "Revoke an app", + "summary": "Get a list of apps that can act on your behalf.", "tags": [ "Apps" ], @@ -185158,11 +63113,27 @@ "x-stability-level": "stable" } }, - "/self/apps/{app_id}/sessions": { + "/self/apps/installs": { "get": { - "description": "Get a list of active OAuth sessions for the app.", - "operationId": "getUserAppSessions", + "description": "Get a list of apps installed for an user.", + "operationId": "getAppInstallsForUser", "parameters": [ + { + "description": "Expand relationships.", + "explode": false, + "in": "query", + "name": "expand", + "schema": { + "items": { + "enum": [ + "app" + ], + "type": "string" + }, + "type": "array" + }, + "style": "form" + }, { "$ref": "#/components/parameters/Version" }, @@ -185174,9 +63145,6 @@ }, { "$ref": "#/components/parameters/Limit" - }, - { - "$ref": "#/components/parameters/AppId" } ], "responses": { @@ -185188,7 +63156,7 @@ "properties": { "data": { "items": { - "$ref": "#/components/schemas/SessionData" + "$ref": "#/components/schemas/AppInstallData" }, "type": "array" }, @@ -185201,13 +63169,14 @@ }, "required": [ "data", - "jsonapi" + "jsonapi", + "links" ], "type": "object" } } }, - "description": "A list of active OAuth sessions for the app.", + "description": "A list of apps installed for the specified organization.", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" @@ -185698,238 +63667,7 @@ } }, "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } + "$ref": "#/components/responses/403" }, "404": { "content": { @@ -186634,46 +64372,37 @@ } } }, - "summary": "Get a list of active OAuth sessions for the app.", + "summary": "Get a list of apps installed for an user.", "tags": [ "Apps" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2023-03-30~experimental", - "2023-11-03" + "2023-06-19~experimental", + "2023-11-03", + "2024-05-23" ], - "x-snyk-api-resource": "sessions", + "x-snyk-api-resource": "app_installs", "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-11-03", + "x-snyk-api-version": "2024-05-23", "x-stability-level": "stable" } }, - "/self/apps/{app_id}/sessions/{session_id}": { + "/self/apps/installs/{install_id}": { "delete": { - "description": "Revoke an active user app session.", - "operationId": "revokeUserAppSession", + "description": "Revoke access for an app by install ID.", + "operationId": "deleteUserAppInstallById", "parameters": [ { "$ref": "#/components/parameters/Version" }, { - "$ref": "#/components/parameters/AppId" - }, - { - "description": "Session ID", - "in": "path", - "name": "session_id", - "required": true, - "schema": { - "format": "uuid", - "type": "string" - } + "$ref": "#/components/parameters/InstallId" } ], "responses": { "204": { - "description": "The user app sessions has been revoked.", + "description": "The app install has been revoked.", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" @@ -187169,238 +64898,7 @@ } }, "403": { - "content": { - "application/vnd.api+json": { - "schema": { - "additionalProperties": false, - "example": { - "errors": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "jsonapi": { - "version": "1.0" - } - }, - "properties": { - "errors": { - "example": [ - { - "detail": "Permission denied for this resource", - "status": "403" - } - ], - "items": { - "additionalProperties": false, - "example": { - "detail": "Not Found", - "status": "404" - }, - "properties": { - "code": { - "description": "An application-specific error code, expressed as a string value.", - "example": "entity-not-found", - "type": "string" - }, - "detail": { - "description": "A human-readable explanation specific to this occurrence of the problem.", - "example": "The request was missing these required fields: ...", - "type": "string" - }, - "id": { - "description": "A unique identifier for this particular occurrence of the problem.", - "example": "f16c31b5-6129-4571-add8-d589da9be524", - "format": "uuid", - "type": "string" - }, - "links": { - "additionalProperties": false, - "description": "A link that leads to further details about this particular occurrance of the problem.", - "example": { - "about": "https://example.com/about_this_error" - }, - "properties": { - "about": { - "example": "https://example.com/api/resource", - "oneOf": [ - { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - { - "additionalProperties": false, - "example": { - "href": "https://example.com/api/resource" - }, - "properties": { - "href": { - "description": "A string containing the link’s URL.", - "example": "https://example.com/api/resource", - "type": "string" - }, - "meta": { - "additionalProperties": true, - "description": "Free-form object that may contain non-standard information.", - "example": { - "key1": "value1", - "key2": { - "sub_key": "sub_value" - }, - "key3": [ - "array_value1", - "array_value2" - ] - }, - "type": "object" - } - }, - "required": [ - "href" - ], - "type": "object" - } - ] - } - }, - "type": "object" - }, - "meta": { - "additionalProperties": true, - "example": { - "key": "value" - }, - "type": "object" - }, - "source": { - "additionalProperties": false, - "example": { - "pointer": "/data/attributes" - }, - "properties": { - "parameter": { - "description": "A string indicating which URI query parameter caused the error.", - "example": "param1", - "type": "string" - }, - "pointer": { - "description": "A JSON Pointer [RFC6901] to the associated entity in the request document.", - "example": "/data/attributes", - "type": "string" - } - }, - "type": "object" - }, - "status": { - "description": "The HTTP status code applicable to this problem, expressed as a string value.", - "example": "400", - "pattern": "^[45]\\d\\d$", - "type": "string" - }, - "title": { - "description": "A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.", - "example": "Bad request", - "type": "string" - } - }, - "required": [ - "status", - "detail" - ], - "type": "object" - }, - "minItems": 1, - "type": "array" - }, - "jsonapi": { - "additionalProperties": false, - "example": { - "version": "1.0" - }, - "properties": { - "version": { - "description": "Version of the JSON API specification this server supports.", - "example": "1.0", - "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$", - "type": "string" - } - }, - "required": [ - "version" - ], - "type": "object" - } - }, - "required": [ - "jsonapi", - "errors" - ], - "type": "object" - } - } - }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", - "headers": { - "deprecation": { - "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", - "example": "2021-07-01T00:00:00Z", - "schema": { - "format": "date-time", - "type": "string" - } - }, - "snyk-request-id": { - "description": "A header containing a unique id used for tracking this request. If you are reporting an issue to Snyk it's very helpful to provide this ID.\n", - "example": "4b58e274-ec62-4fab-917b-1d2c48d6bdef", - "schema": { - "format": "uuid", - "type": "string" - } - }, - "snyk-version-lifecycle-stage": { - "description": "A header containing the version stage of the endpoint. This stage describes the guarantees snyk provides surrounding stability of the endpoint.\n", - "schema": { - "enum": [ - "wip", - "experimental", - "beta", - "ga", - "deprecated", - "sunset" - ], - "example": "ga", - "type": "string" - } - }, - "snyk-version-requested": { - "description": "A header containing the version of the endpoint requested by the caller.", - "example": "2021-06-04", - "schema": { - "description": "Requested API version", - "pattern": "^(wip|work-in-progress|experimental|beta|((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?))$", - "type": "string" - } - }, - "snyk-version-served": { - "description": "A header containing the version of the endpoint that was served by the API.", - "example": "2021-06-04", - "schema": { - "description": "Resolved API version", - "pattern": "^((([0-9]{4})-([0-1][0-9]))-((3[01])|(0[1-9])|([12][0-9]))(~(wip|work-in-progress|experimental|beta))?)$", - "type": "string" - } - }, - "sunset": { - "description": "A header containing the date of when the underlying endpoint will be removed. This header is only present if the endpoint has been deprecated. For information purposes only. Returned as a date in the format: YYYY-MM-DD", - "example": "2021-08-02", - "schema": { - "format": "date", - "type": "string" - } - } - } + "$ref": "#/components/responses/403" }, "404": { "content": { @@ -188105,103 +65603,46 @@ } } }, - "summary": "Revoke an active user app session.", + "summary": "Revoke access for an app by install ID.", "tags": [ "Apps" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2023-03-30~experimental", - "2023-11-03" + "2023-06-19~experimental", + "2023-11-03", + "2024-05-23" ], - "x-snyk-api-resource": "sessions", + "x-snyk-api-resource": "app_installs", "x-snyk-api-stability": "ga", - "x-snyk-api-version": "2023-11-03", + "x-snyk-api-version": "2024-05-23", "x-stability-level": "stable" } }, - "/tenants/{tenant_id}/memberships": { - "get": { - "description": "Returns all memberships of the tenant", - "operationId": "getTenantMemberships", + "/self/apps/{app_id}": { + "delete": { + "description": "Revoke access for an app by app id", + "operationId": "revokeUserInstalledApp", "parameters": [ { "$ref": "#/components/parameters/Version" }, { - "$ref": "#/components/parameters/TenantId" - }, - { - "$ref": "#/components/parameters/StartingAfter" - }, - { - "$ref": "#/components/parameters/EndingBefore" - }, - { - "$ref": "#/components/parameters/Limit" - }, - { - "description": "Which column to sort by.", - "in": "query", - "name": "sort_by", - "schema": { - "enum": [ - "username", - "user_display_name", - "email", - "login_method", - "role_name" - ], - "type": "string" - } - }, - { - "$ref": "#/components/parameters/SortOrder" - }, - { - "$ref": "#/components/parameters/EmailFilter" - }, - { - "$ref": "#/components/parameters/UserIdSearchFilter" - }, - { - "$ref": "#/components/parameters/NameFilter" - }, - { - "$ref": "#/components/parameters/UsernameFilter" - }, - { - "$ref": "#/components/parameters/ConnectionTypeFilter" - }, - { - "$ref": "#/components/parameters/RoleFilter" + "$ref": "#/components/parameters/AppId" } ], "responses": { - "200": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "$ref": "#/components/schemas/ListTenantMembershipResponseData" - }, - "jsonapi": { - "$ref": "#/components/schemas/JsonApi" - }, - "links": { - "$ref": "#/components/schemas/Links" - } - }, - "type": "object" - } - } - }, - "description": "List of tenant memberships is returned", + "204": { + "description": "The app has been revoked", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" }, + "location": { + "schema": { + "type": "string" + } + }, "snyk-request-id": { "$ref": "#/components/headers/RequestIdResponseHeader" }, @@ -188688,6 +66129,9 @@ } }, "403": { + "$ref": "#/components/responses/403" + }, + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -188860,7 +66304,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -188921,7 +66365,7 @@ } } }, - "404": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -189094,7 +66538,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -189390,55 +66834,74 @@ } } }, - "summary": "Get all memberships of the tenant", + "summary": "Revoke an app", "tags": [ - "Tenants" + "Apps" ], "x-snyk-api-lifecycle": "released", "x-snyk-api-releases": [ - "2024-05-09~experimental", - "2024-09-03~beta" + "2022-03-11" ], - "x-snyk-api-resource": "memberships", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2024-09-03~beta", - "x-stability-level": "beta" + "x-snyk-api-resource": "user_app_installs", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2022-03-11", + "x-stability-level": "stable" } }, - "/tenants/{tenant_id}/memberships/{membership_id}": { - "delete": { - "description": "Delete an individual tenant membership for a single user.", - "operationId": "deleteTenantMembership", + "/self/apps/{app_id}/sessions": { + "get": { + "description": "Get a list of active OAuth sessions for the app.", + "operationId": "getUserAppSessions", "parameters": [ { "$ref": "#/components/parameters/Version" }, { - "description": "Unique identifier of the tenant membership.", - "in": "path", - "name": "membership_id", - "required": true, - "schema": { - "description": "Unique identifier for a tenant membership.", - "example": "00000000-0000-0000-0000-000000000000", - "format": "uuid", - "type": "string" - } + "$ref": "#/components/parameters/StartingAfter" }, { - "$ref": "#/components/parameters/TenantId" + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "$ref": "#/components/parameters/AppId" } ], "responses": { - "204": { - "description": "successfully deleting an individual membership for a single user", + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "additionalProperties": false, + "properties": { + "data": { + "items": { + "$ref": "#/components/schemas/SessionData" + }, + "type": "array" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/PaginatedLinks" + } + }, + "required": [ + "data", + "jsonapi" + ], + "type": "object" + } + } + }, + "description": "A list of active OAuth sessions for the app.", "headers": { "deprecation": { "$ref": "#/components/headers/DeprecationHeader" }, - "location": { - "$ref": "#/components/headers/LocationHeader" - }, "snyk-request-id": { "$ref": "#/components/headers/RequestIdResponseHeader" }, @@ -189925,6 +67388,9 @@ } }, "403": { + "$ref": "#/components/responses/403" + }, + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -190097,7 +67563,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -190158,7 +67624,7 @@ } } }, - "404": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -190331,7 +67797,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -190392,7 +67858,7 @@ } } }, - "409": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -190565,7 +68031,7 @@ } } }, - "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -190625,8 +68091,75 @@ } } } + } + }, + "summary": "Get a list of active OAuth sessions for the app.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-03-30~experimental", + "2023-11-03" + ], + "x-snyk-api-resource": "sessions", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-11-03", + "x-stability-level": "stable" + } + }, + "/self/apps/{app_id}/sessions/{session_id}": { + "delete": { + "description": "Revoke an active user app session.", + "operationId": "revokeUserAppSession", + "parameters": [ + { + "$ref": "#/components/parameters/Version" }, - "500": { + { + "$ref": "#/components/parameters/AppId" + }, + { + "description": "Session ID", + "in": "path", + "name": "session_id", + "required": true, + "schema": { + "format": "uuid", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "The user app sessions has been revoked.", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "schema": { + "type": "string" + } + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { "content": { "application/vnd.api+json": { "schema": { @@ -190799,7 +68332,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Bad Request: A parameter provided as a part of the request was invalid.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -190859,92 +68392,8 @@ } } } - } - }, - "summary": "Delete an individual tenant membership for a single user.", - "tags": [ - "Tenants" - ], - "x-snyk-api-lifecycle": "released", - "x-snyk-api-releases": [ - "2024-06-04~experimental", - "2024-09-03~beta" - ], - "x-snyk-api-resource": "memberships", - "x-snyk-api-stability": "beta", - "x-snyk-api-version": "2024-09-03~beta", - "x-stability-level": "beta" - }, - "patch": { - "description": "Update the tenant membership with the new role\n", - "operationId": "updateTenantMembership", - "parameters": [ - { - "$ref": "#/components/parameters/Version" - }, - { - "$ref": "#/components/parameters/TenantId" }, - { - "description": "Unique identifier of the tenant membership.", - "in": "path", - "name": "membership_id", - "required": true, - "schema": { - "description": "Unique identifier for a tenant membership.", - "example": "00000000-0000-0000-0000-000000000000", - "format": "uuid", - "type": "string" - } - } - ], - "requestBody": { - "content": { - "application/vnd.api+json": { - "schema": { - "properties": { - "data": { - "$ref": "#/components/schemas/UpdateTenantMembershipRequestData" - } - }, - "required": [ - "data" - ], - "type": "object" - } - } - } - }, - "responses": { - "204": { - "description": "successfully updated the tenant membership", - "headers": { - "deprecation": { - "$ref": "#/components/headers/DeprecationHeader" - }, - "location": { - "schema": { - "type": "string" - } - }, - "snyk-request-id": { - "$ref": "#/components/headers/RequestIdResponseHeader" - }, - "snyk-version-lifecycle-stage": { - "$ref": "#/components/headers/VersionStageResponseHeader" - }, - "snyk-version-requested": { - "$ref": "#/components/headers/VersionRequestedResponseHeader" - }, - "snyk-version-served": { - "$ref": "#/components/headers/VersionServedResponseHeader" - }, - "sunset": { - "$ref": "#/components/headers/SunsetHeader" - } - } - }, - "400": { + "401": { "content": { "application/vnd.api+json": { "schema": { @@ -191117,7 +68566,7 @@ } } }, - "description": "Bad Request: A parameter provided as a part of the request was invalid.", + "description": "Unauthorized: the request requires an authentication token.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -191178,7 +68627,10 @@ } } }, - "401": { + "403": { + "$ref": "#/components/responses/403" + }, + "404": { "content": { "application/vnd.api+json": { "schema": { @@ -191351,7 +68803,7 @@ } } }, - "description": "Unauthorized: the request requires an authentication token.", + "description": "Not Found: The resource being operated on could not be found.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -191412,7 +68864,7 @@ } } }, - "403": { + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -191585,7 +69037,7 @@ } } }, - "description": "Forbidden: the request requires an authentication token with more or different permissions.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -191646,7 +69098,7 @@ } } }, - "404": { + "500": { "content": { "application/vnd.api+json": { "schema": { @@ -191819,7 +69271,7 @@ } } }, - "description": "Not Found: The resource being operated on could not be found.", + "description": "Internal Server Error: An error was encountered while attempting to process the request.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -191879,6 +69331,215 @@ } } } + } + }, + "summary": "Revoke an active user app session.", + "tags": [ + "Apps" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2023-03-30~experimental", + "2023-11-03" + ], + "x-snyk-api-resource": "sessions", + "x-snyk-api-stability": "ga", + "x-snyk-api-version": "2023-11-03", + "x-stability-level": "stable" + } + }, + "/tenants/{tenant_id}/memberships": { + "get": { + "description": "Returns all memberships of the tenant", + "operationId": "getTenantMemberships", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/TenantId" + }, + { + "$ref": "#/components/parameters/StartingAfter" + }, + { + "$ref": "#/components/parameters/EndingBefore" + }, + { + "$ref": "#/components/parameters/Limit" + }, + { + "description": "Which column to sort by.", + "in": "query", + "name": "sort_by", + "schema": { + "enum": [ + "username", + "user_display_name", + "email", + "login_method", + "role_name" + ], + "type": "string" + } + }, + { + "$ref": "#/components/parameters/SortOrder" + }, + { + "$ref": "#/components/parameters/EmailFilter" + }, + { + "$ref": "#/components/parameters/UserIdSearchFilter" + }, + { + "$ref": "#/components/parameters/NameFilter" + }, + { + "$ref": "#/components/parameters/UsernameFilter" + }, + { + "$ref": "#/components/parameters/ConnectionTypeFilter" + }, + { + "$ref": "#/components/parameters/RoleFilter" + } + ], + "responses": { + "200": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "$ref": "#/components/schemas/ListTenantMembershipResponseData" + }, + "jsonapi": { + "$ref": "#/components/schemas/JsonApi" + }, + "links": { + "$ref": "#/components/schemas/Links" + } + }, + "type": "object" + } + } + }, + "description": "List of tenant memberships is returned", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Get all memberships of the tenant", + "tags": [ + "Tenants" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-05-09~experimental", + "2024-09-03~beta" + ], + "x-snyk-api-resource": "memberships", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2024-09-03~beta", + "x-stability-level": "beta" + } + }, + "/tenants/{tenant_id}/memberships/{membership_id}": { + "delete": { + "description": "Delete an individual tenant membership for a single user.", + "operationId": "deleteTenantMembership", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "description": "Unique identifier of the tenant membership.", + "in": "path", + "name": "membership_id", + "required": true, + "schema": { + "description": "Unique identifier for a tenant membership.", + "example": "00000000-0000-0000-0000-000000000000", + "format": "uuid", + "type": "string" + } + }, + { + "$ref": "#/components/parameters/TenantId" + } + ], + "responses": { + "204": { + "description": "successfully deleting an individual membership for a single user", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "$ref": "#/components/headers/LocationHeader" + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" }, "409": { "content": { @@ -192115,6 +69776,105 @@ } }, "500": { + "$ref": "#/components/responses/500" + } + }, + "summary": "Delete an individual tenant membership for a single user.", + "tags": [ + "Tenants" + ], + "x-snyk-api-lifecycle": "released", + "x-snyk-api-releases": [ + "2024-06-04~experimental", + "2024-09-03~beta" + ], + "x-snyk-api-resource": "memberships", + "x-snyk-api-stability": "beta", + "x-snyk-api-version": "2024-09-03~beta", + "x-stability-level": "beta" + }, + "patch": { + "description": "Update the tenant membership with the new role\n", + "operationId": "updateTenantMembership", + "parameters": [ + { + "$ref": "#/components/parameters/Version" + }, + { + "$ref": "#/components/parameters/TenantId" + }, + { + "description": "Unique identifier of the tenant membership.", + "in": "path", + "name": "membership_id", + "required": true, + "schema": { + "description": "Unique identifier for a tenant membership.", + "example": "00000000-0000-0000-0000-000000000000", + "format": "uuid", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/vnd.api+json": { + "schema": { + "properties": { + "data": { + "$ref": "#/components/schemas/UpdateTenantMembershipRequestData" + } + }, + "required": [ + "data" + ], + "type": "object" + } + } + } + }, + "responses": { + "204": { + "description": "successfully updated the tenant membership", + "headers": { + "deprecation": { + "$ref": "#/components/headers/DeprecationHeader" + }, + "location": { + "schema": { + "type": "string" + } + }, + "snyk-request-id": { + "$ref": "#/components/headers/RequestIdResponseHeader" + }, + "snyk-version-lifecycle-stage": { + "$ref": "#/components/headers/VersionStageResponseHeader" + }, + "snyk-version-requested": { + "$ref": "#/components/headers/VersionRequestedResponseHeader" + }, + "snyk-version-served": { + "$ref": "#/components/headers/VersionServedResponseHeader" + }, + "sunset": { + "$ref": "#/components/headers/SunsetHeader" + } + } + }, + "400": { + "$ref": "#/components/responses/400" + }, + "401": { + "$ref": "#/components/responses/401" + }, + "403": { + "$ref": "#/components/responses/403" + }, + "404": { + "$ref": "#/components/responses/404" + }, + "409": { "content": { "application/vnd.api+json": { "schema": { @@ -192287,7 +70047,7 @@ } } }, - "description": "Internal Server Error: An error was encountered while attempting to process the request.", + "description": "Conflict: The requested operation conflicts with the current state of the resource in some way.", "headers": { "deprecation": { "description": "A header containing the deprecation date of the underlying endpoint. For more information, please refer to the deprecation header RFC:\nhttps://tools.ietf.org/id/draft-dalal-deprecation-header-01.html\n", @@ -192347,6 +70107,9 @@ } } } + }, + "500": { + "$ref": "#/components/responses/500" } }, "summary": "Update tenant membership",