Check a registry secret with its registry
Asks the registry once, with the saved credential, whether it accepts it. verified says so, message says what the registry answered, and an accepted credential gets its verified_at. A credential the registry refuses, or a registry that cannot be reached, is still a 200 with verified false.
Path parameters
The id of a CoreStack Enterprise environment. Not the same number as a site row id. At least 1.
The id of a registry secret of this environment, as the list answers it. Digits only. At least 1.
Returns
200 What the registry answered, and the credential as it is now.
Fields of the 200 answer
One saved registry credential. Never its token or its username.
Fields
How the registry signs in.
http-basicbearergithub-oauthgitlab-tokenAt least 1.
Always composer on these endpoints.
The 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.
The registry's host, in lower case, with its port when that is not 443.
Always an empty string for a Composer registry.
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, in plain words.
Whether the registry accepted the credential.
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 | forbidden | The person is not allowed to do this. |
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 | none | Check the id. You see only what your account can reach. |
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/environments/1311/deploy-secrets/318/verify \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/environments/1311/deploy-secrets/318/verify');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/environments/1311/deploy-secrets/318/verify', {
method: 'POST',
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.post(
"https://manage.corefinity.com/api/corestack/environments/1311/deploy-secrets/318/verify",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
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"
},
"message": "The registry accepted these credentials.",
"verified": true
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"message": "Not found."
}{
"code": "invalid",
"errors": {
"environment": [
"This is a CoreStack or CoreCluster environment: name it by its site_id."
]
},
"field": "environment",
"message": "This is a CoreStack or CoreCluster environment: name it by its site_id.",
"reason": "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.