API

Knowledge Search

Knowledge APIs let a workspace connect approved sources, sync documents, and search retrieved context for agent workflows.

Sources

Supported provider constants in the Go SDK include google_drive, slack, and notion. Sources can be manual or scheduled.

  • POST /v1/workspaces/{workspace_id}/knowledge/sources
  • GET /v1/workspaces/{workspace_id}/knowledge/sources
  • PATCH /v1/workspaces/{workspace_id}/knowledge/sources/{source_id}

OAuth And Sync

Connector sources use OAuth start and callback endpoints. After a source is connected, call sync to queue an ingest job and inspect ingest job status.

Search modes include keyword, vector, and hybrid. The Go SDK returns source, document, chunk, provider, title, URI, score, snippet, and update metadata.

results, err := client.SearchKnowledge(ctx, workspaceID, tactasai.SearchRequest{
    Query: "latest roadmap",
    Mode:  tactasai.SearchModeHybrid,
    Limit: 5,
})

Documents

Documents expose provider, source, external ID, URI, MIME type, content hash, checksum, size, and status. Delete documents when source material should no longer be available to retrieval.