> 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.

# Widget

GET https://signalcore.ai/v1/channels/web/widget

What the widget reads as it loads, by the publishable key it speaks with (and from one of
its sites): the agent it talks to, and how it looks.

Reference: https://signalcore.ai/docs/referencia/canales/widget

## Authentication

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

## Response

### 200

Successful Response

- `agent_id` (string, required)
- `agent_name` (string, required)
- `appearance` (Appearance, required) — How the widget looks: each unset field keeps the widget's own default (the page's type and ink, neutral greys). Colours are `#rrggbb`; sizes are pixels within what reads well.

## Types

### Appearance

How the widget looks: each unset field keeps the widget's own default (the page's type and ink, neutral greys). Colours are `#rrggbb`; sizes are pixels within what reads well.

- `accent` (string, optional, nullable)
- `accent_fg` (string, optional, nullable)
- `font` (enum, optional, nullable)
  - Allowed values: `Inter`, `Manrope`, `DM Sans`, `Plus Jakarta Sans`, `Poppins`, `Nunito`, `Lora`, `Playfair Display`
- `radius` (integer, optional, nullable)
- `theme` (enum, optional, default: auto)
  - Allowed values: `auto`, `light`, `dark`
- `position` (enum, optional, default: right)
  - Allowed values: `right`, `left`
- `launcher_size` (integer, optional, nullable)
- `panel_width` (integer, optional, nullable)
- `panel_height` (integer, optional, nullable)
- `header` (boolean, optional, default: false)
- `css` (string, optional, nullable)

## Examples

**Response**

```json
{
  "agent_id": "agent_id",
  "agent_name": "agent_name",
  "appearance": {
    "accent": "accent",
    "accent_fg": "accent_fg",
    "font": "Inter",
    "radius": 1,
    "theme": "auto",
    "position": "right",
    "launcher_size": 1,
    "panel_width": 1,
    "panel_height": 1,
    "header": true,
    "css": "css"
  }
}
```

**SDK Code**

```python
import requests

url = "https://signalcore.ai/v1/channels/web/widget"

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

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

print(response.json())
```