@spec all(ExNylas.Connection.t(), Keyword.t() | map()) ::
  {:ok, [struct()]} | {:error, ExNylas.Response.t()}

Fetch all contact(s) matching the provided query (the SDK will handle paging).

The second argument can be a keyword list of options + query parameters to pass to the Nylas API (map is also supported). Options supports:

• :send_to - a single arity function to send each page of results (default is nil, e.g. results will be accumulated and returned as a list)
• :delay - the number of milliseconds to wait between each page request (default is 0; strongly recommended to avoid rate limiting)
• :query - a keyword list or map of query parameters to pass to the Nylas API (default is an empty list)

Examples

iex> opts = [send_to: &IO.inspect/1, delay: 3_000, query: [key: "value"]]
iex> {:ok, result} = ExNylas.Contacts.all(conn, opts)

@spec all!(ExNylas.Connection.t(), Keyword.t() | map()) :: [struct()]

Fetch all contact(s) matching the provided query (the SDK will handle paging).

The second argument can be a keyword list of options + query parameters to pass to the Nylas API (map is also supported). Options supports:

• :send_to - a single arity function to send each page of results (default is nil, e.g. results will be accumulated and returned as a list)
• :delay - the number of milliseconds to wait between each page request (default is 0; strongly recommended to avoid rate limiting)
• :query - a keyword list or map of query parameters to pass to the Nylas API (default is an empty list)

Examples

iex> opts = [send_to: &IO.inspect/1, delay: 3_000, query: [key: "value"]]
iex> result = ExNylas.Contacts.all!(conn, opts)

@spec build(map() | struct()) :: {:ok, struct()} | {:error, Ecto.Changeset.t()}

Create and validate a contact, use create/update to send to Nylas.

Examples

iex> {:ok, result} = ExNylas.Contacts.build(payload)

@spec build!(map() | struct()) :: struct()

Create and validate a contact, use create/update to send to Nylas.

Examples

iex> result = ExNylas.Contacts.build!(payload)

@spec create(ExNylas.Connection.t(), map(), Keyword.t() | map()) ::
  {:ok, ExNylas.Response.t()} | {:error, ExNylas.Response.t()}

Create a(n) contact.

Examples

iex> {:ok, result} = ExNylas.Contacts.create(conn, body, params)

@spec create!(ExNylas.Connection.t(), map(), Keyword.t() | map()) ::
  ExNylas.Response.t()

Create a(n) contact.

Examples

iex> result = ExNylas.Contacts.create(conn, body, params)

@spec delete(ExNylas.Connection.t(), String.t(), Keyword.t() | map()) ::
  {:ok, ExNylas.Response.t()} | {:error, ExNylas.Response.t()}

Delete a(n) contact.

Examples

iex> {:ok, result} = ExNylas.Contacts.delete(conn, id, params)

@spec delete!(ExNylas.Connection.t(), String.t(), Keyword.t() | map()) ::
  ExNylas.Response.t()

Delete a(n) contact.

Examples

iex> result = ExNylas.Contacts.delete!(conn, id, params)

@spec find(ExNylas.Connection.t(), String.t(), Keyword.t() | map()) ::
  {:ok, ExNylas.Response.t()} | {:error, ExNylas.Response.t()}

Find a(n) contact.

Examples

iex> {:ok, result} = ExNylas.Contacts.find(conn, id, params)

@spec find!(ExNylas.Connection.t(), String.t(), Keyword.t() | map()) ::
  ExNylas.Response.t()

Find a(n) contact.

Examples

iex> result = ExNylas.Contacts.find!(conn, id, params)

@spec first(ExNylas.Connection.t(), Keyword.t() | map()) ::
  {:ok, ExNylas.Response.t()} | {:error, ExNylas.Response.t()}

Get the first contact.

Examples

iex> {:ok, result} = ExNylas.Contacts.first(conn, params)

@spec first!(ExNylas.Connection.t(), Keyword.t() | map()) :: ExNylas.Response.t()

Get the first contact.

Examples

iex> result = ExNylas.Contacts.first!(conn, params)

@spec list(ExNylas.Connection.t(), Keyword.t() | map()) ::
  {:ok, ExNylas.Response.t()} | {:error, ExNylas.Response.t()}

Fetch contact(s), optionally provide query params.

Examples

iex> {:ok, result} = ExNylas.Contacts.list(conn, params)

@spec list!(ExNylas.Connection.t(), Keyword.t() | map()) :: ExNylas.Response.t()

Fetch contact(s), optionally provide query params.

Examples

iex> result = ExNylas.Contacts.list!(conn, params)

@spec update(ExNylas.Connection.t(), String.t(), map(), Keyword.t() | map()) ::
  {:ok, ExNylas.Response.t()} | {:error, ExNylas.Response.t()}

Update a(n) contact.

Examples

iex> {:ok, result} = ExNylas.Contacts.update(conn, id, body, params)

@spec update!(ExNylas.Connection.t(), String.t(), map(), Keyword.t() | map()) ::
  ExNylas.Response.t()

Update a(n) contact.

Examples

iex> result = ExNylas.Contacts.update!(conn, id, body, params)