List federation outbox rows

GET

/admin/federation/outbox

• Local development behind nginx (port 8088 by default)

Returns per-recipient queued / sent / failed / cancelled rows from federation_outbox. Filterable by peer + status

• activity type + date range; paginated. Gated on system.admin.

Each row carries the activity_id back-reference so the admin UI can render the originating envelope alongside the delivery state.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Query Parameters

peer_id

string format: uuid

status

string

Allowed values: queued sent failed cancelled

activity_type

string

Filter by the originating activity’s verb (Like / Create / aa:Share etc.).

since

string format: date-time

RFC3339 timestamp; only rows created at or after this.

limit

integer

default: 100 >= 1 <= 500

cursor

string

Pagination cursor from a prior response (opaque).

Responses

200

Outbox rows matching the filter.

object

items

required

Array<object>

One row in the per-recipient federation_outbox queue . Derived from the activities ledger by the dispatcher per design §3.1; delivered by the worker per §3.3. The admin UI surfaces queued / sent / failed / cancelled rows for operator visibility into outbound federation traffic.

object

id

required

string format: uuid

activity_id

required

string format: uuid

peer_id

required

string format: uuid

target_user_url

Per-recipient actor URL within the peer; null = broadcast.

string

nullable

status

required

string

Allowed values: queued sent failed cancelled

attempts

required

Delivery attempt count (caps at 5 before terminal-fail).

integer

next_attempt_at

required

Wall-clock time of the next attempt per the §3.4 backoff schedule.

string format: date-time

last_attempt_at

string format: date-time

nullable

last_error

Failure detail captured on the most recent attempt. For failed rows, may carry a §12.1 reject reason from the receiver — the admin UI maps these to retriable / non-retriable warnings on the re-queue confirmation prompt.

string

sent_at

string format: date-time

nullable

delivered_with_key_id

HTTP-Sig keyId used on the successful delivery (forensics).

string

nullable

created_at

required

string format: date-time

updated_at

required

string format: date-time

next_cursor

string

nullable

400

Malformed request

object

error

required

Human-readable error summary

string

Example

the request could not be completed

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