> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Slack Message With Hitl: Inputs, Cost & CLI Example
> Send a Slack message with interactive HITL buttons, wait for a response, and return a normalized decision payload. Includes inputs, outputs, and CLI examples.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=slack_message_with_hitl:{"channel":"{{channel}}","text":"{{text}}","buttons":"{{buttons}}"}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| -------------------------- | -------------------------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------- |
| `payload.channel` | `string` | Yes | | Slack channel ID. |
| `payload.text` | `string` | Yes | | Message text. When blocks are provided, used as notification/accessibility fallback and editable draft in modal. |
| `payload.blocks` | `array` | No | | |
| `payload.buttons` | `array` | Yes | | Buttons to display in the Slack message (1–5). |
| `payload.allow_edit` | `boolean` | No | | Whether to show an Edit button for draft text editing. Defaults to false. |
| `payload.signal` | `string` | No | | Optional signal key override. Defaults to workflow+block scoped signal. |
| `payload.timeout` | `string` | No | | Signal wait timeout (for example 30m, 24h). |
| `payload.on_timeout` | `"return_null" \| "error"` | No | | |
| `payload.timeout_error` | `string` | No | | |
| `payload.timeout_emit` | `record` | No | | |
| `payload.post_interaction` | `object` | No | | |
| `payload.mrkdwn` | `boolean` | No | | |
### Allowed values
| Field | Allowed values |
| -------------------- | ---------------------- |
| `payload.on_timeout` | `return_null`, `error` |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"properties": {
"channel": {
"type": "string",
"description": "Slack channel ID.",
"minLength": 1
},
"text": {
"type": "string",
"description": "Message text. When blocks are provided, used as notification/accessibility fallback and editable draft in modal.",
"minLength": 1
},
"blocks": {
"type": "array",
"maxItems": 50,
"items": {
"anyOf": [
{
"type": "object",
"description": "Interactive elements group.",
"properties": {
"type": {
"type": "string",
"const": "actions"
},
"elements": {
"type": "array",
"maxItems": 25,
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Contextual info with text and images.",
"properties": {
"type": {
"type": "string",
"const": "context"
},
"elements": {
"type": "array",
"maxItems": 10,
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "mrkdwn"
},
"text": {
"type": "string",
"description": "Markdown-formatted text content.",
"maxLength": 3000
},
"verbatim": {
"type": "boolean",
"description": "When true, URLs and channel references are not auto-linked."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "image"
},
"image_url": {
"type": "string",
"description": "Publicly hosted image URL."
},
"alt_text": {
"type": "string",
"description": "Alt text for accessibility."
}
},
"required": [
"type",
"image_url",
"alt_text"
],
"additionalProperties": true
}
]
}
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Feedback buttons and icon buttons.",
"properties": {
"type": {
"type": "string",
"const": "context_actions"
},
"elements": {
"type": "array",
"maxItems": 5,
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Visual separator between blocks.",
"properties": {
"type": {
"type": "string",
"const": "divider"
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Displays a remote file.",
"properties": {
"type": {
"type": "string",
"const": "file"
},
"source": {
"type": "string",
"description": "Currently always \"remote\"."
},
"external_id": {
"type": "string",
"description": "External unique ID for the file."
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"source",
"external_id"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Large bold heading text.",
"properties": {
"type": {
"type": "string",
"const": "header"
},
"text": {
"type": "object"
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Displays an image.",
"properties": {
"type": {
"type": "string",
"const": "image"
},
"alt_text": {
"type": "string",
"description": "Plain text summary of the image.",
"maxLength": 2000
},
"image_url": {
"type": "string",
"description": "Public image URL.",
"maxLength": 3000
},
"slack_file": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"id": {
"type": "string"
}
},
"additionalProperties": false
},
"title": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"alt_text"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Collects user input in modals.",
"properties": {
"type": {
"type": "string",
"const": "input"
},
"label": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
"element": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
},
"hint": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
"optional": {
"type": "boolean"
},
"dispatch_action": {
"type": "boolean"
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"label",
"element"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Markdown text block for LLM responses.",
"properties": {
"type": {
"type": "string",
"const": "markdown"
},
"text": {
"type": "string",
"description": "Markdown-formatted text content.",
"maxLength": 12000
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Structured rich text with sections, lists, quotes.",
"properties": {
"type": {
"type": "string",
"const": "rich_text"
},
"elements": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "rich_text_section"
},
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "rich_text_list"
},
"style": {
"type": "string",
"enum": [
"bullet",
"ordered"
]
},
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "rich_text_section"
},
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
}
},
"indent": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"border": {
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"required": [
"type",
"style",
"elements"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "rich_text_quote"
},
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
},
"border": {
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "rich_text_preformatted"
},
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
},
"border": {
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
},
"language": {
"type": "string"
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
}
]
}
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Text block with optional fields and accessory.",
"properties": {
"type": {
"type": "string",
"const": "section"
},
"text": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "mrkdwn"
},
"text": {
"type": "string",
"description": "Markdown-formatted text content.",
"maxLength": 3000
},
"verbatim": {
"type": "boolean",
"description": "When true, URLs and channel references are not auto-linked."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
}
]
},
"fields": {
"type": "array",
"maxItems": 10,
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "mrkdwn"
},
"text": {
"type": "string",
"description": "Markdown-formatted text content.",
"maxLength": 3000
},
"verbatim": {
"type": "boolean",
"description": "When true, URLs and channel references are not auto-linked."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
}
]
}
},
"accessory": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
},
"expand": {
"type": "boolean"
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Tabular data display.",
"properties": {
"type": {
"type": "string",
"const": "table"
},
"rows": {
"type": "array",
"maxItems": 100,
"items": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
}
},
"column_settings": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"properties": {
"align": {
"type": "string",
"enum": [
"left",
"center",
"right"
]
},
"is_wrapped": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"rows"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Task card with status tracking.",
"properties": {
"type": {
"type": "string",
"const": "task_card"
},
"task_id": {
"type": "string"
},
"title": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"pending",
"in_progress",
"complete",
"error"
]
},
"details": {
"type": "object",
"additionalProperties": {}
},
"output": {
"type": "object",
"additionalProperties": {}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"task_id",
"title",
"status"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Collection of related tasks.",
"properties": {
"type": {
"type": "string",
"const": "plan"
},
"title": {
"type": "string"
},
"tasks": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"title"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Embedded video player.",
"properties": {
"type": {
"type": "string",
"const": "video"
},
"video_url": {
"type": "string",
"description": "HTTPS embeddable video URL."
},
"thumbnail_url": {
"type": "string",
"description": "Video thumbnail image URL."
},
"alt_text": {
"type": "string",
"description": "Accessibility description."
},
"title": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
"title_url": {
"type": "string"
},
"author_name": {
"type": "string",
"maxLength": 50
},
"provider_name": {
"type": "string"
},
"provider_icon_url": {
"type": "string"
},
"description": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"video_url",
"thumbnail_url",
"alt_text",
"title"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
]
}
},
"buttons": {
"type": "array",
"description": "Buttons to display in the Slack message (1–5).",
"minItems": 1,
"maxItems": 5,
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique button identifier. Returned as selected_option when clicked.",
"minLength": 1
},
"label": {
"type": "string",
"description": "Button label shown in Slack.",
"minLength": 1
},
"style": {
"type": "string",
"enum": [
"primary",
"danger"
]
},
"emit": {
"type": "object",
"description": "Arbitrary data merged into event_payload when this button is clicked.",
"additionalProperties": {}
}
},
"required": [
"id",
"label"
],
"additionalProperties": false
}
},
"allow_edit": {
"type": "boolean",
"description": "Whether to show an Edit button for draft text editing. Defaults to false."
},
"signal": {
"type": "string",
"description": "Optional signal key override. Defaults to workflow+block scoped signal.",
"minLength": 1
},
"timeout": {
"type": "string",
"description": "Signal wait timeout (for example 30m, 24h).",
"minLength": 1
},
"on_timeout": {
"type": "string",
"enum": [
"return_null",
"error"
]
},
"timeout_error": {
"type": "string",
"minLength": 1
},
"timeout_emit": {
"type": "object",
"additionalProperties": {}
},
"post_interaction": {
"type": "object",
"properties": {
"disable_buttons": {
"type": "boolean"
},
"replace_message": {
"type": "string",
"minLength": 1
},
"replace_blocks": {
"type": "array",
"maxItems": 50,
"items": {
"anyOf": [
{
"type": "object",
"description": "Interactive elements group.",
"properties": {
"type": {
"type": "string",
"const": "actions"
},
"elements": {
"type": "array",
"maxItems": 25,
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Contextual info with text and images.",
"properties": {
"type": {
"type": "string",
"const": "context"
},
"elements": {
"type": "array",
"maxItems": 10,
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "mrkdwn"
},
"text": {
"type": "string",
"description": "Markdown-formatted text content.",
"maxLength": 3000
},
"verbatim": {
"type": "boolean",
"description": "When true, URLs and channel references are not auto-linked."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "image"
},
"image_url": {
"type": "string",
"description": "Publicly hosted image URL."
},
"alt_text": {
"type": "string",
"description": "Alt text for accessibility."
}
},
"required": [
"type",
"image_url",
"alt_text"
],
"additionalProperties": true
}
]
}
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Feedback buttons and icon buttons.",
"properties": {
"type": {
"type": "string",
"const": "context_actions"
},
"elements": {
"type": "array",
"maxItems": 5,
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Visual separator between blocks.",
"properties": {
"type": {
"type": "string",
"const": "divider"
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Displays a remote file.",
"properties": {
"type": {
"type": "string",
"const": "file"
},
"source": {
"type": "string",
"description": "Currently always \"remote\"."
},
"external_id": {
"type": "string",
"description": "External unique ID for the file."
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"source",
"external_id"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Large bold heading text.",
"properties": {
"type": {
"type": "string",
"const": "header"
},
"text": {
"type": "object"
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Displays an image.",
"properties": {
"type": {
"type": "string",
"const": "image"
},
"alt_text": {
"type": "string",
"description": "Plain text summary of the image.",
"maxLength": 2000
},
"image_url": {
"type": "string",
"description": "Public image URL.",
"maxLength": 3000
},
"slack_file": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"id": {
"type": "string"
}
},
"additionalProperties": false
},
"title": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"alt_text"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Collects user input in modals.",
"properties": {
"type": {
"type": "string",
"const": "input"
},
"label": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
"element": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
},
"hint": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
"optional": {
"type": "boolean"
},
"dispatch_action": {
"type": "boolean"
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"label",
"element"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Markdown text block for LLM responses.",
"properties": {
"type": {
"type": "string",
"const": "markdown"
},
"text": {
"type": "string",
"description": "Markdown-formatted text content.",
"maxLength": 12000
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Structured rich text with sections, lists, quotes.",
"properties": {
"type": {
"type": "string",
"const": "rich_text"
},
"elements": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "rich_text_section"
},
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "rich_text_list"
},
"style": {
"type": "string",
"enum": [
"bullet",
"ordered"
]
},
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "rich_text_section"
},
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
}
},
"indent": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"border": {
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"required": [
"type",
"style",
"elements"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "rich_text_quote"
},
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
},
"border": {
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "rich_text_preformatted"
},
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
},
"border": {
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
},
"language": {
"type": "string"
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
}
]
}
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"elements"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Text block with optional fields and accessory.",
"properties": {
"type": {
"type": "string",
"const": "section"
},
"text": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "mrkdwn"
},
"text": {
"type": "string",
"description": "Markdown-formatted text content.",
"maxLength": 3000
},
"verbatim": {
"type": "boolean",
"description": "When true, URLs and channel references are not auto-linked."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
}
]
},
"fields": {
"type": "array",
"maxItems": 10,
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "mrkdwn"
},
"text": {
"type": "string",
"description": "Markdown-formatted text content.",
"maxLength": 3000
},
"verbatim": {
"type": "boolean",
"description": "When true, URLs and channel references are not auto-linked."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
}
]
}
},
"accessory": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
},
"expand": {
"type": "boolean"
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Tabular data display.",
"properties": {
"type": {
"type": "string",
"const": "table"
},
"rows": {
"type": "array",
"maxItems": 100,
"items": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
}
},
"column_settings": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"properties": {
"align": {
"type": "string",
"enum": [
"left",
"center",
"right"
]
},
"is_wrapped": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"rows"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Task card with status tracking.",
"properties": {
"type": {
"type": "string",
"const": "task_card"
},
"task_id": {
"type": "string"
},
"title": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"pending",
"in_progress",
"complete",
"error"
]
},
"details": {
"type": "object",
"additionalProperties": {}
},
"output": {
"type": "object",
"additionalProperties": {}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"task_id",
"title",
"status"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Collection of related tasks.",
"properties": {
"type": {
"type": "string",
"const": "plan"
},
"title": {
"type": "string"
},
"tasks": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"title"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Embedded video player.",
"properties": {
"type": {
"type": "string",
"const": "video"
},
"video_url": {
"type": "string",
"description": "HTTPS embeddable video URL."
},
"thumbnail_url": {
"type": "string",
"description": "Video thumbnail image URL."
},
"alt_text": {
"type": "string",
"description": "Accessibility description."
},
"title": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
"title_url": {
"type": "string"
},
"author_name": {
"type": "string",
"maxLength": 50
},
"provider_name": {
"type": "string"
},
"provider_icon_url": {
"type": "string"
},
"description": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "plain_text"
},
"text": {
"type": "string",
"description": "Plain text content.",
"maxLength": 3000
},
"emoji": {
"type": "boolean",
"description": "Escape emoji into colon format."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
"block_id": {
"type": "string",
"description": "Unique identifier for this block within the message.",
"maxLength": 255
}
},
"required": [
"type",
"video_url",
"thumbnail_url",
"alt_text",
"title"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"additionalProperties": true
}
]
}
}
},
"additionalProperties": false
},
"mrkdwn": {
"type": "boolean"
}
},
"required": [
"channel",
"text",
"buttons"
],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | -------------------------------------------------------------- |
| `result.data` | `object` | Yes | | Normalized HITL decision output for downstream workflow steps. |
| `result.meta` | `record` | No | | |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"properties": {
"data": {
"type": "object",
"description": "Normalized HITL decision output for downstream workflow steps.",
"properties": {
"resumed": {
"type": "boolean"
},
"timed_out": {
"type": "boolean"
},
"signal": {
"type": "string",
"minLength": 1
},
"selected_option": {
"type": [
"string",
"null"
]
},
"final_text": {
"type": [
"string",
"null"
]
},
"edited": {
"type": "boolean"
},
"actor": {
"type": "object",
"properties": {
"slack_user_id": {
"type": [
"string",
"null"
]
},
"slack_channel_id": {
"type": [
"string",
"null"
]
}
},
"required": [
"slack_user_id",
"slack_channel_id"
],
"additionalProperties": false
},
"message_ref": {
"type": "object",
"properties": {
"channel": {
"type": "string",
"minLength": 1
},
"ts": {
"type": "string",
"minLength": 1
}
},
"required": [
"channel",
"ts"
],
"additionalProperties": false
},
"event_payload": {
"type": [
"object",
"null"
],
"additionalProperties": {}
}
},
"required": [
"resumed",
"timed_out",
"signal",
"selected_option",
"final_text",
"edited",
"actor",
"message_ref",
"event_payload"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"additionalProperties": {}
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute slack_message_with_hitl --payload '{
"channel": "string",
"text": "string",
"buttons": "array"
}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.