Go SDK - Orca

The Go SDK is not yet published as a public module. It will ship as github.com/okikorg/orca-go with version tags; this page will be updated with install and usage instructions when it is released. Until then, use the TypeScript SDK (@orcapods/sdk on npm), the Python SDK (orcapods on PyPI), or call the REST API directly as shown below.

Calling the API from Go today

The full Conductor surface is a plain REST API documented in the API Reference, so the standard library is all you need. Authenticate with a bearer API key; the tenant is derived from the key.

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"os"
	"time"
)

func main() {
	client := &http.Client{Timeout: 120 * time.Second}

	req, _ := http.NewRequest("GET", "https://api.orcapods.ai/api/whoami", nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("ORCA_API_KEY"))

	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var who struct {
		TenantID string `json:"tenantId"`
		Role     string `json:"role"`
		AuthKind string `json:"authKind"`
	}
	if err := json.NewDecoder(resp.Body).Decode(&who); err != nil {
		panic(err)
	}
	fmt.Printf("tenant=%s role=%s via %s\n", who.TenantID, who.Role, who.AuthKind)
}

Streaming run events use Server-Sent Events; GET /api/runs/{id}/events with Accept: text/event-stream works with any SSE client library.

What the released SDK will include

The generated client mirrors the TypeScript and Python SDKs: typed request and response structs for every public operation, per-call request options, retries, and streaming helpers. Follow the changelog for the release announcement.

⌘I