Defederate a peer

DELETE

/admin/federation/peers/{id}

• Local development behind nginx (port 8088 by default)

Removes the peer row. Per ADR 0043 §“Trust model” the federation_shares table cascades on this delete and the server emits the final aa:Unshare activity to the peer so they purge their local cache. Cascade + activity emission happen automatically when those phases ship; this endpoint is the entry point.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Responses

204

Peer removed.

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

403

Authenticated but missing required capabilities

object

error

required

Human-readable error summary

string

Example

the request could not be completed

404

Resource not found

object

error

required

Human-readable error summary

string

Example

the request could not be completed