get-beam-agent-graph

Fetch Beam.ai agent graphs from the API and save them as timestamped JSON files.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/beam-ai-team/beam-next-skills --skill get-beam-agent-graph
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: get-beam-agent-graph
Source: https://github.com/beam-ai-team/beam-next-skills/tree/main/skills/beam/beam-tools/get-beam-agent-graph
Command: npx skills add https://github.com/beam-ai-team/beam-next-skills --skill get-beam-agent-graph

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Fetch and save a complete Beam.ai agent graph from Beam Studio API for analysis, backup, and documentation.

Core Features & Use Cases

  • Fetches the full agent graph using Enterprise or Public API with a reliable fallback
  • Saves the graph to a timestamped JSON file under 04-workspace/beam-graphs for archival and sharing
  • Generates a meaningful filename that includes the agent name when available and handles errors gracefully

Quick Start

Retrieve the Beam.ai agent graph for a given workspace and agent by issuing a single instruction to fetch and store the JSON locally.

Frequently Asked Questions about get-beam-agent-graph

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download and save a Beam.ai agent graph as a JSON file?

Saving a Beam agent graph as JSON requires a Beam API key configured in your .env file. You also need the specific workspace and agent identifiers to fetch the corresponding nodes, edges, and metadata from the API endpoint.

Does fetching the agent graph from Beam Studio support enterprise API endpoints?

Fetching the agent graph from Beam Studio supports enterprise API endpoints with a reliable fallback to public endpoints. This ensures you can retrieve complete graph data including nodes, edges, and metadata regardless of your account tier.

What is the best way to back up Beam agent graphs for development auditing?

The best way to back up Beam agent graphs for auditing is to fetch the complete graph and save it as a timestamped JSON file. This archival method captures all nodes, edges, and metadata for documentation and development analysis.

Why does my Beam agent graph export fail or return incomplete data?

Beam agent graph exports may fail if the Beam API key is missing from the .env file or if the workspace and agent identifiers are incorrect. The tool handles errors gracefully and uses endpoint fallbacks to mitigate incomplete data retrieval.

Can I automate Beam agent graph extraction for multiple workspaces?

Automating Beam agent graph extraction is possible by issuing instructions to fetch and store the JSON locally for each workspace and agent. The tool generates meaningful filenames using the agent name and a timestamp for organized archival.