API

API Overview

The TactasAI v1 API exposes agent interaction, run monitoring, approval, preview, tool profile, and knowledge workflows. The official Go SDK wraps these endpoints for server-side applications.

Base URL

The SDK defaults to https://api.tactas.ai. Set TACTASAI_BASE_URL or pass WithBaseURL when using another environment.

Authentication

Provide a bearer token through TACTASAI_API_KEY or WithAPIKey. Keep API keys on the server side and do not expose them in browser code.

API Areas

Agent Runs

Sessions, messages, run events, cancellations, approvals, previews, and tool profiles.

Knowledge

Sources, connector OAuth, credentials, sync jobs, documents, and search.

Request Controls

Per-request options include X-Request-ID for traceability and Idempotency-Key for safe retries on create/message requests.