Skip to main content

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.

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.

Base URL

http://localhost:18080

Quick examples

Check if the daemon is running:
curl http://localhost:18080/health
List all spaces:
curl http://localhost:18080/api/workspaces
Send a prompt to a space:
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:
curl -X POST http://localhost:18080/api/workspaces/{workspaceId}/signals/{signalId} \
  -H 'Content-Type: application/json' \
  -d '{"payload": {"key": "value"}}'
List available agents:
curl http://localhost:18080/api/agents

Endpoint groups

GroupDescription
HealthDaemon health checks and status
SpacesCreate, list, configure, and delete spaces
ChatSend messages and receive streaming responses
SessionsView and manage running sessions
SignalsTrigger automations programmatically
AgentsDiscover and inspect available agents
ArtifactsRetrieve files, reports, and data produced by agents
ConfigurationManage 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.