{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://raw.githubusercontent.com/api-evangelist/postman/main/json-schema/postman-sdk-git-connection-pull-request-list-schema.json", "title": "sdkGitConnectionPullRequestList", "x-generated": "2026-10-04", "x-method": "derived", "x-generator": "derive-json-schema.py", "x-source": "openapi/postman-sdks-api-openapi.yml#/components/schemas/sdkGitConnectionPullRequestList", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/$defs/sdkGitConnectionPullRequest" }, "description": "A list of SDK update pull requests on the Git connection." }, "meta": { "$ref": "#/$defs/metaNextCursorTotal" } }, "required": [ "data", "meta" ], "$defs": { "elementType-2": { "type": "string", "enum": [ "collection", "spec" ], "description": "The type of Postman element.", "title": "elementType-2" }, "metaNextCursorTotal": { "type": "object", "properties": { "nextCursor": { "type": [ "string", "null" ], "description": "The pagination cursor that points to the next record in the results set." }, "total": { "type": "integer", "description": "The number of records found." } }, "description": "The response's meta information for paginated results.", "title": "metaNextCursorTotal" }, "sdk": { "type": "object", "properties": { "id": { "$ref": "#/$defs/sdkId" }, "language": { "$ref": "#/$defs/sdkLanguage" }, "source": { "$ref": "#/$defs/sdkSource" }, "workspaceId": { "type": "string", "description": "The ID of the workspace that owns the SDK, derived from the source entity." }, "version": { "type": "string", "description": "The generated SDK's semantic version ID. This value is automatically assigned by the release/changelog pipeline." }, "buildStatus": { "$ref": "#/$defs/sdkBuildStatus" }, "error": { "$ref": "#/$defs/sdkErrorBuildStatusFailure" }, "pullRequest": { "$ref": "#/$defs/sdkPullRequest" }, "createdAt": { "type": "string", "format": "date-time", "description": "The date and time at which the SDK was created." }, "updatedAt": { "type": "string", "format": "date-time", "description": "The date and time at which the SDK was last updated." } }, "required": [ "id", "language", "source", "workspaceId", "buildStatus", "createdAt", "updatedAt" ], "description": "Information about the generated SDK.", "title": "sdk" }, "sdkBuildStatus": { "type": "string", "enum": [ "queued", "in_progress", "succeeded", "failed" ], "description": "The SDK's build lifecycle:\n- `queued` — Accepted but not yet started.\n- `in_progress` — The SDK generation is running and in progress.\n- `succeeded` — The archive is built and available for download.\n- `failed` — The SDK generation failed. For information, check the `error` response.\n", "title": "sdkBuildStatus" }, "sdkErrorBuildStatusFailure": { "type": "object", "properties": { "code": { "type": "string", "description": "The build failure's error code." }, "message": { "type": "string", "description": "Information about the build failure." } }, "required": [ "code", "message" ], "description": "Information about the SDK build's status when `buildStatus` is `failed`.", "title": "sdkErrorBuildStatusFailure" }, "sdkGitConnectionPRStatus": { "type": "string", "enum": [ "open", "merged", "closed" ], "description": "The lifecycle status of a pull request.", "title": "sdkGitConnectionPRStatus" }, "sdkGitConnectionPullRequest": { "type": "object", "properties": { "number": { "type": "integer", "description": "The pull request's ID." }, "url": { "type": "string", "format": "uri", "description": "The pull request's URL." }, "status": { "$ref": "#/$defs/sdkGitConnectionPRStatus" }, "sdk": { "$ref": "#/$defs/sdk" }, "createdAt": { "type": "string", "format": "date-time", "description": "The date and time at which the pull request was created." }, "updatedAt": { "type": "string", "format": "date-time", "description": "The date and time at which the pull request was last updated." } }, "required": [ "number", "url", "status", "createdAt", "updatedAt" ], "description": "Information about a pull request that shipped the SDK update.", "title": "sdkGitConnectionPullRequest" }, "sdkId": { "type": "string", "description": "The SDK's ID.", "title": "sdkId" }, "sdkLanguage": { "type": "string", "enum": [ "typescript", "python", "go", "java", "csharp", "ruby", "php", "kotlin", "rust", "cli" ], "description": "The target output language for the generated SDK.", "title": "sdkLanguage" }, "sdkPullRequest": { "type": "object", "properties": { "url": { "type": "string", "format": "uri", "description": "The pull request's URL." }, "status": { "$ref": "#/$defs/sdkGitConnectionPRStatus" }, "sdkId": { "$ref": "#/$defs/sdkId" } }, "required": [ "url", "status", "sdkId" ], "description": "If the SDK was shipped (or proposed for shipping) through a Git connection, this is a compact representation of the pull request that shipped it. Otherwise, this returns a `null` value.", "title": "sdkPullRequest" }, "sdkSource": { "type": "object", "properties": { "type": { "$ref": "#/$defs/elementType-2" }, "id": { "type": "string", "description": "The ID of the Postman Collection or specification in Postman." } }, "required": [ "type", "id" ], "description": "The collection or specification that the SDK is generated from.", "title": "sdkSource" } } }