@spec allow(Ash.Api.t()) :: mfa() | nil

The allow MFA for an api

@spec allow_unregistered?(Ash.Api.t()) :: atom() | nil

Whether or not the api allows unregistered resources to be used with it

@spec authorize(Ash.Api.t()) :: :when_requested | :always | :by_default

When authorization should happen for a given api

@spec registry(Ash.Api.t()) :: atom() | nil

The resource registry for an api

@spec require_actor?(Ash.Api.t()) :: boolean()

Whether or not the actor is always required for an api

@spec resource(Ash.Api.t(), Ash.Resource.t()) ::
  {:ok, Ash.Resource.t()} | {:error, Ash.Error.t()}

Returns {:ok, resource} if the resource can be used by the api, or {:error, error}.

@spec resources(Ash.Api.t()) :: [Ash.Resource.t()]

Gets the resources of an Api module. DO NOT USE AT COMPILE TIME.

If you need the resource list at compile time, you will need to introduce a compile time dependency on all of the resources, and therefore should use the registry directly. Registry |> Ash.Registry.Info.entries().

@spec short_name(Ash.Api.t()) :: nil | :infinity | integer()

The short name for an api

@spec span_name(Ash.Api.t(), Ash.Resource.t(), action :: atom()) :: String.t()

The span_name for an api and resource combination

@spec telemetry_event_name(Ash.Api.t(), atom() | [atom()]) :: [atom()]

Names a telemetry event for a given api/resource combo

@spec timeout(Ash.Api.t()) :: nil | :infinity | integer()

The execution timeout for an api

@spec trace_name(Ash.Api.t()) :: String.t()

The trace name for an api