# library

> Query in domain **Libraries**

- HTML: [library.html](library.html)
- Raw SDL: [library.sdl](library.sdl)
- Covered by: [llms.txt](../llms.txt)

Retrieve `Library` details by Id.

## Returns

`Library`

## Arguments

- `id`: `ID!` — `Library` Id.

## Example

```graphql
query Library {
  library(
    id: "…"
  ) {
    __typename
    assets {
      total
      page
      limit
      hasNextPage
      items {
        __typename
        title
        id
        alternativeText
        author
        attachments { id }
        availability { from }
        ... on Audio {
          previewUrl
          thumbnailUrl
          filename
          downloadUrl
        }
        ... on Document {
          previewUrl
          thumbnailUrl
          filename
          downloadUrl
        }
        ... on EmbeddedContent {
          previewUrl
          thumbnailUrl
          isDecorative
        }
        ... on File {
          previewUrl
          thumbnailUrl
          filename
          downloadUrl
        }
        ... on Image {
          previewUrl
          thumbnailUrl
          filename
          downloadUrl
        }
        ... on Video {
          previewUrl
          thumbnailUrl
          filename
          bitrate
        }
      }
    }
    browse {
      assets {
        total
        page
        limit
        hasNextPage
        items { id }
      }
      folders {
        total
        page
        limit
        hasNextPage
        items { id }
      }
    }
    collaborators {
      users {
        total
        page
        limit
        hasNextPage
        items { id }
      }
    }
    collections {
      total
      page
      limit
      hasNextPage
      items {
        name
        id
        assets {
          total
          page
          limit
          hasNextPage
          items { id }
        }
        currentUserPermissions { canAddAssets }
      }
    }
    color {
      alpha
      blue
      green
      red
    }
    currentUserPermissions {
      canCreateAssets
      canCreateCollections
      canViewCollaborators
    }
    customMetadataProperties {
      name
      id
      createdAt
      defaultValue
      forbiddenDependeePropertyIds
      helpText
      creator {
        __typename
        name
        id
      }
      dependency {
        __typename
        propertyId
        type
        ... on CustomMetadataPropertySelectValueTypeDependencyTypeEquals {
          propertyOptionId
        }
        ... on CustomMetadataPropertySelectValueTypeDependencyTypeOneOf {
          propertyOptionIds
        }
      }
      modifier {
        __typename
        name
        id
      }
      permissions {
        basic { permissionLevel }
        custom { permissionLevel }
      }
      type {
        __typename
        name
        ... on CustomMetadataPropertyTypeCatalog {
          allowedLinkedColumnIds
          allowMultiSelect
        }
      }
    }
    id
    licenses {
      title
      id
      addByDefault
      license
      requireConsensus
    }
    name
    workflow {
      id
      statuses {
        name
        id
        enterRules
        assignedUsers { id }
        checklistPresets { id }
      }
    }
  }
}
```

Raw: [`library.example.sdl`](library.example.sdl)