Skip to main content
POST
Test an AWS account configuration

Authorizations

Authorization
string
header
required

Organization API key (sl_…).

Headers

x-tenant-id
string
required

The organization ID the request is scoped to.

Body

application/json

An AWS payer account to add.

name
string
required

Display name for the account, as shown throughout SELECT.

payer_account_id
string
required

The 12-digit AWS account id of the payer account SELECT reads spend for.

Pattern: ^\d{12}$
s3_bucket
string
required

The S3 bucket AWS delivers this payer account's Cost and Usage Report to.

Minimum string length: 1
region
string
required

The AWS region the bucket is in, such as us-east-1. SELECT reads the bucket through this region's S3 endpoint.

Pattern: ^[a-z][a-z0-9-]+-\d+$
credentials
AwsCredentials · object
required

IAM credentials that can list and read the report objects under s3_prefix. SELECT verifies them against the bucket before the account is added.

s3_prefix
string | null

Path within the bucket that the report is delivered under. Null when the report is delivered at the root of the bucket.

sync_enabled
boolean
default:true

Whether SELECT starts syncing data for this account.

Response

Successful Response

The result of validating an account's configuration against AWS.

success
boolean
required

Whether every applicable check passed.

checks
AwsAccountValidationCheck · object[]
required

The checks that ran, in the order they ran. Read top-down to find where setup stopped working.