# `Attio.Lists`
[🔗](https://github.com/sgerrand/ex_attio/blob/v0.2.0/lib/attio/lists.ex#L1)

Functions for managing Attio lists.

Lists are process models that contain entries — records of a single object type
enriched with list-specific attributes (e.g. pipeline stage, owner).

Requires the `list_configuration:read` scope for read operations and
`list_configuration:read-write` for mutations.

# `create`

```elixir
@spec create(Attio.Client.t(), map()) :: {:ok, map()} | {:error, term()}
```

Creates a new list.

## Required attributes

  * `"title"` - Display name for the list.
  * `"object_slug"` - The slug of the object type this list tracks (e.g. `"people"`).

# `get`

```elixir
@spec get(Attio.Client.t(), String.t()) :: {:ok, map()} | {:error, term()}
```

Gets a single list by its ID or slug.

# `list`

```elixir
@spec list(Attio.Client.t()) :: {:ok, map()} | {:error, term()}
```

Lists all lists in the workspace.

# `list_views`

```elixir
@spec list_views(Attio.Client.t(), String.t()) :: {:ok, map()} | {:error, term()}
```

Lists saved views for a list.

# `update`

```elixir
@spec update(Attio.Client.t(), String.t(), map()) :: {:ok, map()} | {:error, term()}
```

Updates a list's configuration.

---

*Consult [api-reference.md](api-reference.md) for complete listing*