docs: enterprise leads, env scoping, Go SDK, vault, capabilities, and resource-list docs#34
Merged
Merged
Conversation
Agents omitting env were silently landing resources in 'development' without knowing it. Surface the default and semantics explicitly so an agent building a production stack passes env='production' rather than leaving the dashboard column empty. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Go agents were using curl in generated code instead of the typed SDK. Surfacing the SDK in llms.txt gives LLMs an ergonomic first choice: typed structs, INSTANT_TOKEN resolution, *APIError with AgentAction. Includes CreateLead since agents hitting Enterprise limits need a type-safe way to escalate to sales without hand-rolling JSON. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…se shape Agents using the MCP tool knew to call get_capabilities before provisioning, but agents using curl had no documented REST equivalent. Adding the GET /api/v1/capabilities path + response shape means non-MCP agents can also avoid 402s by checking limits first. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Agents writing secrets without the MCP tool had no documented REST path. Adding PUT + rotate paths and explaining how vault:// URIs are resolved at pod startup prevents agents from hard-coding secrets in env_vars instead of using the encrypted vault surface. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
docs/claim.md said claiming moves resources to 'hobby by default ($9/mo)', contradicting policy + home.md/pricing.md/llms.txt: claiming gives a Free-tier account (24h TTL, same limits as anonymous), NOT an automatic paid plan. Resources keep expiring at 24h until the user upgrades. Reframed to the canonical pricing.md/llms.txt copy + the no-trial/pay-from-day-one policy. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Surface the new leads endpoint in llms.txt so agents know to call it when a user needs capacity beyond Pro (dedicated infra, SAML, compliance) rather than asking the agent to invent a path. Includes field validation rules (email required, name/company/use_case lengths, error codes). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Agents hitting the resource-count cap were retrying indefinitely or showing generic errors. Documenting the exact error code and that agent_action carries an upgrade link gives agents a clear recovery path. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Agents starting a new session had no way to discover existing resources without reprovisioning. Documenting the list endpoint with its filter params prevents duplicate provision calls and keeps agent state coherent across conversation turns. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
mastermanas805
enabled auto-merge (rebase)
July 5, 2026 13:39
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
POST /api/v1/leadsenterprise contact endpoint (field validation, error codes, MCP tool pointer)envparameter for all provisioning endpoints (default:development)get_capabilities/GET /api/v1/capabilitieswith REST path and response shapePUT+/rotate) andvault://env/KEYinjection patternagent_actionupgrade link for resource-count cap hitsGET /api/v1/resourceslist endpoint with service/env filter paramsTest plan
🤖 Generated with Claude Code