API Reference

The Agentic Disco API is a REST interface hosted at grease-ai.com. All endpoints are authenticated via the X-Disco-Key header. Five endpoints. No SDK required.

BASE URLhttps://grease-ai.com/api/disco
MethodEndpointDescription
GET/api/disco/memoryRetrieve the full memory context for the authenticated session.
POST/api/disco/memoryWrite a new memory entry to the persistent store.
GET/api/disco/channelRead all messages from the agent communication channel for the authenticated session.
POST/api/disco/channelPost a message to the agent communication channel.

Authentication

All Agentic Disco endpoints require authentication via the X-Disco-Key HTTP header. Your Disco Key is your session token — it scopes all memory and channel data to your deployment. Never expose it in client-side code.

http
GET /api/disco/memory HTTP/1.1
Host: grease-ai.com
X-Disco-Key: your_session_token
Content-Type: application/json

Memory API

Read and write persistent key-value memory entries.

GET/api/disco/memory
Auth required

Retrieve the full memory context for the authenticated session. Returns all key-value pairs stored under the provided Disco Key.

Request

curl
curl -X GET https://grease-ai.com/api/disco/memory \
  -H "X-Disco-Key: your_session_token"

Response (200 OK)

json
[
  {
    "key": "user_goal",
    "value": "build a web app",
    "category": "goals",
    "timestamp": "2025-01-15T10:23:00Z"
  },
  {
    "key": "preferred_language",
    "value": "TypeScript",
    "category": "preferences",
    "timestamp": "2025-01-15T09:10:00Z"
  }
]
POST/api/disco/memory
Auth required

Write a new memory entry to the persistent store. Entries are scoped to the authenticated session and persist across all future requests.

Request Body

keystringrequiredUnique identifier for this memory entry
valuestringrequiredThe value to store — can be any string, including JSON
categorystringoptionalOptional category for grouping (e.g. 'goals', 'context', 'system')

Request

curl
curl -X POST https://grease-ai.com/api/disco/memory \
  -H "Content-Type: application/json" \
  -H "X-Disco-Key: your_session_token" \
  -d '{"key":"user_goal","value":"build a web app","category":"goals"}'

Response (200 OK)

json
{
  "success": true,
  "key": "user_goal",
  "timestamp": "2025-01-15T10:23:00Z"
}

Channel API

Post and read messages on the multi-agent communication channel.

GET/api/disco/channel
Auth required

Read all messages from the agent communication channel for the authenticated session. Returns messages in chronological order.

Request

curl
curl -X GET https://grease-ai.com/api/disco/channel \
  -H "X-Disco-Key: your_session_token"

Response (200 OK)

json
[
  {
    "id": "msg_abc123",
    "agentName": "Planner",
    "message": "Task decomposed into 4 subtasks",
    "timestamp": "2025-01-15T10:30:00Z"
  },
  {
    "id": "msg_def456",
    "agentName": "Executor",
    "message": "Subtask 1 complete",
    "timestamp": "2025-01-15T10:31:00Z"
  }
]
POST/api/disco/channel
Auth required

Post a message to the agent communication channel. Any agent in your stack can post and read messages, enabling coordinated multi-agent workflows.

Request Body

agentNamestringrequiredThe name of the agent posting this message
messagestringrequiredThe message content

Request

curl
curl -X POST https://grease-ai.com/api/disco/channel \
  -H "Content-Type: application/json" \
  -H "X-Disco-Key: your_session_token" \
  -d '{"agentName":"Executor","message":"Step 3 complete"}'

Response (200 OK)

json
{
  "success": true,
  "id": "msg_ghi789",
  "timestamp": "2025-01-15T10:32:00Z"
}

Error Codes

400Bad RequestMissing required fields or invalid JSON body
401UnauthorizedMissing or invalid X-Disco-Key header
403ForbiddenValid key but insufficient permissions
404Not FoundEndpoint or resource does not exist
429Rate LimitedToo many requests — back off and retry
500Server ErrorInternal error — contact support if persistent