Add an AWS account
curl --request POST \
--url https://api.select.dev/v2/aws-accounts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-tenant-id: <x-tenant-id>' \
--data '
{
"name": "<string>",
"payer_account_id": "<string>",
"s3_bucket": "<string>",
"region": "<string>",
"credentials": {
"access_key_id": "<string>",
"secret_access_key": "<string>"
},
"s3_prefix": "<string>",
"sync_enabled": true
}
'import requests
url = "https://api.select.dev/v2/aws-accounts"
payload = {
"name": "<string>",
"payer_account_id": "<string>",
"s3_bucket": "<string>",
"region": "<string>",
"credentials": {
"access_key_id": "<string>",
"secret_access_key": "<string>"
},
"s3_prefix": "<string>",
"sync_enabled": True
}
headers = {
"x-tenant-id": "<x-tenant-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-tenant-id': '<x-tenant-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: '<string>',
payer_account_id: '<string>',
s3_bucket: '<string>',
region: '<string>',
credentials: {access_key_id: '<string>', secret_access_key: '<string>'},
s3_prefix: '<string>',
sync_enabled: true
})
};
fetch('https://api.select.dev/v2/aws-accounts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.select.dev/v2/aws-accounts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'payer_account_id' => '<string>',
's3_bucket' => '<string>',
'region' => '<string>',
'credentials' => [
'access_key_id' => '<string>',
'secret_access_key' => '<string>'
],
's3_prefix' => '<string>',
'sync_enabled' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"x-tenant-id: <x-tenant-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.select.dev/v2/aws-accounts"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"payer_account_id\": \"<string>\",\n \"s3_bucket\": \"<string>\",\n \"region\": \"<string>\",\n \"credentials\": {\n \"access_key_id\": \"<string>\",\n \"secret_access_key\": \"<string>\"\n },\n \"s3_prefix\": \"<string>\",\n \"sync_enabled\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-tenant-id", "<x-tenant-id>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.select.dev/v2/aws-accounts")
.header("x-tenant-id", "<x-tenant-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"payer_account_id\": \"<string>\",\n \"s3_bucket\": \"<string>\",\n \"region\": \"<string>\",\n \"credentials\": {\n \"access_key_id\": \"<string>\",\n \"secret_access_key\": \"<string>\"\n },\n \"s3_prefix\": \"<string>\",\n \"sync_enabled\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.select.dev/v2/aws-accounts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"payer_account_id\": \"<string>\",\n \"s3_bucket\": \"<string>\",\n \"region\": \"<string>\",\n \"credentials\": {\n \"access_key_id\": \"<string>\",\n \"secret_access_key\": \"<string>\"\n },\n \"s3_prefix\": \"<string>\",\n \"sync_enabled\": true\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"etag": "<string>",
"name": "<string>",
"connection_id": "<string>",
"payer_account_id": "<string>",
"s3_bucket": "<string>",
"region": "<string>",
"sync_enabled": true,
"create_time": "<string>",
"update_time": "<string>",
"s3_prefix": "<string>",
"added_by_email": "<string>",
"last_successful_sync_time": "<string>"
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}AWS Accounts
Add an AWS account
POST
/
aws-accounts
Add an AWS account
curl --request POST \
--url https://api.select.dev/v2/aws-accounts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-tenant-id: <x-tenant-id>' \
--data '
{
"name": "<string>",
"payer_account_id": "<string>",
"s3_bucket": "<string>",
"region": "<string>",
"credentials": {
"access_key_id": "<string>",
"secret_access_key": "<string>"
},
"s3_prefix": "<string>",
"sync_enabled": true
}
'import requests
url = "https://api.select.dev/v2/aws-accounts"
payload = {
"name": "<string>",
"payer_account_id": "<string>",
"s3_bucket": "<string>",
"region": "<string>",
"credentials": {
"access_key_id": "<string>",
"secret_access_key": "<string>"
},
"s3_prefix": "<string>",
"sync_enabled": True
}
headers = {
"x-tenant-id": "<x-tenant-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-tenant-id': '<x-tenant-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: '<string>',
payer_account_id: '<string>',
s3_bucket: '<string>',
region: '<string>',
credentials: {access_key_id: '<string>', secret_access_key: '<string>'},
s3_prefix: '<string>',
sync_enabled: true
})
};
fetch('https://api.select.dev/v2/aws-accounts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.select.dev/v2/aws-accounts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'payer_account_id' => '<string>',
's3_bucket' => '<string>',
'region' => '<string>',
'credentials' => [
'access_key_id' => '<string>',
'secret_access_key' => '<string>'
],
's3_prefix' => '<string>',
'sync_enabled' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"x-tenant-id: <x-tenant-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.select.dev/v2/aws-accounts"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"payer_account_id\": \"<string>\",\n \"s3_bucket\": \"<string>\",\n \"region\": \"<string>\",\n \"credentials\": {\n \"access_key_id\": \"<string>\",\n \"secret_access_key\": \"<string>\"\n },\n \"s3_prefix\": \"<string>\",\n \"sync_enabled\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-tenant-id", "<x-tenant-id>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.select.dev/v2/aws-accounts")
.header("x-tenant-id", "<x-tenant-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"payer_account_id\": \"<string>\",\n \"s3_bucket\": \"<string>\",\n \"region\": \"<string>\",\n \"credentials\": {\n \"access_key_id\": \"<string>\",\n \"secret_access_key\": \"<string>\"\n },\n \"s3_prefix\": \"<string>\",\n \"sync_enabled\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.select.dev/v2/aws-accounts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"payer_account_id\": \"<string>\",\n \"s3_bucket\": \"<string>\",\n \"region\": \"<string>\",\n \"credentials\": {\n \"access_key_id\": \"<string>\",\n \"secret_access_key\": \"<string>\"\n },\n \"s3_prefix\": \"<string>\",\n \"sync_enabled\": true\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"etag": "<string>",
"name": "<string>",
"connection_id": "<string>",
"payer_account_id": "<string>",
"s3_bucket": "<string>",
"region": "<string>",
"sync_enabled": true,
"create_time": "<string>",
"update_time": "<string>",
"s3_prefix": "<string>",
"added_by_email": "<string>",
"last_successful_sync_time": "<string>"
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}Authorizations
Organization API key (sl_…).
Headers
The organization ID the request is scoped to.
Body
application/json
An AWS payer account to add.
Display name for the account, as shown throughout SELECT.
The 12-digit AWS account id of the payer account SELECT reads spend for.
Pattern:
^\d{12}$The S3 bucket AWS delivers this payer account's Cost and Usage Report to.
Minimum string length:
1The 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+$IAM credentials that can list and read the report objects under s3_prefix. SELECT verifies them against the bucket before the account is added.
Show child attributes
Show child attributes
Path within the bucket that the report is delivered under. Null when the report is delivered at the root of the bucket.
Whether SELECT starts syncing data for this account.
Response
Successful Response
A connection to one AWS payer account.
The unique identifier of the account.
Opaque strong ETag for this account's configuration. Matches the ETag response header, and is what If-Match requires on a write. It changes whenever a configurable field on the account changes.
Display name for the account, as shown throughout SELECT.
Identifier of the underlying connection, which SELECT reports sync state and connection alerts against.
The 12-digit AWS account id of the payer account SELECT reads spend for.
The S3 bucket AWS delivers this payer account's Cost and Usage Report to.
The AWS region the bucket is in, such as us-east-1. SELECT reads the bucket through this region's S3 endpoint.
Whether SELECT is currently syncing data for this account.
When the account was added.
When the account was last changed.
Path within the bucket that the report is delivered under. Null when the report is delivered at the root of the bucket.
Email address of the person who added the account. Null when it was not added by a person.
When SELECT last completed a sync for this account. Null before the first one succeeds.