Skip to main content
POST
Leave a library

Authorizations

Authorization
string
header
required

First-party Gumnut app session (Clerk session JWT). Only the Gumnut web and mobile apps can obtain one — API keys and OAuth tokens cannot manage credentials or library sharing, so these operations are not callable with the credentials this API otherwise accepts.

Path Parameters

library_id
string
required

Library identifier.

Response

Successful Response

id
string
required

Stable membership record identifier.

library_id
string
required

Library this membership belongs to.

user
UserSummary · object
required

Member account summary.

role
enum<string>
required

Current or last assigned role.

Available options:
viewer,
collaborator
state
enum<string>
required

A member's library access state.

active grants the assigned role. left means the member departed; removed means the owner revoked access. left and removed grant no access.

Available options:
active,
left,
removed
joined_at
string<date-time>
required

Most recent admission instant.

ended_at
string<date-time> | null
required

Most recent departure or removal instant, or null while active.

last_removed_at
string<date-time> | null
required

Retained owner-removal cutoff for readmission, or null.

created_at
string<date-time>
required

When this record was created.

updated_at
string<date-time>
required

When this record last changed.