> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hellofriday.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> The Friday daemon HTTP API for managing spaces, agents, sessions, and automations.

The Friday daemon exposes an HTTP API on port 18080. You can use it to manage spaces, send prompts, trigger automations, and retrieve artifacts programmatically.

<Note>
  The interactive **Try it** panel in the API reference requires a running
  Friday daemon on your machine. All requests go to `http://localhost:18080` —
  make sure Friday Studio is running before testing endpoints.
</Note>

## Base URL

```
http://localhost:18080
```

## Quick examples

**Check if the daemon is running:**

```bash theme={null}
curl http://localhost:18080/health
```

**List all spaces:**

```bash theme={null}
curl http://localhost:18080/api/workspaces
```

**Send a prompt to a space:**

```bash theme={null}
curl -X POST http://localhost:18080/api/workspaces/{workspaceId}/chat \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "chat-001",
    "message": {
      "role": "user",
      "content": "What can you help me with?"
    }
  }'
```

**Trigger a signal:**

```bash theme={null}
curl -X POST http://localhost:18080/api/workspaces/{workspaceId}/signals/{signalId} \
  -H 'Content-Type: application/json' \
  -d '{"payload": {"key": "value"}}'
```

**List available agents:**

```bash theme={null}
curl http://localhost:18080/api/agents
```

## Endpoint groups

| Group                                                                | Description                                          |
| -------------------------------------------------------------------- | ---------------------------------------------------- |
| [Health](/api-reference/health/health-check)                         | Daemon health checks and status                      |
| [Spaces](/api-reference/spaces/list-spaces)                          | Create, list, configure, and delete spaces           |
| [Chat](/api-reference/chat/send-a-chat-message)                      | Send messages and receive streaming responses        |
| [Sessions](/api-reference/sessions/list-sessions)                    | View and manage running sessions                     |
| [Signals](/api-reference/signals/trigger-a-signal)                   | Trigger automations programmatically                 |
| [Agents](/api-reference/agents/list-agents)                          | Discover and inspect available agents                |
| [Artifacts](/api-reference/artifacts/list-artifacts)                 | Retrieve files, reports, and data produced by agents |
| [Configuration](/api-reference/configuration/get-environment-config) | Manage daemon environment variables                  |

## Streaming responses

Chat and session endpoints support Server-Sent Events (SSE) for real-time streaming. Use `curl -N` or set `Accept: text/event-stream` to receive streaming responses.