registercheckby openlaw group
API referenceTransparency register

Update a connection

PATCH
/connections/{connection_id}

Changes the fields the body names. label and metadata change at once and do not ask the register anything (metadata merges: a key set to null is removed, a key not named stays). credentials replaces a live connection's login and asks the register about it again; a login the register refuses is stored, and the connection is refused with its error until the next update. A test connection has no login to replace. Only an owner or an admin of the workspace may update one.

Free.

Authorization

bearerAuth
AuthorizationBearer <token>

Your API key, sent as Authorization: Bearer rc_prod_….

In: header

Path Parameters

connection_id*string

The connection's id.

Match^conn_[0-7][0-9a-hjkmnp-tv-z]{25}$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

What to change; only the fields named change. metadata merges into what is stored (a key set to null is removed), label: null clears the label, and credentials replaces a live connection's login.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X PATCH "https://api.registercheck.de/v1/connections/conn_01k6hb7xq0fm8a4q2t7bw9c5ve" \  -H "Authorization: Bearer $REGISTERCHECK_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "label": "Kunde A (neu)",    "credentials": {      "email": "compliance@example.de",      "password": "a-new-example-password"    }  }'
{  "id": "conn_01k6hb7xq0fm8a4q2t7bw9c5ve",  "object": "connection",  "provider": "transparency_register",  "environment": "live",  "status": "verified",  "error": null,  "account": {    "email_masked": "c***@example.de"  },  "label": "Kunde A",  "metadata": {    "client_id": "k-1042"  },  "created_at": "2026-11-17T09:58:12Z",  "updated_at": "2026-11-17T09:58:12Z",  "last_verified_at": "2026-11-17T09:58:12Z"}