API Reference
The dnawerkes REST API gives you direct programmatic access to agent execution, vector memory, and mesh orchestration. Base URL: api.dnawerkes.ai/v1
All endpoints require a bearer token. Include your API key as Authorization: Bearer <API_KEY> in every request header.
/v1/agents/runExecute a task against a specified agent configuration. Returns a result object with output, token usage, and latency.
/v1/agents/{id}/statusRetrieve the current execution status of a running or completed agent task.
/v1/memory/upsertInsert or update documents into a named vector memory index. Supports batch operations up to 512 documents.
/v1/memory/querySemantic similarity search over a named index. Returns ranked chunks with relevance scores.
/v1/memory/{index}Permanently delete a named memory index and all associated vectors.
/v1/telemetry/metricsRetrieve live performance metrics: latency percentiles, token throughput, and task success rates.
/v1/mesh/delegateRoute a subtask to a specific agent node or allow the orchestrator to select the optimal node.
/v1/mesh/topologyReturns the current agent mesh topology: active nodes, load distribution, and health status.