Skip to main content
GET
/
repos
/
{repo_id}
/
shelves
Get a list of all shelves in the repo.
curl --request GET \
  --url https://api.diversion.dev/v0/repos/{repo_id}/shelves \
  --header 'Authorization: Bearer <token>'
{
  "object": "Shelf",
  "items": [
    {
      "id": "<string>",
      "name": "<string>",
      "created_timestamp": 123,
      "branch_id": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

This API uses OAuth 2 with the implicit grant flow

Path Parameters

​
repo_id
string
required

The repo ID of the repository. Repo name can be used instead of the ID, but usage of ID for permanent linking and API requests is preferred.

Required string length: 3 - 128
Example:

"example_id"

Query Parameters

​
branch_id
string

Optional branch id to filter by

Response

A list of shelf objects

​
object
enum<string>
required
Available options:
Shelf
​
items
object[]
required