Capabilities Reference¶

The 3PI Partner API has two distinct capability layers. Both are documented below — read them in order, because they answer different questions.

Layer	Question it answers	Source of truth
API key scopes	Which Partner API endpoints can this key call?	`App\Enums\Team\TeamMemberCapability`
Agent capabilities	Which AI workflows can this key invoke through the agent runtime / MCP?	`CapabilityRegistry::bootstrapDefaults()`

A Partner API key needs the right scope to reach an endpoint, and the right agent capability to run a specific AI workflow once it's there.

Layer 1 — API key scopes¶

When you create a Partner API key, the scoped_capabilities field accepts an array of strings drawn from the TeamMemberCapability enum. If scoped_capabilities is null, the key inherits every capability assigned to the partner team member.

{
  "name": "Content service",
  "scoped_capabilities": [
    "api_access",
    "manage_content",
    "manage_seo",
    "view_usage_metrics"
  ]
}

3PI partner scopes¶

These are the scopes that 3PI partner keys typically need.

Scope	Slug	Required for	Plan
API Access	`api_access`	All Partner API calls	Accelerate+
MCP Server Access	`mcp_access`	MCP tool/resource/prompt discovery and execution	Command
Manage Partner API Keys	`manage_partner_keys`	Creating, rotating, and revoking Partner API keys	Command
View Usage Metrics	`view_usage_metrics`	`/usage`, `/billing` summary endpoints	Command
Manage Webhooks	`manage_webhooks`	Configuring webhook endpoints	Command
Sandbox Access	`sandbox_access`	Calling the sandbox environment	Command

Workload scopes¶

Add these scopes to authorize a key to act on the underlying workloads.

Scope	Slug	Required for	Plan
Manage Content	`manage_content`	Generating and editing AI content (listings, briefs, blog posts, etc.)	All
Manage SEO	`manage_seo`	SEO intelligence, LLM seeding, search optimization workflows	Accelerate+
Manage Campaigns	`manage_campaigns`	Email sequences and campaign workflows	Accelerate+
Manage Listings	`manage_listings`	Creating and editing marketplace listings	All
Publish Listings	`publish_listings`	Pushing listings to AWS / Azure / GCP marketplaces	All
Manage Cloud Connections	`manage_cloud_connections`	Configuring AWS/Azure/GCP integrations and IAM roles	Command
Manage Integrations	`manage_integrations`	Slack, HubSpot, and other application integrations	All
Manage Co-Sell Plans	`manage_cosell_plans`	Creating and managing co-sell plans	Accelerate+
Invite Partners	`invite_partners`	Sending co-sell invitations	Accelerate+
Manage Partners	`manage_partners`	Accepting/declining invitations and partner relationships	Accelerate+
Export Data	`export_data`	Exporting reports and bulk data	Command

Read-only scopes¶

Use these when a key only needs to read.

Scope	Slug	What it reads
`view_billing`	View invoices, usage reports, payment history
`view_partners`	Partner data and co-sell opportunities
`view_marketing_analytics`	Marketing analytics and reports
`view_listings`	Listing performance and metrics
`view_integrations`	Integration status and logs
`view_companies`	Company profiles
`view_analytics`	Analytics dashboards and reports
`view_audit_log`	Audit logs and security events
`view_usage_metrics`	Credit consumption and billing summaries

Default scopes for a 3PI partner role¶

When a member is granted the partner_3pi role, they receive these scopes by default:

api_access, mcp_access, manage_partner_keys, view_usage_metrics,
manage_webhooks, sandbox_access, view_companies, view_listings,
view_partners, view_analytics, manage_content, manage_listings

Override per key via scoped_capabilities to apply least-privilege.

Layer 2 — Agent capabilities¶

Once a key has api_access (and mcp_access for MCP), it can invoke AI workflows through the agent runtime. Each workflow is a discrete capability with a fixed credit cost. Capabilities are the unit of execution — the registry below is the authoritative list.

Capability slugs are also accepted in scoped_capabilities if you want to restrict a key to a specific subset of agent workflows on top of the API-level scopes.

Create — content generation¶

Capability	Slug	Credits	What it does
Generate Text Content	`generate_text`	10	Marketplace-optimized GTM content (blog posts, emails, web copy)
Generate Image	`generate_image`	20	Hero images, social graphics, marketplace assets
Generate Content Series	`generate_content_series`	30	Coordinated email sequences, social posts, blog series
Refine Content	`refine_content`	10	Iterative refinement against SEO, readability, and brand-alignment scores
Enrich Brand Voice from Website	`enrich_brand_voice`	8	Auto-extract tone, voice, and messaging by scanning a website
SEO Content Optimization	`seo_content_optimize`	12	AI rewrites with competitor keywords and search insights
Generate SEO Meta Tags	`generate_meta_tags`	5	Click-worthy titles and descriptions for SERPs
AWS Blog Co-Author	`aws_blog_co_author`	35	Bar-raiser-compliant AWS Marketplace blog drafts with co-author handoff
AI Tool Listing Card Generator	`agent_tool_card`	25	Listing cards for the AWS SaaS AI Agents & Tools category — MCP/OpenAPI-ready

Launch — campaign execution¶

Capability	Slug	Credits	What it does
Publish to Social Media	`publish_to_social_media`	0	Direct publishing to LinkedIn, X, Facebook, Instagram, TikTok
Joint GTM Campaign Planner	`joint_gtm_planner`	40	Co-branded content calendars, shared assets, dual-approval workflows

Co-Sell — partner GTM execution¶

Capability	Slug	Credits	What it does
Co-Sell Partner Discovery & Matching	`cosell_partner_matching`	20	AI-scored partner matches across ICP overlap, product fit, market alignment
ACE Opportunity Sync	`ace_opportunity_sync`	15	Generate AWS-ready ACE briefs and sync opportunities
CPPO Proposal Generator	`cppo_proposal_generator`	25	Pricing proposals, partner agreements, deal docs
Partner Relationship Intelligence	`partner_intelligence`	10	Relationship strength scores, warm intro paths, enablement briefs
Predict Co-Sell Partner Success	`predict_partner_success`	15	Success-probability scoring with ICP analysis and risk factors
Funding Application Writer	`funding_application_writer`	30	KB-grounded drafts for Innovation Sandbox, POC, ISV WMP, MDF, MAP

Learn — intelligence & attribution¶

Capability	Slug	Credits	What it does
Analyze Content	`analyze_content`	5	SEO, readability, sentiment, and brand-alignment scoring
Pipeline Influence Tracking	`deal_influence_tracking`	15	Content / UTM / engagement → pipeline and revenue attribution
LinkedIn Ad Intelligence	`linkedin_ad_intelligence`	10	Live competitor ad teardown via LinkedIn Ad Library API
Competitive Intelligence & Analysis	`competitor_analysis`	12	Competitor content tracking and counter-positioning
Marketplace Awareness Engine	`marketplace_awareness`	15	AWS Marketplace ecosystem news and co-sell signals
RSS Feed Intelligence Scorer	`rss_post_scoring`	20	Score RSS posts against brand context, KB, and ICP
Marketplace Listing Optimizer	`marketplace_listing_optimizer`	25	SEO scores, content improvements, AI visibility tracking
Marketplace Listing SEO Intelligence	`marketplace_listing_seo`	25	Mentions in ChatGPT/Claude/Perplexity + backlink analysis
SEO Intelligence	`seo_intelligence`	10	Traffic, keywords, tech stack, competitor positioning
Content Gap Analysis	`content_gap_analysis`	15	Keywords competitors rank for but you don't
Keyword Research	`keyword_research`	5	Real-time search volumes and buyer-intent signals
SEO Content Analysis	`seo_content_analysis`	8	17-factor SEO score with actionable fixes
Discover Search Questions	`discover_search_questions`	3	"People Also Ask" extraction for FAQs and content ideas
Predict Marketplace Performance	`predict_performance`	8	CTR, conversion-rate, and revenue prediction with benchmarks
Assess Launch Readiness	`assess_launch_readiness`	10	Readiness scoring across content, SEO, compliance, positioning
Content Readiness Analyzer	`content_readiness_analyzer`	10	Brand voice, KB, and market-definition completeness scoring
AWS Innovation Monitor	`aws_innovation_monitor`	15	Alerts on AWS announcements relevant to your products
Productization Recommendation Engine	`productization_recommendation`	15	SA-level recommendations for leveraging new AWS capabilities

Supporting¶

Capability	Slug	Credits	What it does
Query Knowledge Base	`query_knowledge_base`	2	Pull facts from uploaded documents into agent runs
Sync Marketplace Listings	`sync_marketplace_listings`	0	One-click import of AWS/Azure/GCP listings
Fetch External URL	`fetch_external_url`	2	Pull content from any webpage (works with slow sites like AWS Marketplace)

Scoping best practices¶

Least privilege — Only grant the scopes and capabilities each integration needs.
Separate keys per service — Your content service doesn't need co-sell scopes.
Review periodically — Audit usage by capability via the Usage & Billing by_capability breakdown.
Match plan tier — Some scopes (mcp_access, manage_partner_keys, manage_webhooks, sandbox_access) require the Command tier; others (manage_seo, manage_campaigns, api_access) require Accelerate or higher.
Start narrow, expand later — You can rotate a key with broader scopes if your integration grows.

Common scoping recipes¶

Read-only analytics service:

"scoped_capabilities": [
  "api_access",
  "view_usage_metrics",
  "view_marketing_analytics",
  "view_analytics"
]

Content generation service:

"scoped_capabilities": [
  "api_access",
  "manage_content",
  "manage_seo",
  "generate_text",
  "generate_meta_tags",
  "seo_content_optimize",
  "refine_content"
]

Co-sell automation service:

"scoped_capabilities": [
  "api_access",
  "manage_cosell_plans",
  "view_partners",
  "cosell_partner_matching",
  "ace_opportunity_sync",
  "joint_gtm_planner",
  "partner_intelligence"
]

MCP-connected agent (full read+execute):

"scoped_capabilities": [
  "api_access",
  "mcp_access",
  "manage_content",
  "view_listings",
  "view_partners",
  "view_companies"
]