From 09d014fe65888c9bd3e467d7b0cb8616cf457875 Mon Sep 17 00:00:00 2001 From: hzrd149 Date: Sun, 8 Mar 2026 11:25:41 -0300 Subject: [PATCH] Remove list endpoint --- buds/02.md | 18 +----------------- 1 file changed, 1 insertion(+), 17 deletions(-) diff --git a/buds/02.md b/buds/02.md index 549fc35..df75cb9 100644 --- a/buds/02.md +++ b/buds/02.md @@ -6,7 +6,7 @@ _All pubkeys MUST be in hex format_ -Defines the `/upload`, `/list` and `DELETE /` endpoints +Defines the `/upload` and `DELETE /` endpoints ## Blob Descriptor @@ -52,22 +52,6 @@ When storing blobs, servers MAY normalise the file extension to a standard forma Servers MAY require authorization when uploading blobs, as defined by [BUD-11](./11.md#endpoint-authorization-requirements). -## GET /list/pubkey - List Blobs (Unrecommended) - -**Note:** The `/list` endpoint is optional and unrecommended. It is not necessary for all servers to implement the `/list` endpoint. Servers MAY implement this endpoint, but are not required to do so. - -The `/list/` endpoint MUST return a JSON array of [Blob Descriptor](#blob-descriptor) that were uploaded by the specified pubkey - -The endpoint MUST support `cursor` and `limit` query parameters for cursor based pagination. The `cursor` parameter MUST be the `sha256` hash of the last blob in the previous page, or omitted to request the first page. The `limit` parameter specifies the maximum number of results to return. The returned array of blob descriptors MUST be sorted by the `uploaded` date in descending order and MUST NOT include the blob at the cursor - -The endpoint MAY support `since` and `until` query parameters to filter the list of blobs by their `uploaded` date. These parameters are deprecated for pagination purposes as they do not preserve server resources - -Servers MAY reject a list request for any reason and MUST respond with the appropriate HTTP `4xx` status code and an error message explaining the reason for the rejection - -### List Authorization - -Servers MAY require authorization when listing blobs as defined by [BUD-11](./11.md#endpoint-authorization-requirements). - ## DELETE /sha256 - Delete Blob Servers MUST accept `DELETE` requests to the `/` endpoint