Add a connection entry, verified by one authenticated fetch.
Changed onURL AND PIN ARE IMMUTABLE once stored, so there is no edit verb anywhere: re-pointing a stored credential at a different host is the credential-redirect attack, and re-pointing is remove + add, which re-runs the full ceremony including the human fingerprint confirmation.
The caller must already have displayed the SPKI fingerprint and taken the human's confirmation — that is interactive and belongs to the client. This endpoint performs the authenticated directory fetch, which returns the remote's instance identity: self-connection (409) and duplicate-identity (409) fire there, BEFORE the entry is committed. A fetch that does not succeed commits nothing (422).
The credential is write-only after storage: sealed under the instance keyring, never re-displayable through any surface, and leaving the process only inside TLS to the pinned remote.
Request
- Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
- URL: /api/v1/instance/remotes
- Auth: HTTP bearer
Request body
Response
The entry, with the listing its verifying fetch returned.
Changes
- info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status
- info
- warning
added the new
payload_too_largeenum value to the/response property for the response status - warning
added the new
payload_too_largeenum value to the/response property for the response status - warning
added the new
payload_too_largeenum value to the/response property for the response status - warning
added the new
payload_too_largeenum value to the/response property for the response status - warning
added the new
payload_too_largeenum value to the/response property for the response status - warning
added the new
payload_too_largeenum value to the/response property for the response status - warning
added the new
payload_too_largeenum value to the/response property for the response status - warning
added the new
payload_too_largeenum value to the/response property for the response status - warning
added the new
unprocessableenum value to the/response property for the response status - warning
added the new
unprocessableenum value to the/response property for the response status - warning
added the new
unprocessableenum value to the/response property for the response status - warning
added the new
unprocessableenum value to the/response property for the response status - warning
added the new
unprocessableenum value to the/response property for the response status - warning
added the new
unprocessableenum value to the/response property for the response status - warning
added the new
unprocessableenum value to the/response property for the response status - warning
added the new
unprocessableenum value to the/response property for the response status
- warning