Get all SDK Git connections

GET

/sdk-git-connections

GET

/sdk-git-connections

$ curl -G https://api.getpostman.com/sdk-git-connections \
>      -H "x-api-key: <apiKey>" \
>      -d workspaceId=1f0df51a-8658-4ee8-a2a1-d2567dfa09a9

1 {
2   "data": [
3     {
4       "sdkGitConnectionId": "8d4f7c1a-2b3e-4f5a-9c8d-1a2b3c4d5e6f",
5       "source": {
6         "type": "collection",
7         "id": "12ece9e1-2abf-4edc-8e34-de66e74114d2"
8       },
9       "language": "typescript",
10       "status": "active",
11       "repositoryUrl": "https://git.example.com/engineering/engineering-sdk",
12       "targetBranch": "main",
13       "autoUpdatePullRequestsEnabled": true,
14       "pullRequests": [
15         {
16           "url": "https://git.example.com/engineering/engineering-sdk/pull/87",
17           "status": "open",
18           "sdkId": "9c4e7d1a-2b3c-4f5e-8a9b-1c2d3e4f5a6b"
19         }
20       ],
21       "createdAt": "2026-04-12T09:00:00Z",
22       "updatedAt": "2026-05-30T10:21:14Z"
23     }
24   ],
25   "meta": {
26     "nextCursor": null,
27     "total": 1
28   }
29 }

Gets all Git repository connections the authenticated user has access to in the given workspace. Each connection links one Postman Collection or specification and one SDK language to a target Git repository.

Authentication

x-api-keystring

API Key authentication via header

Authorizationstring

A valid SCIM API key for calls to SCIM endpoints.

A valid [SCIM API key](https://learning.postman.com/docs/administration/scim-provisioning/scim-provisioning-overview/#generating-scim-api-key) for calls to SCIM endpoints.

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Query parameters

workspaceIdstringRequired

The ID of the workspace that owns the source entities.

sourceIdstringOptional

Filter results by the originating Postman Collection or specification ID.

languageenumOptional

Filter results by SDK language.

statusenumOptional

Filter results by connection status.

Allowed values:

repositoryUrlstringOptionalformat: "uri"

Filter results by the canonical URL of the target Git repository.

cursorstringOptional

The pointer to the first record of the set of paginated results. To view the next response, use the nextCursor value for this parameter.

limitintegerOptional<=25Defaults to 25

The maximum number of rows to return in the response, up to a maximum value of 25. Any value greater than 25 returns a 400 Bad Request response.

Response

Successful Response

datalist of objects

A list of SDK Git connections.

metaobject

The response's meta information for paginated results.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error