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.
Path parameters
The id of a company you belong to or manage. Digits only. At least 1.
Query parameters
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
Send as cursor to read the next page. Null on the last page.
Fields of each item
The address of a self-hosted GitLab. Null for every other provider.
True when you may remove the connection and no environment deploys through it.
When the connection was added, in UTC with a +00:00 offset. Format: date-time.
The environments that deploy through the connection and that you can see.
Fields of each item
The environment's id. At least 1.
The environment's name.
The site row id, when the environment is a CoreStack or CoreCluster site. Otherwise null.
The website's name. Empty when the website cannot be read.
At least 1.
At least 1.
Since when the connection has needed re-authorising, in the same form. Null while it is connected. Format: date-time.
On a GitHub connection, GitHub's page where an organisation gives access to its repositories. Null for every other provider.
How many more environments deploy through the connection that are not shown to you. At least 0.
The git provider.
githubgitlabbitbucketgitlab_self_hostedThe provider's name, such as GitLab or GitLab (self-hosted).
What reconnecting this connection takes, in plain words.
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.
needs_reauthorisation means the provider no longer accepts the connection, so deployments through it fail until it is reconnected.
connectedneeds_reauthorisationThe account's username at the provider.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | scope_required | Use a token with the scope named in scope. |
404 | none | Check the id. You see only what your account can reach. |
422 | invalid_cursor | That cursor is not one of ours: start again from the first page. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait 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"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/companies/1204/deployment-connections');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/companies/1204/deployment-connections', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.get(
"https://manage.corefinity.com/api/companies/1204/deployment-connections",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"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
}{
"message": "Unauthenticated."
}{
"code": "scope_required",
"message": "This access token does not have the destructive scope this needs. Use a token with the destructive scope.",
"reason": "scope_required",
"scope": "destructive"
}{
"message": "Not found."
}{
"code": "invalid_cursor",
"message": "That cursor is not one of ours: start again from the first page.",
"reason": "invalid_cursor"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}