beam-ai-team/beam-put-payload-builder
skills/beam/beam-tools/beam-put-payload-builder/SKILL.md
Build valid PUT payloads for Beam agent graphs by transforming GET responses into Swagger-DTO-compliant format. Handles link translation (linkParamOutputId UUID → linkedOutputParamNodeId + linkedOutputParamName), field remapping, and computed field stripping. Load when user says "build put payload", "put beam graph", "rebuild graph payload", "transform graph", "put payload builder", "restore beam graph", "get to put", or needs to send a PUT to /agent-graphs/{agentId}.
development
Updated Apr 29, 2026
$ install --global
skillsauthnpx skillsauth add beam-ai-team/beam-next-skills beam-put-payload-builderInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 29, 2026, 5:57 AM314.5s4 files scanned
SKILL.md
- name:
- beam-put-payload-builder
- version:
- 1.0
- description:
- Build valid PUT payloads for Beam agent graphs by transforming GET responses
- author:
- Abdul Rafay
- category:
- integrations
- platform:
- Beam AI
- updated:
- 2026-03-15
- visibility:
- team
Beam PUT Payload Builder
Build valid PUT payloads for Beam agent graphs by transforming GET responses into Swagger-DTO-compliant format with automatic link translation.
When to Use
- Building a PUT payload from a GET graph response
- Restoring a graph from a backup JSON file
- Making structural changes to an agent graph (add/remove nodes, edges)
- Debugging link translation issues between GET and PUT formats
Core Script
scripts/build_put_payload.py — Transforms GET response into valid PUT payload.
# Dry-run: fetch graph, build payload, show summary
python3 scripts/build_put_payload.py --agent-id <UUID> --dry-run
# From saved file
python3 scripts/build_put_payload.py --from-file backup.json --output put_payload.json
# Build, send PUT, and publish (uses saveAndPublish query param)
python3 scripts/build_put_payload.py --agent-id <UUID> --publish
# From modified file with new nodes (detects new nodes, skips saveAndPublish, guides PATCH workflow)
python3 scripts/build_put_payload.py --from-file modified.json --agent-id <UUID> --publish
Requires BEAM_API_KEY and BEAM_WORKSPACE_ID in .env.
What the Script Does
- Fetches (or loads) the GET graph response
- Builds reverse lookup: output param UUID → (node ID, param name)
- Translates every linked input param from UUID-based to name-based format
- Maps field locations (prompt, model from
originalTooltotoolConfiguration) - Strips computed fields, includes all required Swagger DTO fields
- Outputs summary with link translation stats
Workflow
- GET current graph (or use backup file)
- Build PUT payload:
python3 build_put_payload.py --agent-id <UUID> --dry-run - Verify: check summary — all links should be translated (0 FAILED)
- Send PUT with
--publish: the script auto-detects the right publish strategy:
No new nodes (rebuild, restore, or node deletion)
PUT with ?saveAndPublish=true — publishes in the same request. No PATCH needed.
New nodes added
PUT saves as draft. The script prints the PATCH steps needed before publishing:
PATCH /agent-graphs/{agentId}/nodes/{nodeId}/prompt— set prompt for each new nodePATCH /agent-graphs/update-node— setpreferredModelintoolConfigurationfor each new nodePATCH /agent-graphs/{agentId}/nodes/{nodeId}/input-output-params— set params for each new nodePATCH /agent-graphs/{graphId}/publish— publish after all PATCHes
Critical Rules
- Never build PUT from GET blindly — field locations differ. Always use
build_put_payload.py. - Never send empty arrays —
inputParams: []deletes all inputs, empty edges destroy topology. - Do NOT add fallbackModels — not settable via API.
- PUT is for structure only — do NOT use PUT to update prompts, input/output params, or preferred models on existing nodes. Use PATCH endpoints for those (see
beam-agent-manager).
References
- field-mapping.md — Complete GET→PUT field mapping table, Swagger DTO required fields, link translation algorithm
- known-issues.md — PUT & GET specific behavior and limitations
Related Skills
beam-api-reader— Full Beam API endpoint reference (authentication, task creation, agent setup)beam-agent-manager— Parent skill with full API behavioral knowledge, PATCH workflows, publishing rules
Related Skills
beam-ai-team/beam-next-skills-audit
testing
VerifiedTrustedCommunity
Audit registry.yaml against disk, validate SKILL.md frontmatter, find duplicates and orphans. Load when user says 'audit skills registry', 'validate beam-next-skills', 'registry drift', 'skills catalog audit', 'check registry yaml'.
SKILL.mdUpdated Jun 4, 2026
beam-ai-team/workable-master
tools
VerifiedTrustedCommunity
All Workable ATS operations — fetch JDs, search candidates, post assessments/reviews. Load when user says "fetch JD", "search workable", "push to workable", "post review", "rate candidate", "workable", "push assessment", "list jobs", or after interview-coach completes an evaluation. Replaces workable-fetch-jd and workable-push-assessment.
SKILL.mdUpdated Jun 4, 2026
beam-ai-team/tavily-gtm-research
data-ai
VerifiedTrustedCommunity
Load when user mentions "tavily research", "market intelligence", "competitive research", "GTM research", or needs real-time market data for sales, marketing, or vertical strategy.
SKILL.mdUpdated Jun 4, 2026
beam-ai-team/slack-master
development
VerifiedTrustedCommunity
Shared resource library for Slack integration skills. DO NOT load directly - provides common references (setup, API docs, error handling, authentication) and scripts used by slack-connect and individual Slack skills.
SKILL.mdUpdated Jun 4, 2026