PromptHub

curl -X POST https:
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Code Reviewer",
    "content": "You are an expert code reviewer. Analyze the following code for bugs, security vulnerabilities, performance issues, and style. Provide actionable feedback with severity levels.",
    "description": "Reviews code and provides structured feedback",
    "category": "coding",
    "tags": ["code-review", "security", "best-practices"],
    "model": "gpt-4o",
    "temperature": 0.3
  }'

import Metriqual from '@metriqual/sdk';
const mql = new Metriqual({ apiKey: process.env.MQL_API_KEY! });

const prompt = await mql.promptHub.create({
  name: 'Code Reviewer',
  content: 'You are an expert code reviewer. Analyze the following code for bugs, security vulnerabilities, performance issues, and style. Provide actionable feedback with severity levels.',
  description: 'Reviews code and provides structured feedback',
  category: 'coding',
  tags: ['code-review', 'security', 'best-practices'],
  model: 'gpt-4o',
  temperature: 0.3,
});

console.log('Created:', prompt.id, prompt.name);

from metriqual import MQL

client = MQL(api_key="mql_...")

prompt = client.prompt_hub.create(
    name="Code Reviewer",
    content="You are an expert code reviewer. Analyze the following code for bugs, security vulnerabilities, performance issues, and style. Provide actionable feedback with severity levels.",
    description="Reviews code and provides structured feedback",
    category="coding",
    tags=["code-review", "security", "best-practices"],
    model="gpt-4o",
    temperature=0.3,
)

print(f"Created: {prompt['id']} — {prompt['name']}")

# Interactive mode (opens editor for content)
mql prompts create

# One-liner
mql prompts create \
  --name "Code Reviewer" \
  --content "You are an expert code reviewer..." \
  --category coding \
  --tags "code-review,security"

# From a file
mql prompts create \
  --name "Code Reviewer" \
  --file ./prompts/code-reviewer.txt

curl https://api.metriqual.com/v1/prompt-hub/prompts \
  -H "Authorization: Bearer YOUR_JWT"

const prompts = await mql.promptHub.list();

for (const p of prompts) {
  console.log(`${p.name} (${p.id}) — v${p.active_version}, ${p.visibility}`);
}

prompts = client.prompt_hub.list()

for p in prompts["prompts"]:
    print(f"{p['name']} ({p['id']}) — v{p['active_version']}, {p['visibility']}")

# List all prompts
mql prompts list

# Search prompts
mql prompts list --search "code review"

# Output as JSON for scripting
mql prompts list --json

curl https://api.metriqual.com/v1/prompt-hub/prompts/PROMPT_ID \
  -H "Authorization: Bearer YOUR_JWT"

const prompt = await mql.promptHub.get('a1b2c3d4-...');
console.log(prompt.name);
console.log(prompt.content);

prompt = client.prompt_hub.get("a1b2c3d4-...")
print(prompt["name"])
print(prompt["content"])

# Full details
mql prompts get PROMPT_ID

# Show only the prompt content (useful for piping)
mql prompts get PROMPT_ID --content

# JSON output
mql prompts get PROMPT_ID --json

curl -X PATCH https://api.metriqual.com/v1/prompt-hub/prompts/PROMPT_ID \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "You are a senior code reviewer with 15 years of experience. Focus on: 1) Security vulnerabilities, 2) Performance bottlenecks, 3) Code maintainability. Rate each issue as Critical, Warning, or Info.",
    "temperature": 0.2
  }'

const updated = await mql.promptHub.update('PROMPT_ID', {
  content: 'You are a senior code reviewer with 15 years of experience...',
  temperature: 0.2,
});

console.log('Updated at:', updated.updated_at);

updated = client.prompt_hub.update("PROMPT_ID",
    content="You are a senior code reviewer with 15 years of experience...",
    temperature=0.2,
)

print(f"Updated at: {updated['updated_at']}")

# Update specific fields
mql prompts update PROMPT_ID --name "Senior Code Reviewer"

# Update content from file
mql prompts update PROMPT_ID --file ./prompts/v2.txt

# Update multiple fields
mql prompts update PROMPT_ID \
  --name "Senior Reviewer" \
  --category coding \
  --tags "security,performance"

curl -X DELETE https://api.metriqual.com/v1/prompt-hub/prompts/PROMPT_ID \
  -H "Authorization: Bearer YOUR_JWT"

await mql.promptHub.delete('PROMPT_ID');

client.prompt_hub.delete("PROMPT_ID")

# With confirmation prompt
mql prompts delete PROMPT_ID

# Skip confirmation
mql prompts delete PROMPT_ID --yes

curl -X PATCH https://api.metriqual.com/v1/prompt-hub/prompts/PROMPT_ID \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"visibility": "team", "team_ids": ["TEAM_A", "TEAM_B"]}'

await mql.promptHub.update('PROMPT_ID', {
  visibility: 'team',
  team_ids: ['TEAM_A'],
});

await mql.promptHub.setTeams('PROMPT_ID', ['TEAM_A', 'TEAM_B']);

await mql.promptHub.update('PROMPT_ID', { visibility: 'org' });

client.prompt_hub.update("PROMPT_ID", visibility="team", team_ids=["TEAM_A"])

client.prompt_hub.set_teams("PROMPT_ID", ["TEAM_A", "TEAM_B"])

client.prompt_hub.update("PROMPT_ID", visibility="org")

# Attach a prompt to a proxy key
curl -X POST https://api.metriqual.com/v1/proxy-keys/mql_abc123/prompt-hub \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"prompt_id": "a1b2c3d4-..."}'

// Attach prompt to key
await mql.promptHub.attachToKey('PROMPT_ID', 'mql_abc123');

// Now any chat request using this key gets the prompt injected
const mqlWithKey = new Metriqual({ apiKey: 'mql_abc123' });
const res = await mqlWithKey.chat.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Review this code: ...' }]
});
// The system prompt "You are an expert code reviewer..." is
// automatically prepended — no need to include it in messages

# Attach prompt to key
client.prompt_hub.attach_to_key("PROMPT_ID", "mql_abc123")

# Now use the key — prompt is injected automatically
keyed = MQL(api_key="mql_abc123")
response = keyed.chat.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Review this code: ..."}]
)
# System prompt is injected server-side

curl https://api.metriqual.com/v1/proxy-keys/mql_abc123/prompt-hub \
  -H "Authorization: Bearer YOUR_JWT"

const keyPrompts = await mql.promptHub.listKeyPrompts('mql_abc123');

for (const p of keyPrompts) {
  console.log(`Attached: ${p.name} (${p.id})`);
}

key_prompts = client.prompt_hub.list_key_prompts("mql_abc123")

for p in key_prompts:
    print(f"Attached: {p['name']} ({p['id']})")

curl -X DELETE https://api.metriqual.com/v1/proxy-keys/mql_abc123/prompt-hub/PROMPT_ID \
  -H "Authorization: Bearer YOUR_JWT"

await mql.promptHub.detachFromKey('PROMPT_ID', 'mql_abc123');

client.prompt_hub.detach_from_key("PROMPT_ID", "mql_abc123")