Skip to content
StackTaktDocs

Start Cost Sync

POST
/cost/syncs

Pull every connected account’s bill from Cost Explorer. Returns 202 with the accepted job; poll GET /cost/syncs/{id}. The pull reads live AWS and never holds the request (ADR-0012 amendment, ADR-0016).

Tenant-wide: an account-restricted operator gets the named 403 rather than silently starting a crawl across accounts they do not hold.

Parameters

Section titled “ Parameters ”
Section titled “Cookie Parameters ”
st_session
Any of:
string

Request Body required

Section titled “Request Body required ”
SyncRequest
object
tenant_id
required
Tenant Id
string format: uuid

Responses

Section titled “ Responses ”

202

Section titled “202 ”

Successful Response

SyncJobRecord
object
actor
required
Actor
string
created_at
required
Created At
string format: date-time
error
required
Any of:
string
finished_at
required
Any of:
string format: date-time
id
required
Id
string format: uuid
kind
required
Kind
string
progress
required
Progress
object
key
additional properties
any
result
required
Result
object
key
additional properties
any
started_at
required
Any of:
string format: date-time
status
required
Status
string
tenant_id
required
Tenant Id
string format: uuid
trigger
required
Trigger
string

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string