This document provides the complete endpoint list and quick reference for the GeniSpace API. All endpoints are served under the /api base path (for example https://api.genispace.ai/api/agents).
Agent API
Management Endpoints
| Method | Endpoint | Description |
|---|
| GET | /api/agents | List agents (supports accessibleOnly) |
| POST | /api/agents | Create a new agent (requires name, model, systemPrompt) |
| GET | /api/agents/{id} | Get agent details |
| PUT | /api/agents/{id} | Update an agent |
| DELETE | /api/agents/{id} | Delete an agent |
| GET | /api/agents/system-agents | List built-in system agents |
When creating an agent you may restrict access with accessScope (SPACE or RESTRICTED) and, for RESTRICTED agents, an allowedUserIds[] list. See the Agent API for the full parameter reference.
Execution Endpoints
| Method | Endpoint | Description |
|---|
| POST | /api/agents/{id}/chat | Multimodal chat with SSE streaming (GeniSpace-native contents[]) |
| POST | /api/agents/{id}/execute | Structured agent execution |
Session Endpoints
| Method | Endpoint | Description |
|---|
| POST | /api/agents/sessions | Create a conversation session |
| GET | /api/agents/sessions | List conversation sessions |
| GET | /api/agents/sessions/{sessionId} | Get session details |
| DELETE | /api/agents/sessions/{sessionId} | Delete a session |
| GET | /api/agents/sessions/{sessionId}/messages | List session messages |
Memory Endpoints
| Method | Endpoint | Description |
|---|
| GET | /api/agents/{id}/memory | List agent memory entries |
| POST | /api/agents/{id}/memory | Create a memory entry |
| PUT | /api/agents/{id}/memory/{memoryId} | Update a memory entry |
| DELETE | /api/agents/{id}/memory/{memoryId} | Delete a memory entry |
| POST | /api/agents/{id}/memory/search | Search agent memory |
| DELETE | /api/agents/{id}/memory/clear | Clear agent memory |
| Method | Endpoint | Description |
|---|
| GET | /api/agents/{id}/mcp/tools | List MCP tools available to the agent |
Task API
| Method | Endpoint | Description |
|---|
| GET | /api/tasks | List tasks |
| POST | /api/tasks | Create a new task |
| GET | /api/tasks/{id} | Get task details |
| PUT | /api/tasks/{id} | Update a task |
| DELETE | /api/tasks/{id} | Delete a task |
| POST | /api/tasks/{id}/execute | Execute a task |
| GET | /api/tasks/{id}/executions | Get task execution history |
| GET | /api/tasks/executions/{executionId} | Get an execution's details |
| GET | /api/tasks/runs/{executionId} | Get an execution's run status |
Dataset API
| Method | Endpoint | Description |
|---|
| GET | /api/datasets | List datasets |
| POST | /api/datasets | Create a new dataset |
| GET | /api/datasets/{id} | Get dataset details |
| DELETE | /api/datasets/{id} | Delete a dataset |
| POST | /api/datasets/{id}/data/insert | Insert rows |
| POST | /api/datasets/{id}/data/query | Query rows with filters |
| POST | /api/datasets/{id}/data/update | Update rows |
| POST | /api/datasets/{id}/data/delete | Delete rows |
| POST | /api/datasets/{id}/data/search | Vector search |
| POST | /api/datasets/{id}/data/full-text-search | Full-text search |
API Key Management
| Method | Endpoint | Description |
|---|
| GET | /api/api-keys | List API keys |
| POST | /api/api-keys | Create a new API key |
| GET | /api/api-keys/{id} | Get API key details |
| PUT | /api/api-keys/{id} | Update an API key |
| POST | /api/api-keys/{id}/revoke | Revoke an API key |
| POST | /api/api-keys/validate | Validate an API key |
OpenAI-Compatible Relay
| Method | Endpoint | Description |
|---|
| GET | /models/v1/{path} | OpenAI-compatible GET relay |
| POST | /models/v1/{path} | OpenAI-compatible POST relay (e.g. /models/v1/chat/completions) |