---
title: "JSON-RPC 2.0 Endpoint"
method: POST
path: "/"
tags: ["JSON-RPC"]
---

# JSON-RPC 2.0 Endpoint

`POST /`

Main JSON-RPC 2.0 endpoint for agent communication.

All requests follow JSON-RPC 2.0 format with:
- `jsonrpc`: "2.0"
- `method`: The method name (e.g., "message/send", "tasks/get")
- `params`: Method-specific parameters
- `id`: Request identifier

**Available Methods:**
- `message/send` - Send messages to agent
- `tasks/get` - Get task status
- `tasks/list` - List all tasks
- `tasks/cancel` - Cancel a task
- `tasks/feedback` - Submit feedback for a task
- `contexts/list` - List conversation contexts
- `contexts/clear` - Clear a context

## Request body

- object
  - `jsonrpc` '2.0', required
  - `method` string, required — JSON-RPC method name
  - `params` object — Method-specific parameters
  - `id` string, required — Request identifier

## Response `200`

JSON-RPC response (success or error)

- object
  - `jsonrpc` '2.0', required
  - `result` object — Result object (present on success)
  - `error` object — Error object (present on error)
    - `code` integer
    - `message` string
    - `data` object
  - `id` string, required

## Changes

- **2026-02-12** `aec28fa7bf81` — 6 breaking, 6 info
  - added the new required request property `id`
  - added the new required request property `jsonrpc`
  - added the new required request property `method`
  - removed `#/components/schemas/MessageSendRequest, #/components/schemas/TasksGetRequest, #/components/schemas/TasksListRequest, #/components/schemas/TasksCancelRequest, #/components/schemas/TasksFeedbackRequest, #/components/schemas/ContextsListRequest, #/components/schemas/ContextsClearRequest` from the request body `oneOf` list
  - …8 more

[Change history](https://skmtc.dev/getbindu/apis/bindu-agent-api/changes/post.md)

---

[API](https://skmtc.dev/getbindu/apis/bindu-agent-api.md) · [All operations](https://skmtc.dev/getbindu/apis/bindu-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getbindu/bindu-agent-api/revisions/aec28fa7bf81/schema)