CorefinityCorefinityDocs
Open the Control PanelControl Panel
Deployment templates · 2 of 15

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.

POST/api/corestack/companies/{company}/deploy-secrets

Path parameters

companyintegerRequired

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

Body

auth_typestring

For Composer, how the registry signs in. Required when kind is composer.

http-basicbearergithub-oauthgitlab-token
kindstringRequired
npmcomposer
labelstringRequired

Up to 255 characters.

registrystringRequired

For npm, the registry's HTTPS URL. For Composer, its host name, with a port if it needs one. Up to 255 characters.

scopestring

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.

shared_with_managedboolean

For an agency only, also give the credential to the sites it manages for its clients.

tokenstringRequired

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.

usernamestring

For Composer with http-basic, the username, which is then required. No line breaks or control characters. Up to 255 characters.

verifyboolean

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
can_sharebooleanRequired
dataarray of objectsRequired
Fields of each item
auth_typestring or nullRequired
http-basicbearergithub-oauthgitlab-tokennull
idintegerRequired
kindstringRequired
npmcomposer
labelstringRequired
last4string or nullRequired

The last four characters of the token. Null for a token shorter than 12 characters.

last_used_atstring or nullRequired
registrystringRequired

An npm registry's HTTPS URL, with one trailing slash; a Composer registry's host. Both in lower case.

scopestringRequired

The npm scope the credential is for. An empty string for the default registry and for Composer.

shared_with_managedbooleanRequired
used_byobjectRequired
Fields
environmentsintegerRequired
overridden_onintegerRequired

Environments that have a credential of their own for this registry.

verified_atstring or nullRequired
verificationobject

What the registry answered. Present only when the request sent verify true.

Fields
idintegerRequired
messagestringRequired
verifiedbooleanRequired
verified_atstring or nullRequired

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403forbiddenThe person is not allowed to do this.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
409existsIt already exists. Use the existing one.
422secret_invalidChoose how the registry signs in: http-basic, bearer, github-oauth or gitlab-token.
422invalidFix the field named in field; errors says why.
422too_many_secretsThis company already has the most registry secrets it can hold.
429rate_limitedWait 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"
  }'
{
  "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"
  }
}
Try it

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.

Was this helpful?
Open in ClaudeOpen in ChatGPT