Skip to main content

API Endpoint Reference

This document provides the complete endpoint list and quick reference for the GeniSpace API.

Agent API

Management Endpoints

MethodEndpointDescription
GET/v1/agentsList agents
POST/v1/agentsCreate a new agent
GET/v1/agents/{id}Get agent details
PUT/v1/agents/{id}Update an agent
DELETE/v1/agents/{id}Delete an agent

Execution Endpoints

MethodEndpointDescription
POST/v1/agents/{id}/chatOpenAI-compatible Chat API
POST/v1/agents/{id}/executeAgent Execution Protocol
GET/v1/agents/{id}/logsGet execution logs

Task API

MethodEndpointDescription
GET/v1/tasksList tasks
POST/v1/tasksCreate a new task
GET/v1/tasks/{id}Get task details
PUT/v1/tasks/{id}Update a task
DELETE/v1/tasks/{id}Delete a task
POST/v1/tasks/{id}/runExecute a task
GET/v1/tasks/{id}/runsGet task execution history

Dataset API

MethodEndpointDescription
GET/v1/datasetsList datasets
POST/v1/datasetsCreate a new dataset
GET/v1/datasets/{id}Get dataset details
PUT/v1/datasets/{id}Update a dataset
DELETE/v1/datasets/{id}Delete a dataset
POST/v1/datasets/{id}/queryQuery a dataset
POST/v1/datasets/{id}/importImport data
GET/v1/datasets/{id}/exportExport data

API Key Management

MethodEndpointDescription
GET/v1/api-keysList API keys
POST/v1/api-keysCreate a new API key
GET/v1/api-keys/{id}Get API key details
PUT/v1/api-keys/{id}Update an API key
DELETE/v1/api-keys/{id}Delete an API key
GET/v1/api-keys/{id}/usageGet API key usage statistics