> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracecat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AWS Boto3

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

## 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>

<ParamField path="region_name" type="string | null">
  AWS service region to use for this request. Overrides the AWS\_REGION secret for the service client.

  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>

<ParamField path="region_name" type="string | null">
  AWS service region to use for this request. Overrides the AWS\_REGION secret for the service client.

  Default: `null`.
</ParamField>