Create a site registry secret
Saves the credential for one private registry and answers the whole list. A registry must resolve to public addresses, and an environment holds one credential for each registry and scope.
Path parameters
The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.
Body
For Composer, how the registry signs in. Required when kind is composer.
http-basicbearergithub-oauthgitlab-tokennpmcomposerA name for the credential. Up 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 @northwind-digital: @, then letters, digits, dots, hyphens and underscores, starting with a letter or digit. Leave out for the default registry. Up to 214 characters.
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. The answer then adds verification.
Returns
201 The environment's registry secrets, with the new one.
Fields of the 201 answer
Fields of each item
How a Composer registry signs in. Null for npm.
http-basicbearergithub-oauthgitlab-tokennullAt least 1.
npmcomposerThe name you gave the credential.
The last four characters of the token. Null for a token shorter than 12 characters.
When a build last received the credential, in UTC. Format: date-time.
An npm registry's HTTPS URL, with one trailing slash; a Composer registry's host, with its port when that is not 443. Both in lower case.
The npm scope the credential is for, such as @northwind-digital. An empty string for the default registry and for Composer.
When the registry last accepted the credential, in UTC. Null when it has not been checked since it last changed. Format: date-time.
What the registry answered. Present only when the request sent verify true.
Fields
The secret that was checked. At least 1.
What the registry answered, in plain words.
Format: date-time.
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 | 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. |
409 | managed_elsewhere | This site is read-only here. Change it in the control panel that manages it. |
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. |
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/sites/1042/deployments/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": "northwind-digital"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/sites/1042/deployments/secrets', [
'auth_type' => 'http-basic',
'kind' => 'composer',
'label' => 'Private packages',
'registry' => 'packages.example.com',
'token' => 'your-registry-token',
'username' => 'northwind-digital',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/deployments/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: 'northwind-digital',
}),
});
// 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/sites/1042/deployments/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": "northwind-digital",
},
)
data = res.json() if res.content else None{
"data": [
{
"auth_type": "bearer",
"id": 318,
"kind": "composer",
"label": "Private packages",
"last4": "oken",
"last_used_at": null,
"registry": "repo.example.com",
"scope": "",
"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.