Core routes, exact shapes.

# cURL
: "${DRIFTSTACK_API_KEY:?Set DRIFTSTACK_API_KEY}"
curl --fail-with-body -X POST https://api.driftstack.dev/v1/sessions \
  -H "authorization: Bearer $DRIFTSTACK_API_KEY" \
  -H "content-type: application/json" \
  -d '{"archetype":"iphone17_ios18_7_safari26_4"}'

// TypeScript
import { Driftstack } from "@driftstack/sdk";
const apiKey = process.env.DRIFTSTACK_API_KEY;
if (!apiKey) throw new Error("DRIFTSTACK_API_KEY is required");
const client = new Driftstack({ apiKey });
const session = await client.sessions.create({
  archetype: "iphone17_ios18_7_safari26_4",
});
console.log(session.id);

# Python
import os

from driftstack import Driftstack

client = Driftstack(api_key=os.environ["DRIFTSTACK_API_KEY"])
session = client.sessions.create({"archetype": "iphone17_ios18_7_safari26_4"})
print(session.id)

// Go
package main

import (
    "context"
    "fmt"
    "log"
    "os"

    driftstack "github.com/driftstackdev/driftstack-api/packages/sdk-go"
)

func main() {
    apiKey := os.Getenv("DRIFTSTACK_API_KEY")
    if apiKey == "" { log.Fatal("DRIFTSTACK_API_KEY is required") }
    client := driftstack.New(apiKey)
    defer client.Close()
    session, err := client.Sessions.Create(context.Background(), &driftstack.CreateSessionRequest{
        Archetype: "iphone17_ios18_7_safari26_4",
    })
    if err != nil { log.Fatal(err) }
    fmt.Println(session.ID)
}

# cURL
: "${DRIFTSTACK_API_KEY:?Set DRIFTSTACK_API_KEY}"
: "${DRIFTSTACK_SESSION_ID:?Set DRIFTSTACK_SESSION_ID}"
SESSION_URL="https://api.driftstack.dev/v1/sessions/$DRIFTSTACK_SESSION_ID"
AUTH="authorization: Bearer $DRIFTSTACK_API_KEY"

curl --fail-with-body -X POST "$SESSION_URL/navigate" \
  -H "$AUTH" -H "content-type: application/json" \
  -d '{"url":"https://example.com"}'
curl --fail-with-body -X POST "$SESSION_URL/interact" \
  -H "$AUTH" -H "content-type: application/json" \
  -d '{"action":{"kind":"tap","selector":"button.cta"}}'
curl --fail-with-body -X POST "$SESSION_URL/wait" \
  -H "$AUTH" -H "content-type: application/json" \
  -d '{"condition":{"kind":"selector","selector":"main"},"timeout_ms":5000}'

// TypeScript
import { Driftstack } from "@driftstack/sdk";

const apiKey = process.env.DRIFTSTACK_API_KEY;
const sessionId = process.env.DRIFTSTACK_SESSION_ID;
if (!apiKey || !sessionId) throw new Error("Set DRIFTSTACK_API_KEY and DRIFTSTACK_SESSION_ID");
const client = new Driftstack({ apiKey });

await client.sessions.navigate(sessionId, { url: "https://example.com" });
await client.sessions.interact(sessionId, {
  action: { kind: "tap", selector: "button.cta" },
});
await client.sessions.wait(sessionId, {
  condition: { kind: "selector", selector: "main" },
  timeout_ms: 5000,
});

# Python
import os

from driftstack import Driftstack

client = Driftstack(api_key=os.environ["DRIFTSTACK_API_KEY"])
session_id = os.environ["DRIFTSTACK_SESSION_ID"]
client.sessions.navigate(session_id, {"url": "https://example.com"})
client.sessions.interact(session_id, {
    "action": {"kind": "tap", "selector": "button.cta"},
})
client.sessions.wait(session_id, {
    "condition": {"kind": "selector", "selector": "main"},
    "timeout_ms": 5000,
})

// Go
package main

import (
    "context"
    "log"
    "os"

    driftstack "github.com/driftstackdev/driftstack-api/packages/sdk-go"
)

func main() {
    apiKey, sessionID := os.Getenv("DRIFTSTACK_API_KEY"), os.Getenv("DRIFTSTACK_SESSION_ID")
    if apiKey == "" || sessionID == "" { log.Fatal("set DRIFTSTACK_API_KEY and DRIFTSTACK_SESSION_ID") }
    client := driftstack.New(apiKey)
    defer client.Close()
    ctx := context.Background()
    if _, err := client.Sessions.Navigate(ctx, sessionID, &driftstack.NavigateRequest{URL: "https://example.com"}); err != nil { log.Fatal(err) }
    if _, err := client.Sessions.Interact(ctx, sessionID, &driftstack.InteractRequest{Action: driftstack.NewTapAction("button.cta")}); err != nil { log.Fatal(err) }
    if _, err := client.Sessions.Wait(ctx, sessionID, &driftstack.WaitRequest{Condition: driftstack.NewSelectorCondition("main"), TimeoutMS: 5000}); err != nil { log.Fatal(err) }
}

# cURL
: "${DRIFTSTACK_API_KEY:?Set DRIFTSTACK_API_KEY}"
: "${DRIFTSTACK_SESSION_ID:?Set DRIFTSTACK_SESSION_ID}"
curl --fail-with-body -X POST "https://api.driftstack.dev/v1/sessions/$DRIFTSTACK_SESSION_ID/capture" \
  -H "authorization: Bearer $DRIFTSTACK_API_KEY" \
  -H "content-type: application/json" \
  -d '{"kind":"screenshot"}' \
  | jq -r .data | openssl base64 -d -A > out.png

// TypeScript
import { writeFileSync } from "node:fs";
import { Driftstack } from "@driftstack/sdk";

const apiKey = process.env.DRIFTSTACK_API_KEY;
const sessionId = process.env.DRIFTSTACK_SESSION_ID;
if (!apiKey || !sessionId) throw new Error("Set DRIFTSTACK_API_KEY and DRIFTSTACK_SESSION_ID");
const client = new Driftstack({ apiKey });
const shot = await client.sessions.capture(sessionId, {
  kind: "screenshot",
});
writeFileSync("out.png", Buffer.from(shot.data, "base64"));

# Python
import base64
import os
from pathlib import Path

from driftstack import Driftstack

client = Driftstack(api_key=os.environ["DRIFTSTACK_API_KEY"])
shot = client.sessions.capture(os.environ["DRIFTSTACK_SESSION_ID"], {"kind": "screenshot"})
Path("out.png").write_bytes(base64.b64decode(shot.data))

// Go
package main

import (
    "context"
    "encoding/base64"
    "log"
    "os"

    driftstack "github.com/driftstackdev/driftstack-api/packages/sdk-go"
)

func main() {
    apiKey, sessionID := os.Getenv("DRIFTSTACK_API_KEY"), os.Getenv("DRIFTSTACK_SESSION_ID")
    if apiKey == "" || sessionID == "" { log.Fatal("set DRIFTSTACK_API_KEY and DRIFTSTACK_SESSION_ID") }
    client := driftstack.New(apiKey)
    defer client.Close()
    shot, err := client.Sessions.Capture(context.Background(), sessionID, &driftstack.CaptureRequest{Kind: driftstack.CaptureScreenshot})
    if err != nil { log.Fatal(err) }
    data, err := base64.StdEncoding.DecodeString(shot.Data)
    if err != nil { log.Fatal(err) }
    if err := os.WriteFile("out.png", data, 0o644); err != nil { log.Fatal(err) }
}