Build a complete status-message example

This example produces a status message with a repeating task list. Use the environment matching your account, an API key with template authoring and sending scopes, and a connected test Slack workspace.

Template and test data

Use this complete body with POST /v1/templates/validate:

{
  "blocks": [
    { "type": "header", "text": { "type": "plain_text", "text": "{{project}} status" } },
    {
      "type": "directive_container",
      "directive_type": "each",
      "directive_config": { "arrayPath": "tasks", "maxBlocks": 5, "overflowText": "and {remaining} more tasks" },
      "children": [
        { "type": "section", "text": { "type": "mrkdwn", "text": "{{this.name}} — {{this.status}}" } }
      ]
    },
    { "type": "context", "elements": [{ "type": "mrkdwn", "text": "Owner: {{owner}}" }] }
  ],
  "sample_data": {
    "project": "Website",
    "owner": "Alex",
    "tasks": [
      { "name": "Review copy", "status": "Complete" },
      { "name": "Test checkout", "status": "In progress" }
    ]
  }
}

The expected text is a “Website status” header, two task Sections, and “Owner: Alex” in Context. The validator should return valid: true.

Save and send

Add "name": "Project status" to the body and create it with POST /v1/templates. Keep the returned template/version IDs and activate the version with POST /v1/templates/{id}/versions/{version_id}/activate. Follow Send with the API, using the returned template ID and this data:

{
  "project": "Website",
  "owner": "Alex",
  "tasks": [
    { "name": "Review copy", "status": "Complete" },
    { "name": "Test checkout", "status": "In progress" }
  ]
}

Choose one test destination and a stable idempotency key. Confirm the expected content in Slack and save the response’s message coordinates.

Exercise failures

Validate with tasks: []: no task Sections should appear. Validate with tasks missing or a string: the each directive should report an array-source error. Test more than five tasks and inspect the overflow output and compiled block count. To add an approval workflow, use the complete button configuration, create a real destination, and verify the receiver before treating a click as approval.

Templates

Data and reuse

Build an example

Build a complete status-message example

Template and test data

Save and send

Exercise failures

​Template and test data

​Save and send

​Exercise failures

Template and test data

Save and send

Exercise failures