Create a company registry secret
Saves the credential for one private registry and answers the whole list. A registry must resolve to public addresses, and a company holds one credential for each registry and scope.
Path parameters
The id of a company you belong to or manage. Digits only. At least 1.
Body
For Composer, how the registry signs in. Required when kind is composer.
http-basicbearergithub-oauthgitlab-tokennpmcomposerUp to 255 characters.
For npm, the registry's HTTPS URL. For Composer, its host name, with a port if it needs one. Up to 255 characters.
For npm only, the scope the credential is for, such as @example: @, then letters, digits, dots, hyphens and underscores, starting with a letter or digit. Leave out for the default registry. Up to 214 characters.
For an agency only, also give the credential to the sites it manages for its clients.
The token or password, kept exactly as sent. No line breaks or control characters; an npm token may not contain ${. Up to 4,096 characters.
For Composer with http-basic, the username, which is then required. No line breaks or control characters. Up to 255 characters.
Ask the registry once, after the save, whether it accepts the credential.
Returns
201 The company's registry secrets, with the new one.
Fields of the 201 answer
Fields of each item
http-basicbearergithub-oauthgitlab-tokennullnpmcomposerThe last four characters of the token. Null for a token shorter than 12 characters.
An npm registry's HTTPS URL, with one trailing slash; a Composer registry's host. Both in lower case.
The npm scope the credential is for. An empty string for the default registry and for Composer.
Fields
Environments that have a credential of their own for this registry.
What the registry answered. Present only when the request sent verify true.
Fields
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | forbidden | The person is not allowed to do this. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
409 | exists | It already exists. Use the existing one. |
422 | secret_invalid | Choose how the registry signs in: http-basic, bearer, github-oauth or gitlab-token. |
422 | invalid | Fix the field named in field; errors says why. |
422 | too_many_secrets | This company already has the most registry secrets it can hold. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X POST https://manage.corefinity.com/api/corestack/companies/1204/deploy-secrets \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"auth_type": "http-basic",
"kind": "composer",
"label": "Private packages",
"registry": "packages.example.com",
"token": "your-registry-token",
"username": "your-username"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/companies/1204/deploy-secrets', [
'auth_type' => 'http-basic',
'kind' => 'composer',
'label' => 'Private packages',
'registry' => 'packages.example.com',
'token' => 'your-registry-token',
'username' => 'your-username',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/companies/1204/deploy-secrets', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
auth_type: 'http-basic',
kind: 'composer',
label: 'Private packages',
registry: 'packages.example.com',
token: 'your-registry-token',
username: 'your-username',
}),
});
// 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.post(
"https://manage.corefinity.com/api/corestack/companies/1204/deploy-secrets",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"auth_type": "http-basic",
"kind": "composer",
"label": "Private packages",
"registry": "packages.example.com",
"token": "your-registry-token",
"username": "your-username",
},
)
data = res.json() if res.content else None{
"can_share": true,
"data": [
{
"auth_type": "bearer",
"id": 318,
"kind": "composer",
"label": "Private packages",
"last4": "oken",
"last_used_at": null,
"registry": "repo.example.com",
"scope": "",
"shared_with_managed": false,
"used_by": {
"environments": 1,
"overridden_on": 0
},
"verified_at": "2026-11-09T10:42:07Z"
}
],
"verification": {
"id": 318,
"message": "The registry accepted these credentials.",
"verified": true,
"verified_at": "2026-11-09T10:42:07Z"
}
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "exists",
"id": 318,
"message": "A registry for this host is already saved. Edit it instead.",
"reason": "exists"
}{
"code": "secret_invalid",
"errors": {
"auth_type": [
"Choose how the registry signs in: http-basic, bearer, github-oauth or gitlab-token."
]
},
"message": "Choose how the registry signs in: http-basic, bearer, github-oauth or gitlab-token.",
"reason": "secret_invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it is off for this endpointIt has not been cleared for the console. Copy the request and run it yourself when you are sure.