Agent API

Create and manage OpenSIN agents.

Endpoints

Create Agent

POST /v1/agents

Request:

{
  "name": "researcher",
  "model": "gpt-4",
  "system_prompt": "You are an expert researcher.",
  "temperature": 0.7,
  "max_tokens": 4000,
  "tools": ["web_search", "summarizer"]
}

Response:

{
  "id": "agent_123",
  "name": "researcher",
  "model": "gpt-4",
  "status": "active",
  "created_at": "2026-04-04T10:00:00Z"
}

List Agents

GET /v1/agents

Get Agent

GET /v1/agents/{agent_id}

Send Message

POST /v1/agents/{agent_id}/send

Request:

{
  "message": "Research AI trends for 2026",
  "stream": false,
  "max_tokens": 4000
}

Delete Agent

DELETE /v1/agents/{agent_id}

Next Steps

• Team API
• A2A Protocol