CorefinityCorefinityDocs
Open the Control PanelControl Panel
Repository connections · 1 of 4

List a company's repository connections

Answers the git provider accounts of a company you may act for: your own, or a client your agency manages. Oldest first, 50 a page. A company you cannot see answers 404, as one that does not exist. Paged by cursor: send next_cursor back as cursor; null means the last page.

GET/api/companies/{company}/deployment-connections

Path parameters

companyintegerRequired

The id of a company you belong to or manage. Digits only. At least 1.

Query parameters

cursorstring

The next_cursor of the previous answer. Digits only, at most 20; anything else is refused 422.

Returns

200 One page of connections.

Fields of the 200 answer
next_cursorstring or nullRequired

Send as cursor to read the next page. Null on the last page.

connectionsarray of objectsRequired
Fields of each item
base_urlstring or nullRequired

The address of a self-hosted GitLab. Null for every other provider.

can_removebooleanRequired

True when you may remove the connection and no environment deploys through it.

connected_atstring or nullRequired

When the connection was added, in UTC with a +00:00 offset. Format: date-time.

environmentsarray of objectsRequired

The environments that deploy through the connection and that you can see.

Fields of each item
environment_idintegerRequired

The environment's id. At least 1.

namestringRequired

The environment's name.

site_idinteger or nullRequired

The site row id, when the environment is a CoreStack or CoreCluster site. Otherwise null.

websitestringRequired

The website's name. Empty when the website cannot be read.

website_idintegerRequired

At least 1.

idintegerRequired

At least 1.

needs_reauth_sincestring or nullRequired

Since when the connection has needed re-authorising, in the same form. Null while it is connected. Format: date-time.

organisation_access_urlstring or nullRequired

On a GitHub connection, GitHub's page where an organisation gives access to its repositories. Null for every other provider.

other_environmentsintegerRequired

How many more environments deploy through the connection that are not shown to you. At least 0.

providerstringRequired

The git provider.

githubgitlabbitbucketgitlab_self_hosted
provider_labelstringRequired

The provider's name, such as GitLab or GitLab (self-hosted).

reconnect_notestringRequired

What reconnecting this connection takes, in plain words.

reconnect_urlstring or nullRequired

A page that reconnects the account. Open it in a browser signed in to the Control Panel, then sign in to the provider as username. Null for a self-hosted GitLab, which takes a new access token in the Control Panel instead.

statusstringRequired

needs_reauthorisation means the provider no longer accepts the connection, so deployments through it fail until it is reconnected.

connectedneeds_reauthorisation
usernamestringRequired

The account's username at the provider.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403scope_requiredUse a token with the scope named in scope.
404noneCheck the id. You see only what your account can reach.
422invalid_cursorThat cursor is not one of ours: start again from the first page.
422invalidFix the field named in field; errors says why.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/companies/1204/deployment-connections \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "connections": [
    {
      "base_url": null,
      "can_remove": false,
      "connected_at": "2026-11-02T09:30:00+00:00",
      "environments": [
        {
          "environment_id": 1311,
          "name": "production",
          "site_id": null,
          "website": "Harbour & Finch trade",
          "website_id": 1310
        }
      ],
      "id": 4217,
      "needs_reauth_since": "2026-11-09T03:12:45+00:00",
      "organisation_access_url": null,
      "other_environments": 0,
      "provider": "gitlab",
      "provider_label": "GitLab",
      "reconnect_note": "Open reconnect_url in a browser signed in to the control panel, then sign in to GitLab as daniel-reyes. Signing in as a different account adds a new connection instead of repairing this one.",
      "reconnect_url": "https://manage.corefinity.com/company/auth/version-control/gitlab?company=1180",
      "status": "needs_reauthorisation",
      "username": "daniel-reyes"
    },
    {
      "base_url": "https://gitlab.example.com",
      "can_remove": true,
      "connected_at": "2026-11-05T14:05:11+00:00",
      "environments": [],
      "id": 4230,
      "needs_reauth_since": null,
      "organisation_access_url": null,
      "other_environments": 0,
      "provider": "gitlab_self_hosted",
      "provider_label": "GitLab (self-hosted)",
      "reconnect_note": "Self-hosted GitLab has no sign-in link: create a new personal access token (api scope) while signed in as northwind-deploy, then use Replace access token on this connection in the control panel (Company, Deployment Connections).",
      "reconnect_url": null,
      "status": "connected",
      "username": "northwind-deploy"
    }
  ],
  "next_cursor": null
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT