Skip to content

This instance's federation actor doc

GET
/federation/instance

Public unauthenticated endpoint — returns the per- instance Ed25519 public key, the canonical instance URL, and the display name. This is what peers fetch when verifying inbound handshakes or HTTP-Sig’d requests (HTTP-Signature verification is enforced on the inbox).

Instance actor doc.

This instance’s federation identity — peers fetch this to verify signed envelopes from us. Stable shape per docs/spec/federation/v1.md §10.

object
instance_url
required

This instance’s canonical https URL.

string
display_name
required

Operator-set display name (from sysconfig.site_name).

string
public_key_pem
required

PEM-wrapped Ed25519 instance public key.

string
fingerprint
required

Lowercase hex SHA-256 of the raw public key for out-of-band verification.

string
protocol_version
required

Always aa-fed/v1 for this release.

string

Instance identity not yet generated (first-boot race).

object
error
required

Human-readable error summary

string
Example
the request could not be completed