Coolify logoCoolify
Cloud

Check a registry login on a server

API server

https://app.coolify.io/api/v1

Choose where to send API requests

This changes the request URL and code examples on every endpoint page.

API server type

Requests will use

https://app.coolify.io/api/v1

Use only a Coolify URL you trust. Sending a test request also sends the API token you enter.

POST
/servers/{uuid}/registries/{registry}/check

Check that the saved login of the server for a registry still works. Runs docker login with the saved credentials on the server.

Authorization

bearerAuth
AuthorizationBearer <token>

Go to Keys & Tokens / API tokens and create a new token. Use the token as the bearer token.

In: header

Path Parameters

uuid*string

Server UUID

registry*string

Registry host, optionally with a port, for example registry.example.com:5000.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://app.coolify.io/api/v1/servers/string/registries/string/check"
{  "message": "The login for ghcr.io works."}
{  "message": "Invalid token."}
{  "message": "Unauthenticated."}
{  "message": "Resource not found."}
{  "message": "Validation error.",  "errors": {    "name": [      "The name field is required."    ],    "api_url": [      "The api url field is required.",      "The api url format is invalid."    ]  }}

Check server import GET

Check that this instance can import a server, before the source instance starts the transfer. It checks the token, the bundle version, the server limit, servers with the same UUID or IP, and that this instance can reach the SSH port of the server.

Mark server transferred POST

Source-instance recovery step: disable automations here when the target already manages the server but the transfer could not finish on this instance.