libraries

Leave a library

Changed on

End the caller's own non-owner membership, even when library content is unavailable. Repeating departure returns the existing inactive state without changing an owner-removal cutoff. An owner cannot leave; retrying unchanged returns 409.

post/api/libraries/{library_id}/leave

Request

  • Base URL: https://api.gumnut.ai
  • URL: https://api.gumnut.ai/api/libraries/{library_id}/leave
  • Auth: HTTP bearer

Path parameters

library_idstring required

Library identifier.

Response

Successful Response

idstring required

Stable membership record identifier.

library_idstring required

Library this membership belongs to.

role'viewer' | 'collaborator' required

Non-owner library permissions.

viewer reads library content. collaborator also edits and organizes content, including trash and restore. Neither administers members or permanently deletes photos.

state'active' | 'left' | 'removed' 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.

joined_atstring date-time required

Most recent admission instant.

ended_atstring date-time nullable required

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

last_removed_atstring date-time nullable required

Retained owner-removal cutoff for readmission, or null.

created_atstring date-time required

When this record was created.

updated_atstring date-time required

When this record last changed.

Changes