Aws/support
Manage AWS Support cases across accounts. Query case details, track correspondence, create new cases, and fan-out across profiles for fleet-wide support case inventory.
Authentication
Uses the default AWS credential chain via named profiles.
Required IAM Permissions
support:DescribeCasessupport:DescribeCommunicationssupport:CreateCasesupport:AddCommunicationToCasesupport:ResolveCasesupport:DescribeSeverityLevelssupport:DescribeServicessts:GetCallerIdentity
Prerequisites
AWS Support API requires a Business or Enterprise support plan. The API is only available in us-east-1 (global endpoint).
Usage
# Create model
swamp model create @webframp/aws/support support \
--set profiles='["prod-readonly","staging-readonly"]'
# List open cases
swamp model method run support list_cases
# Get full case details with communications
swamp model method run support get_case --input displayId=178317700500245
# Create a new support case
swamp model method run support create_case \
--input subject="ECS task placement failure" \
--input serviceCode=amazon-elastic-container-service \
--input categoryCode=general-guidance \
--input severityCode=normal \
--input body="We are experiencing intermittent task placement failures..."
# Add a reply to a case
swamp model method run support add_communication \
--input caseId=case-123456 \
--input body="Here are the requested logs..."
# Resolve a case
swamp model method run support resolve_case \
--input caseId=case-123456
# Fleet-wide scan of open cases
swamp model method run support scan_accounts2026.09.15.1
Changed: Bump zod 4.4.3 → 4.6.5
2026.09.14.1
Changed: Bump @aws-sdk/* 3.1126.0 → 3.1131.0 (3 packages)
2026.09.04.1
Changed: Bump @aws-sdk/* 3.1121.0 → 3.1126.0 (3 packages)
2026.08.29.1
Changed: Bump @aws-sdk/* 3.1120.0 → 3.1121.0. Dependency-only update; no schema, API, or behavioral changes.
2026.08.28.2
Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.
Upgrade note: License text only. No API, schema, or runtime behavior changed.
2026.08.28.1
Changed: Bump @aws-sdk/* 3.1114.0 → 3.1120.0 (3 packages)
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
Resources
2026.09.04.1
Changed: Bump @aws-sdk/* 3.1121.0 → 3.1126.0 (3 packages)
2026.08.29.1
Changed: Bump @aws-sdk/* 3.1120.0 → 3.1121.0. Dependency-only update; no schema, API, or behavioral changes.
2026.08.28.2
Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.
Upgrade note: License text only. No API, schema, or runtime behavior changed.
2026.08.28.1
Changed: Bump @aws-sdk/* 3.1114.0 → 3.1120.0 (3 packages)
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.29.1
Changed: Bump @aws-sdk/* 3.1120.0 → 3.1121.0. Dependency-only update; no schema, API, or behavioral changes.
2026.08.28.2
Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.
Upgrade note: License text only. No API, schema, or runtime behavior changed.
2026.08.28.1
Changed: Bump @aws-sdk/* 3.1114.0 → 3.1120.0 (3 packages)
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.28.2
Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.
Upgrade note: License text only. No API, schema, or runtime behavior changed.
2026.08.28.1
Changed: Bump @aws-sdk/* 3.1114.0 → 3.1120.0 (3 packages)
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.28.1
Changed: Bump @aws-sdk/* 3.1114.0 → 3.1120.0 (3 packages)
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.26.1
Fixed: Added missing description field to upgrade entry for version
2026.08.24.2. The omission caused swamp extension pull to fail with a catalog
validation error ("upgrades.N.description: Invalid input: expected string,
received undefined").
2026.08.25.1
Changed: Updated labels for improved extension discoverability. Added cross-cutting category labels (security, observability, finops, infrastructure, networking, compliance, devops, ai, incident-response) where applicable.
updated labels
2026.08.24.3
Added: Output metadata attributes for observability.
durationMs: Method execution duration in milliseconds.collectedBy: Extension name that produced the data.fetchedAt: ISO 8601 timestamp when data was fetched (added to resources that previously lacked it).
2026.08.24.2
Added: Troubleshooting section documenting the support-plan requirement,
scan_accounts per-profile degrade behavior, mid-pagination data loss, the
100-case limit cap, missing list_services/list_severity_levels methods, and
the "default" profile credential chain behavior.
2026.08.21.2
Changed: AWS Support and STS API failures now surface with the operation
and identifiers involved instead of a bare SDK error. DescribeCases,
DescribeCommunications, CreateCase, AddCommunicationToCase,
ResolveCase, and GetCallerIdentity calls in list_cases, get_case,
create_case, add_communication, and resolve_case now catch failures and
rethrow with the display ID, case ID, or profile that was in flight, plus the
original error preserved as cause. Previously a throttled or
permission-denied call surfaced only the raw AWS SDK exception with no
indication of which case or profile triggered it. scan_accounts already
recorded per-profile failures and is unchanged.
2026.08.21.1
Changed: Tightened displayId, serviceCode, categoryCode, and caseId
arguments across get_case, create_case, add_communication, and
resolve_case to require non-empty strings — these are required identifiers
the Support API already rejects when empty.
2026.08.20.1
Changed: Bump @aws-sdk/* 3.1111.0 → 3.1114.0 (3 packages)
2026.08.15.1
Changed: Bump @aws-sdk/* 3.1104.0 → 3.1111.0 (3 packages)
2026.08.05.1
Changed: Bump @aws-sdk/* 3.1101.0 → 3.1104.0 (3 packages)
2026.08.02.1
Changed: Bump @aws-sdk/* 3.1096.0 → 3.1101.0 (3 packages)
2026.07.30.1
Added: New extension for AWS Support case management across accounts.
list_cases— List open (or all) support cases for a single account with bounded pagination and configurable limit.get_case— Retrieve full case details including all communications by display ID.create_case— Open a new support case (technical issue type) with subject, body, service/category codes, and severity.add_communication— Add a reply to an existing case by internal case ID.resolve_case— Close/resolve a case by internal case ID, recording the status transition.scan_accounts— Fan-out across all configured profiles for a fleet-wide view of support cases. A single unreachable account does not fail the scan.
Fleet-wide methods redact ARNs, account IDs, URLs, and hostnames from
persisted error messages. SSO login failures collapse to sso-login-required.
Prerequisite: AWS Business or Enterprise support plan. The Support API is only available in us-east-1.
2026.08.21.1
Changed: Tightened displayId, serviceCode, categoryCode, and caseId
arguments across get_case, create_case, add_communication, and
resolve_case to require non-empty strings — these are required identifiers
the Support API already rejects when empty.
2026.08.20.1
Changed: Bump @aws-sdk/* 3.1111.0 → 3.1114.0 (3 packages)
2026.08.15.1
Changed: Bump @aws-sdk/* 3.1104.0 → 3.1111.0 (3 packages)
2026.08.05.1
Changed: Bump @aws-sdk/* 3.1101.0 → 3.1104.0 (3 packages)
2026.08.02.1
Changed: Bump @aws-sdk/* 3.1096.0 → 3.1101.0 (3 packages)
2026.07.30.1
Added: New extension for AWS Support case management across accounts.
list_cases— List open (or all) support cases for a single account with bounded pagination and configurable limit.get_case— Retrieve full case details including all communications by display ID.create_case— Open a new support case (technical issue type) with subject, body, service/category codes, and severity.add_communication— Add a reply to an existing case by internal case ID.resolve_case— Close/resolve a case by internal case ID, recording the status transition.scan_accounts— Fan-out across all configured profiles for a fleet-wide view of support cases. A single unreachable account does not fail the scan.
Fleet-wide methods redact ARNs, account IDs, URLs, and hostnames from
persisted error messages. SSO login failures collapse to sso-login-required.
Prerequisite: AWS Business or Enterprise support plan. The Support API is only available in us-east-1.
2026.08.20.1
Changed: Bump @aws-sdk/* 3.1111.0 → 3.1114.0 (3 packages)
2026.08.15.1
Changed: Bump @aws-sdk/* 3.1104.0 → 3.1111.0 (3 packages)
2026.08.05.1
Changed: Bump @aws-sdk/* 3.1101.0 → 3.1104.0 (3 packages)
2026.08.02.1
Changed: Bump @aws-sdk/* 3.1096.0 → 3.1101.0 (3 packages)
2026.07.30.1
Added: New extension for AWS Support case management across accounts.
list_cases— List open (or all) support cases for a single account with bounded pagination and configurable limit.get_case— Retrieve full case details including all communications by display ID.create_case— Open a new support case (technical issue type) with subject, body, service/category codes, and severity.add_communication— Add a reply to an existing case by internal case ID.resolve_case— Close/resolve a case by internal case ID, recording the status transition.scan_accounts— Fan-out across all configured profiles for a fleet-wide view of support cases. A single unreachable account does not fail the scan.
Fleet-wide methods redact ARNs, account IDs, URLs, and hostnames from
persisted error messages. SSO login failures collapse to sso-login-required.
Prerequisite: AWS Business or Enterprise support plan. The Support API is only available in us-east-1.
2026.08.15.1
Changed: Bump @aws-sdk/* 3.1104.0 → 3.1111.0 (3 packages)
2026.08.05.1
Changed: Bump @aws-sdk/* 3.1101.0 → 3.1104.0 (3 packages)
2026.08.02.1
Changed: Bump @aws-sdk/* 3.1096.0 → 3.1101.0 (3 packages)
2026.07.30.1
Added: New extension for AWS Support case management across accounts.
list_cases— List open (or all) support cases for a single account with bounded pagination and configurable limit.get_case— Retrieve full case details including all communications by display ID.create_case— Open a new support case (technical issue type) with subject, body, service/category codes, and severity.add_communication— Add a reply to an existing case by internal case ID.resolve_case— Close/resolve a case by internal case ID, recording the status transition.scan_accounts— Fan-out across all configured profiles for a fleet-wide view of support cases. A single unreachable account does not fail the scan.
Fleet-wide methods redact ARNs, account IDs, URLs, and hostnames from
persisted error messages. SSO login failures collapse to sso-login-required.
Prerequisite: AWS Business or Enterprise support plan. The Support API is only available in us-east-1.
2026.08.05.1
Changed: Bump @aws-sdk/* 3.1101.0 → 3.1104.0 (3 packages)
2026.08.02.1
Changed: Bump @aws-sdk/* 3.1096.0 → 3.1101.0 (3 packages)
2026.07.30.1
Added: New extension for AWS Support case management across accounts.
list_cases— List open (or all) support cases for a single account with bounded pagination and configurable limit.get_case— Retrieve full case details including all communications by display ID.create_case— Open a new support case (technical issue type) with subject, body, service/category codes, and severity.add_communication— Add a reply to an existing case by internal case ID.resolve_case— Close/resolve a case by internal case ID, recording the status transition.scan_accounts— Fan-out across all configured profiles for a fleet-wide view of support cases. A single unreachable account does not fail the scan.
Fleet-wide methods redact ARNs, account IDs, URLs, and hostnames from
persisted error messages. SSO login failures collapse to sso-login-required.
Prerequisite: AWS Business or Enterprise support plan. The Support API is only available in us-east-1.
2026.08.02.1
Changed: Bump @aws-sdk/* 3.1096.0 → 3.1101.0 (3 packages)
2026.07.30.1
Added: New extension for AWS Support case management across accounts.
list_cases— List open (or all) support cases for a single account with bounded pagination and configurable limit.get_case— Retrieve full case details including all communications by display ID.create_case— Open a new support case (technical issue type) with subject, body, service/category codes, and severity.add_communication— Add a reply to an existing case by internal case ID.resolve_case— Close/resolve a case by internal case ID, recording the status transition.scan_accounts— Fan-out across all configured profiles for a fleet-wide view of support cases. A single unreachable account does not fail the scan.
Fleet-wide methods redact ARNs, account IDs, URLs, and hostnames from
persisted error messages. SSO login failures collapse to sso-login-required.
Prerequisite: AWS Business or Enterprise support plan. The Support API is only available in us-east-1.
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned