Slackblocks.Views.Home (slackblocks v2.8.0)

View Source

The payload for publishing an App Home tab with views.publish.

Slack reference: https://docs.slack.dev/surfaces/app-home

Fields

  • blocks — Adds the blocks shown on the App Home tab, in display order. Required.
  • private_metadata — Sets application-defined data returned in view payloads. Optional; nil omits the field.
  • callback_id — Sets an identifier returned in view payloads so your app can recognize the view. Optional; nil omits the field.
  • external_id — Sets a workspace-unique identifier you can use to update the view later. Optional; nil omits the field.

Summary

Functions

Atomically replaces supplied fields; omitted fields retain their values.

Constructs and validates a value. Text conveniences apply to keyword input.

Constructs a value or raises Slackblocks.ValidationError.

Types

t()

@type t() :: %Slackblocks.Views.Home{
  blocks: [Slackblocks.Types.block()],
  callback_id: binary() | nil,
  external_id: binary() | nil,
  private_metadata: binary() | nil
}

Functions

change(value, options)

@spec change(
  t(),
  keyword()
) :: {:ok, t()} | {:error, Slackblocks.ValidationError.t()}

Atomically replaces supplied fields; omitted fields retain their values.

change!(value, options)

@spec change!(
  t(),
  keyword()
) :: t()

Replaces fields or raises Slackblocks.ValidationError.

new(options)

@spec new(keyword()) :: {:ok, t()} | {:error, Slackblocks.ValidationError.t()}

Constructs and validates a value. Text conveniences apply to keyword input.

new!(options)

@spec new!(keyword()) :: t()

Constructs a value or raises Slackblocks.ValidationError.