API endpoint quick reference
The following public endpoints use https://api.genispace.ai/api as the base URL. Availability still depends on your Space, role, application, and deployment.
Agents
| Method | Endpoint | Purpose |
|---|---|---|
| GET / POST | /agents | List or create agents |
| GET / PUT / DELETE | /agents/{agentId} | Read, update, or delete an agent |
| POST | /agents/{agentId}/chat | Conversational Agent; LangGraph V3 when streaming |
| POST | /agents/{agentId}/execute | Structured task-agent execution |
| GET | /agents/{agentId}/mcp/tools | List MCP-backed tools available to an agent |
| POST / GET | /agents/sessions | Create or list conversation sessions |
| GET / PATCH / DELETE | /agents/sessions/{sessionId} | Read, rename, or delete a session |
| GET | /agents/sessions/{sessionId}/messages | List stored messages and execution events |
| POST | /agents/{agentId}/sessions/{sessionId}/context/status | Read context usage |
| POST | /agents/{agentId}/sessions/{sessionId}/context/compact | Compact model context |
| GET | /agents/{agentId}/sessions/{sessionId}/interactions/pending | List pending user interactions |
| POST | /agents/{agentId}/turns/{turnId}/resume | Resume a user-choice interaction as a V3 stream |
| POST | /agents/{agentId}/turns/{turnId}/cancel | Cancel an active conversational turn |
See Agent API for the stream header, events, request bodies, and interaction lifecycle.
Agent jobs
| Method | Endpoint | Purpose |
|---|---|---|
| POST | /agent-jobs | Submit a background Agent job such as AGENT_INVOKE |
| GET | /agent-jobs/{jobId} | Read phase, progress, result, or error |
| POST | /agent-jobs/{jobId}/cancel | Request cooperative cancellation |
Tasks and workflow execution
| Method | Endpoint | Purpose |
|---|---|---|
| GET / POST | /tasks | List or create tasks |
| GET / PUT / DELETE | /tasks/{taskId} | Read, update, or delete a task |
| POST | /tasks/{taskId}/execute | Start a manual execution |
| GET | /tasks/{taskId}/executions | List task executions |
| GET | /tasks/executions/{executionId} | Read execution details |
| GET | /tasks/runs/{executionId} | Read current run status |
Datasets
| Method | Endpoint | Purpose |
|---|---|---|
| GET / POST | /datasets | List or create Datasets |
| GET / DELETE | /datasets/{datasetId} | Read or delete a Dataset |
| POST | /datasets/{datasetId}/data/insert | Insert records |
| POST | /datasets/{datasetId}/data/update | Update matching records |
| POST | /datasets/{datasetId}/data/query | Typed field, ID, sort, and pagination query |
| POST | /datasets/{datasetId}/data/count | Exact record count for a valid filter |
| POST | /datasets/{datasetId}/data/delete | Delete matching records; confirmation required by clients |
| POST | /datasets/{datasetId}/data/search | Vector semantic search from text |
| POST | /datasets/{datasetId}/data/full-text-search | Full-text search |
Use Dataset Schema field names exactly. Prefer the typed ids request field for bulk ID lookups instead of hand-building filter expressions.
API keys
| Method | Endpoint | Purpose |
|---|---|---|
| GET / POST | /api-keys | List or create API keys |
| GET / PUT | /api-keys/{keyId} | Read or update key metadata |
| POST | /api-keys/{keyId}/revoke | Revoke a key |
| POST | /api-keys/validate | Validate a key |
Models relay
/models/v1/* is the OpenAI-compatible model relay and does not use the core /api prefix. For example:
POST https://api.genispace.ai/models/v1/chat/completions
POST https://api.genispace.ai/models/v1/embeddings
The Models relay is not a substitute for /api/agents/{agentId}/chat: the two APIs have different contracts and runtime behavior.
MCP
The MCP server uses Streamable HTTP at:
https://api.genispace.ai/mcp
See MCP integration.