API Reference

Programmable Workspace

Connect your external systems to the Gridable.ai orchestration layer via our REST and GraphQL APIs.

Authentication

All API requests must be authenticated using a Bearer Token in the Authorization header. You can generate API keys in your Dashboard settings.

curl https://api.gridable.ai/v1/user \
  -H "Authorization: Bearer YOUR_API_KEY"

Endpoints

POST/v1/agents/spawn

Spawn Agent

Initialize a new autonomous agent instance on gridable.ai with specified capabilities.

modelworkspace_idcapabilities[]
GET/v1/workspace/{id}/widgets

List Widgets

Retrieve all active widgets and their current state for a specific workspace.

id
PATCH/v1/signals/{stream_id}

Broadcast Signal

Push a new data packet into a realtime signal stream for agent consumption.

stream_idpayloadpriority