---
title: "AWS Boto3"
description: "Reference for the Tracecat AWS Boto3 integration: registered actions, required secrets, expected inputs, and example workflow usage."
---

{/* Auto-generated by scripts/generate_tool_docs.py; do not edit by hand. */}
## Call method

Action ID: `tools.aws_boto3.call_api`

Instantiate a Boto3 client and call an AWS Boto3 API method.

Reference: [https://docs.aws.amazon.com/boto3/latest/guide/clients.html](https://docs.aws.amazon.com/boto3/latest/guide/clients.html)

### Secrets

Required secrets:

- `aws`: optional values `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_SESSION_TOKEN`, `AWS_REGION`, `AWS_ROLE_ARN`, `AWS_ROLE_SESSION_NAME`.

### Input fields

<ParamField path="method_name" type="string" required>

Method name e.g. 'list_buckets', 'list_instances'

</ParamField>

<ParamField path="service_name" type="string" required>

AWS service name e.g. 's3', 'ec2', 'guardduty'.

</ParamField>

<ParamField path="endpoint_url" type="string | null">

Endpoint URL for the AWS service.

Default: `null`.

</ParamField>

<ParamField path="params" type="object | null">

Parameters for the API method.

Default: `null`.

</ParamField>

## Call paginator

Action ID: `tools.aws_boto3.call_paginated_api`

Instantiate a Boto3 paginator and call a paginated AWS API method.

Reference: [https://docs.aws.amazon.com/boto3/latest/guide/paginators.html](https://docs.aws.amazon.com/boto3/latest/guide/paginators.html)

### Secrets

Required secrets:

- `aws`: optional values `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_SESSION_TOKEN`, `AWS_REGION`, `AWS_ROLE_ARN`, `AWS_ROLE_SESSION_NAME`.

### Input fields

<ParamField path="paginator_name" type="string" required>

Paginator name e.g. 'list_objects_v2', 'describe_instances'.

</ParamField>

<ParamField path="service_name" type="string" required>

AWS service name e.g. 's3', 'ec2', 'guardduty'.

</ParamField>

<ParamField path="endpoint_url" type="string | null">

Endpoint URL for the AWS service.

Default: `null`.

</ParamField>

<ParamField path="params" type="object | null">

Parameters for the API paginator.

Default: `null`.

</ParamField>
