> This page is for Referencia de la API.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://signalcore.ai/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://signalcore.ai/docs/_mcp/server.

# Render

GET https://signalcore.ai/v1/squads/{squad_id}/dashboards/{dashboard_id}/render

The dashboard's blocks as the kit draws them, filled from the rows now.

Reference: https://signalcore.ai/docs/referencia/dashboards/render

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Path parameters

- `squad_id` (string, required)
- `dashboard_id` (string, required)

## Response

### 200

Successful Response

- `id` (string, required)
- `title` (string, required)
- `blocks` (list of DashboardViewBlocksItem, required)
- `rendered_at` (datetime, required)

## Errors

### 422 Dashboards Render Request Unprocessable Entity Error

Validation Error

- `detail` (list of ValidationError, optional)

## Types

### DashboardViewBlocksItem

- `type`: `automation`
  - `agent` (string, required)
  - `name` (string, required)
- `type`: `button`
  - `label` (string, required)
  - `action` (string, optional, nullable)
  - `tone` (enum, optional, default: neutral)
    - Allowed values: `primary`, `neutral`, `danger`
  - `url` (string, optional, nullable) — An https:// address
- `type`: `card`
  - `children` (list of CardChildrenItem, required)
  - `image` (string, optional, nullable) — An https:// address
  - `subtitle` (string, optional, nullable)
  - `title` (string, optional, nullable)
- `type`: `chart`
  - `points` (list of Point, required)
  - `kind` (enum, optional, default: bar)
    - Allowed values: `bar`, `line`
- `type`: `choice`
  - `action` (string, required)
  - `options` (list of Option, required)
  - `other` (boolean, optional, default: false)
- `type`: `divider`
- `type`: `fields`
  - `items` (list of Item, required)
- `type`: `file`
  - `path` (string, required)
  - `title` (string, optional, nullable)
- `type`: `form`
  - `action` (string, required)
  - `fields` (list of FormField, required)
  - `submit` (string, optional, nullable)
- `type`: `image`
  - `alt` (string, required)
  - `url` (string, required) — An https:// address
  - `caption` (string, optional, nullable)
- `type`: `list`
  - `items` (list of Entry, required)
  - `action` (string, optional, nullable)
- `type`: `note`
  - `text` (string, required)
  - `tone` (enum, required)
    - Allowed values: `info`, `success`, `warning`, `danger`
- `type`: `stack`
  - `children` (list of StackChildrenItem, required)
  - `direction` (enum, optional, default: column)
    - Allowed values: `column`, `row`
- `type`: `stat`
  - `label` (string, required)
  - `value` (string, required)
  - `hint` (string, optional, nullable)
  - `tone` (enum, optional, nullable)
    - Allowed values: `info`, `success`, `warning`, `danger`
- `type`: `table`
  - `columns` (list of string, required)
  - `rows` (list of list of string, required)
- `type`: `text`
  - `text` (string, required)

### ValidationError

- `loc` (list of ValidationErrorLocItem, required)
- `msg` (string, required)
- `type` (string, required)
- `input` (any, optional)
- `ctx` (map from string to any, optional)

### CardChildrenItem

- `type`: `automation`
  - `agent` (string, required)
  - `name` (string, required)
- `type`: `button`
  - `label` (string, required)
  - `action` (string, optional, nullable)
  - `tone` (enum, optional, default: neutral)
    - Allowed values: `primary`, `neutral`, `danger`
  - `url` (string, optional, nullable) — An https:// address
- `type`: `card`
  - `children` (list of CardChildrenItem, required)
  - `image` (string, optional, nullable) — An https:// address
  - `subtitle` (string, optional, nullable)
  - `title` (string, optional, nullable)
- `type`: `chart`
  - `points` (list of Point, required)
  - `kind` (enum, optional, default: bar)
    - Allowed values: `bar`, `line`
- `type`: `choice`
  - `action` (string, required)
  - `options` (list of Option, required)
  - `other` (boolean, optional, default: false)
- `type`: `divider`
- `type`: `fields`
  - `items` (list of Item, required)
- `type`: `file`
  - `path` (string, required)
  - `title` (string, optional, nullable)
- `type`: `form`
  - `action` (string, required)
  - `fields` (list of FormField, required)
  - `submit` (string, optional, nullable)
- `type`: `image`
  - `alt` (string, required)
  - `url` (string, required) — An https:// address
  - `caption` (string, optional, nullable)
- `type`: `list`
  - `items` (list of Entry, required)
  - `action` (string, optional, nullable)
- `type`: `note`
  - `text` (string, required)
  - `tone` (enum, required)
    - Allowed values: `info`, `success`, `warning`, `danger`
- `type`: `stack`
  - `children` (list of StackChildrenItem, required)
  - `direction` (enum, optional, default: column)
    - Allowed values: `column`, `row`
- `type`: `stat`
  - `label` (string, required)
  - `value` (string, required)
  - `hint` (string, optional, nullable)
  - `tone` (enum, optional, nullable)
    - Allowed values: `info`, `success`, `warning`, `danger`
- `type`: `table`
  - `columns` (list of string, required)
  - `rows` (list of list of string, required)
- `type`: `text`
  - `text` (string, required)

### Point

- `label` (string, required)
- `value` (double, required)

### Option

- `id` (string, required)
- `label` (string, required)
- `hint` (string, optional, nullable)

### Item

- `label` (string, required)
- `value` (string, required)

### FormField

One thing to fill: its name (what its value comes back under), its label, its control.

- `kind` (enum, required)
  - Allowed values: `text`, `textarea`, `email`, `phone`, `url`, `number`, `date`, `time`, `datetime`, `select`, `multiselect`, `checkbox`, `range`, `rating`, `secret`, `file`
- `name` (string, required)
- `placeholder` (string, optional, nullable)
- `help` (string, optional, nullable)
- `options` (list of Option, optional, nullable)
- `min` (double, optional, nullable)
- `max` (double, optional, nullable)
- `step` (double, optional, nullable)
- `unit` (string, optional, nullable)
- `dates` (list of date, optional, nullable)
- `earliest` (date, optional, nullable)
- `latest` (date, optional, nullable)
- `times` (list of string, optional, nullable)
- `accept` (list of string, optional, nullable)
- `multiple` (boolean, optional, nullable)
- `max_mb` (double, optional, nullable)
- `label` (string, optional, nullable)
- `required` (boolean, optional, default: false)
- `value` (FormFieldValue, optional, nullable)

### Entry

- `id` (string, required)
- `title` (string, required)
- `subtitle` (string, optional, nullable)
- `meta` (string, optional, nullable)
- `image` (string, optional, nullable) — An https:// address

### StackChildrenItem

- `type`: `automation`
  - `agent` (string, required)
  - `name` (string, required)
- `type`: `button`
  - `label` (string, required)
  - `action` (string, optional, nullable)
  - `tone` (enum, optional, default: neutral)
    - Allowed values: `primary`, `neutral`, `danger`
  - `url` (string, optional, nullable) — An https:// address
- `type`: `card`
  - `children` (list of CardChildrenItem, required)
  - `image` (string, optional, nullable) — An https:// address
  - `subtitle` (string, optional, nullable)
  - `title` (string, optional, nullable)
- `type`: `chart`
  - `points` (list of Point, required)
  - `kind` (enum, optional, default: bar)
    - Allowed values: `bar`, `line`
- `type`: `choice`
  - `action` (string, required)
  - `options` (list of Option, required)
  - `other` (boolean, optional, default: false)
- `type`: `divider`
- `type`: `fields`
  - `items` (list of Item, required)
- `type`: `file`
  - `path` (string, required)
  - `title` (string, optional, nullable)
- `type`: `form`
  - `action` (string, required)
  - `fields` (list of FormField, required)
  - `submit` (string, optional, nullable)
- `type`: `image`
  - `alt` (string, required)
  - `url` (string, required) — An https:// address
  - `caption` (string, optional, nullable)
- `type`: `list`
  - `items` (list of Entry, required)
  - `action` (string, optional, nullable)
- `type`: `note`
  - `text` (string, required)
  - `tone` (enum, required)
    - Allowed values: `info`, `success`, `warning`, `danger`
- `type`: `stack`
  - `children` (list of StackChildrenItem, required)
  - `direction` (enum, optional, default: column)
    - Allowed values: `column`, `row`
- `type`: `stat`
  - `label` (string, required)
  - `value` (string, required)
  - `hint` (string, optional, nullable)
  - `tone` (enum, optional, nullable)
    - Allowed values: `info`, `success`, `warning`, `danger`
- `type`: `table`
  - `columns` (list of string, required)
  - `rows` (list of list of string, required)
- `type`: `text`
  - `text` (string, required)

### ValidationErrorLocItem

### FormFieldValue

## Examples

**Response**

```json
{
  "id": "id",
  "title": "title",
  "blocks": [
    {
      "type": "automation",
      "agent": "agent",
      "name": "name"
    }
  ],
  "rendered_at": "2024-01-15T09:30:00Z"
}
```

**SDK Code**

```python
import requests

url = "https://signalcore.ai/v1/squads/squad_id/dashboards/dashboard_id/render"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```