from pctx0 import Pctx0Client

client = Pctx0Client(
    access_key="YOUR_ACCESS_KEY",
    workspace_id="YOUR_WORKSPACE_ID",
)

prompt = client.prompt.get_by_name("mara-guide", version="production")

import { Nctx0Client } from "@actx0/nctx0";

const client = new Nctx0Client({
  accessKey: "YOUR_ACCESS_KEY",
  workspaceId: "YOUR_WORKSPACE_ID",
});

const prompt = await client.prompt.getByName("mara-guide", { version: "production" });

package main

import (
	"context"

	"github.com/Actx0/Gctx0"
)

func main() {
	client := gctx0.NewClient(
		gctx0.WithAccessKey("YOUR_ACCESS_KEY"),
		gctx0.WithWorkspaceId("YOUR_WORKSPACE_ID"),
	)
	defer client.Close()
	ctx := context.Background()
	prompt, err := client.Prompt.GetByName(ctx, "mara-guide", "production")
	_ = prompt
	_ = err
}

curl -X GET 'https://app.actx0.com/api/v1/workspaces/<workspaceId>/promptsByName/<promptName>' \
  -H "X-Access-Key: YOUR_ACCESS_KEY" \
  -H "Accept: application/json"

# ---

# acli
export ACTX0_ACCESS_KEY="YOUR_ACCESS_KEY"
export ACTX0_WORKSPACE_ID="YOUR_WORKSPACE_ID"

acli prompt get-by-name mara-guide --version production

{
  "id": "77777777-7777-7777-7777-777777777777",
  "name": "Support system prompt",
  "handle": "support-system-prompt",
  "description": "<string>",
  "version": 1,
  "type": "text",
  "content": "You are a helpful support agent.",
  "commitHash": "a1b2c3d",
  "status": "active",
  "production": true,
  "createdAt": "2026-07-01T12:00:00Z",
  "updatedAt": "2026-07-01T12:00:00Z",
  "config": "<unknown>",
  "labels": [
    "latest"
  ],
  "commitMessage": "Initial version",
  "meta": "<string>"
}

{
  "errorMessage": "Name is required"
}

{
  "errorMessage": "Name is required"
}

{
  "errorMessage": "Name is required"
}

{
  "errorMessage": "Name is required"
}

{
  "errorMessage": "Name is required"
}