Clarification for `/event_auth` (#3583)

The description on this endpoint implied it returned the auth chain for the
full state of the room, which is incorrect.
neilalexander/msc/send
Richard van der Hoff 2 years ago committed by GitHub
parent 592cbd537c
commit 355e06eaa6
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

@ -0,0 +1 @@
Clarify that `GET /_matrix/federation/v1/event_auth/{roomId}/{eventId}` does *not* return the auth chain for the full state of the room.

@ -57,17 +57,13 @@ paths:
auth_chain: auth_chain:
type: array type: array
description: |- description: |-
The full set of authorization events that make up the state of The [PDUs](/server-server-api/#pdus) forming the auth chain
the room, and their authorization events, recursively. Note that of the given event. The event format varies depending on the
events have a different format depending on the room version - room version - check the [room version specification](/rooms)
check the [room version specification](/rooms) for precise event formats. for precise event formats.
items: items:
type: object type: object
title: PDU title: PDU
description: |-
The [PDUs](/server-server-api/#pdus) contained in the auth chain. The event format
varies depending on the room version - check the [room version specification](/rooms)
for precise event formats.
properties: [] properties: []
example: example:
$ref: "examples/minimal_pdu.json" $ref: "examples/minimal_pdu.json"

Loading…
Cancel
Save