Skip to Content
The App Store for AI Agents - Run, create, and monetize AI glyphs
API ReferenceGet Glyph Details

Get Glyph Details

Retrieve detailed information about a specific glyph.

Endpoint

GET /glyph/{identifier}

Authentication

Optional. Required for draft glyphs.

Path Parameters

ParameterTypeDescription
identifierstringGlyph slug or ID

Response

Success (200)

{ "glyph": { "id": "glyph_abc123", "slug": "token-name-generator", "name": "AI Token Name Generator", "description": "Generate creative, memorable token names for your crypto project", "longDescription": "This glyph uses advanced AI models to generate unique...", "type": "prompt", "category": "launch", "status": "published", "verified": true, "featured": false, "trending": true, "tags": ["token", "naming", "branding", "defi"], "coverImage": "https://...", "codeSnippet": "const names = await generate({theme, style})", "codeLanguage": "javascript", "version": "1.2.0", "schema": { "inputs": [ { "name": "theme", "label": "Project Theme", "type": "select", "required": true, "options": ["DeFi", "NFT", "Gaming", "Social", "Infrastructure"] }, { "name": "style", "label": "Naming Style", "type": "select", "required": true, "options": ["Professional", "Creative", "Minimalist", "Tech"] }, { "name": "keywords", "label": "Keywords", "type": "text", "required": false, "placeholder": "yield, vault, secure" } ], "outputs": { "type": "markdown" } }, "promptConfig": { "allowedModels": [ {"id": "gpt-4o-mini", "name": "GPT-4o Mini", "tier": "fast"}, {"id": "gpt-4o", "name": "GPT-4o", "tier": "balanced"}, {"id": "claude-3.5-sonnet", "name": "Claude 3.5 Sonnet", "tier": "balanced"} ], "defaultModelId": "gpt-4o", "sourcePrice": 4.99, "examples": [ { "id": "ex_001", "title": "DeFi Professional Names", "inputs": {"theme": "DeFi", "style": "Professional"}, "output": "## Token Name Suggestions\n\n1. **VaultYield**...", "model": "gpt-4o" } ] }, "pricing": { "model": "per-run", "amount": 0.05, "currency": "USDC", "estimatedCost": "~$0.02-0.10 per run" }, "stats": { "totalRuns": 1250, "totalRevenue": 62.50, "averageRating": 4.8, "totalRatings": 89, "successRate": 98.5, "averageLatency": 3500 }, "ownerId": "user_xyz", "ownerName": "TokenLabs", "ownerVerified": true, "createdAt": "2024-01-01T00:00:00Z", "updatedAt": "2024-01-15T00:00:00Z", "publishedAt": "2024-01-02T00:00:00Z" } }

Response Fields

See full schema in the response above. Key fields:

FieldTypeDescription
schemaobjectInput/output schema definition
promptConfigobjectPrompt-specific config (for prompts)
agentConfigobjectAgent-specific config (for agents)
toolConfigobjectTool-specific config (for tools)
statsobjectUsage statistics
examplesarrayPre-generated examples

Error Responses

Not Found (404)

{ "error": "Glyph not found: invalid-slug" }

Unauthorized (401)

For draft glyphs without authentication:

{ "error": "Authentication required" }

Examples

Get by Slug

curl https://api.glyphrun.com/glyph/token-name-generator

Get by ID

curl https://api.glyphrun.com/glyph/glyph_abc123

With Authentication (for drafts)

curl https://api.glyphrun.com/glyph/my-draft-glyph \ -H "Authorization: Bearer YOUR_TOKEN"

Code Examples

JavaScript

const response = await fetch('https://api.glyphrun.com/glyph/token-name-generator') const { glyph } = await response.json() console.log(glyph.name) console.log(glyph.description) console.log(glyph.schema.inputs)

Python

import requests response = requests.get('https://api.glyphrun.com/glyph/token-name-generator') glyph = response.json()['glyph'] print(glyph['name']) print(glyph['description']) for input_field in glyph['schema']['inputs']: print(f" {input_field['name']}: {input_field['type']}")

Notes

  • Public glyphs are accessible without authentication
  • Draft glyphs require owner authentication
  • Stats are updated in real-time
  • Examples are included for prompt glyphs
Last updated on: