| # AWS provider API docs |
|
|
| ## `POST /step` (CloudEnvAction) |
|
|
| The environment step endpoint expects a JSON body matching [`CloudEnvAction`](../../../models.py): |
|
|
| | Field | Description | |
| |--------|-------------| |
| | `service` | AWS service id (boto3 client name, same as IAM prefix) | |
| | `operation` | PascalCase operation name | |
| | `payload` | Boto3 request parameters for that operation | |
| | `intent` | Optional string for higher-level agent hints | |
|
|
| ## Markdown per service |
|
|
| | Service (enum / IAM prefix) | Documentation file | |
| |----------------------------|----------------------| |
| | s3 | [s3_api.md](s3_api.md) | |
| | sqs | [sqs_api.md](sqs_api.md) | |
| | sns | [sns_api.md](sns_api.md) | |
| | dynamodb | [dynamodb_api.md](dynamodb_api.md) | |
| | lambda | [lambda_api.md](lambda_api.md) | |
| | iam | [iam_api.md](iam_api.md) | |
| | sts | [sts_api.md](sts_api.md) | |
| | secretsmanager | [secretsmanager_api.md](secretsmanager_api.md) | |
| | logs (CloudWatch Logs) | [logs_api.md](logs_api.md) | |
| | events (EventBridge) | [events_api.md](events_api.md) | |
| | kinesis | [kinesis_api.md](kinesis_api.md) | |
| | cloudwatch | [cloudwatch_api.md](cloudwatch_api.md) | |
| | ssm | [ssm_api.md](ssm_api.md) | |
| | stepfunctions | [stepfunctions_api.md](stepfunctions_api.md) | |
| | firehose | [firehose_api.md](firehose_api.md) | |
| | ec2 | [ec2_api.md](ec2_api.md) | |
| | rds | [rds_api.md](rds_api.md) | |
| | elasticache | [elasticache_api.md](elasticache_api.md) | |
| | ecs | [ecs_api.md](ecs_api.md) | |
| | route53 | [route53_api.md](route53_api.md) | |
| | apigateway | [apigateway_api.md](apigateway_api.md) | |
| | apigatewayv2 | [apigatewayv2_api.md](apigatewayv2_api.md) | |
| | cognito-idp | [cognito-idp_api.md](cognito-idp_api.md) | |
| | cognito-identity | [cognito-identity_api.md](cognito-identity_api.md) | |
| | ses | [ses_api.md](ses_api.md) | |
| | sesv2 | [sesv2_api.md](sesv2_api.md) | |
| | acm | [acm_api.md](acm_api.md) | |
| | wafv2 | [wafv2_api.md](wafv2_api.md) | |
| | glue | [glue_api.md](glue_api.md) | |
| | athena | [athena_api.md](athena_api.md) | |
|
|
| ## OpenAPI 3.0 (Insomnia / Yaak) |
|
|
| Import **[openapi.yaml](openapi.yaml)**. There is a single path `POST /step`; operations are grouped by **example name** `{service}__{operation}` and **summary** `[service] Operation`, with service-level **tags** (`aws.s3`, `aws.lambda`, …) for navigation in tools that support tag metadata. |
|
|
| ## Regenerate docs |
|
|
| Canonical operation lists and explicit service classes: |
|
|
| ```bash |
| python scripts/generate_explicit_aws_services.py |
| ``` |
|
|
| Regenerate **Markdown curl examples**, **`server/actions/*`**, and **`openapi.yaml`** from `*_service.py` + botocore: |
| |
| ```bash |
| pip install boto3 pyyaml |
| python scripts/generate_aws_api_docs.py |
| ``` |
| |
| Older script **[generate_service_api_md.py](../../scripts/generate_service_api_md.py)** is superseded by `generate_aws_api_docs.py` for curl/OpenAPI/action enums. |
| |
| Operation names also appear in [operations_data.py](operations_data.py). |
| |
