v1

latestOpenAPI 3.0.12026-07-268028223.9 KB
Books

Get a book

Retrieve a book by ID

get/v1/books/{id}

Path parameters

idstring required

The book ID

Response

successful

idstring required

The ID of the book

namestring required

The name of the book

role'principal' | 'contributor' | 'viewer' nullable required

The authenticated user's role in this book. Null for admin users accessing books without an explicit BookUser record.

Example response

{
  "id": "abc123xyz",
  "name": "John's Book",
  "role": "principal",
  "users": [
    {
      "id": "abc123xyz",
      "email": "user@example.com",
      "first_name": "John",
      "last_name": "Doe",
      "api_access": {
        "auth_type": "personal_access_token",
        "scope": "read_write"
      },
      "role": "contributor"
    }
  ],
  "tiers": [
    {
      "value": 1,
      "label": "A-tier"
    }
  ],
  "teams": [
    {
      "name": "Advisory Team"
    }
  ]
}