Performing mutations

[churcho]

Does this client offer the ability to perform mutations on an endpoint? Looked thru the doc and can't seem to find any.

[Menkir]

Idk if its up-to-date but maybe it helps some other guys.
The Client does not support mutations natively. But in the end mutations are http requests as well as queries. So, in order to have a Client that behaves for mutation operations analogous to the underlying api you need to inject the other methods like delete, delete_by, put, put_by and so on and implement the handle callbacks in the client.
Example a Behvaiour that can be applied to any client:

defmodule ClientExtension do
  @type return :: :ok | {:ok, any()} | {:error, any()}
  @callback delete_by(term :: atom(), variables :: map()) :: return()
  @callback post_by(term :: atom(), variables :: map()) :: return()
  @callback put_by(term :: atom(), variables :: map()) :: return()

  defmacro __using__(_args) do
    quote do
      @behaviour unquote(__MODULE__)

      @impl true
      def put_by(term, variables), do: handle(:put_by, term, variables)

      @impl true
      def post_by(term, variables), do: handle(:post_by, term, variables)

      @impl true
      def delete_by(term, variables), do: handle(:delete_by, term, variables)

    end
  end
end

The Context should also simply map its function to client().post_by etc. You can also achieving that by writing some Context-Macro that maps these functions implicitly.

I don't know why the team didn't include the mutation operations as part of the standard api.