AWS API
Use these operations to interact with the AWS integration in Cortex.
Required permissions
Your API key must have the Configure integrations
permission.
Operations
Authorizations
Query parameters
includeDisabledbooleanOptionalDefault:
When true, includes all AWS types supported
false
pageSizeinteger · int32RequiredDefault:
Number of results to return per page, between 1 and 1000. Default 250.
250
pageinteger · int32RequiredDefault:
Page number to return, 0-indexed. Default 0.
0
Responses
200
Successfully found AWS types
application/json
404
AWS types not found
application/json
429
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
application/problem+json
get
GET /api/v1/aws/types HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*
{
"hasMore": true,
"page": 1,
"total": 1,
"totalPages": 1,
"types": [
{
"enabled": true,
"type": "AWS::S3::Bucket"
}
]
}
Authorizations
Path parameters
accountIdstringRequired
Responses
200
Successfully found configuration
application/json
404
Configuration not found
application/json
429
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
application/problem+json
get
GET /api/v1/aws/configurations/{accountId} HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*
{
"accountId": "text",
"accountName": "text",
"role": "text"
}
Authorizations
Responses
200
Successfully found configurations
application/json
429
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
application/problem+json
get
GET /api/v1/aws/configurations HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*
{
"configurations": [
{
"accountId": "text",
"accountName": "text",
"role": "text"
}
]
}
Authorizations
Body
accountIdstringRequired
The account ID for the AWS account
rolestringRequired
The IAM role Cortex would be assuming
Responses
200
Successfully added configuration
application/json
400
Bad Request
application/json
403
Forbidden
application/json
429
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
application/problem+json
post
POST /api/v1/aws/configurations HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 34
{
"accountId": "text",
"role": "text"
}
{
"accountId": "text",
"accountName": "text",
"role": "text"
}
Authorizations
Responses
200
Successfully validated all configurations
application/json
429
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
application/problem+json
post
POST /api/v1/aws/configurations/all/validate HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*
{
"configurations": [
{
"alias": "text",
"isValid": true,
"message": "text"
}
]
}
Authorizations
Path parameters
accountIdstringRequired
Responses
200
Successfully validated configuration
application/json
404
Configuration not found
application/json
429
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
application/problem+json
post
POST /api/v1/aws/configurations/validate/{accountId} HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*
{
"alias": "text",
"isValid": true,
"message": "text"
}
Authorizations
Body
Responses
200
Successfully replaced configurations
application/json
400
Bad Request
application/json
403
Forbidden
application/json
429
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
application/problem+json
put
PUT /api/v1/aws/configurations HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 55
{
"configurations": [
{
"accountId": "text",
"role": "text"
}
]
}
{
"configurations": [
{
"accountId": "text",
"accountName": "text",
"role": "text"
}
]
}
Authorizations
Body
Responses
200
Successfully replaced AWS types
application/json
400
Bad Request
application/json
403
Forbidden
application/json
429
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
application/problem+json
put
PUT /api/v1/aws/types HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 53
{
"types": [
{
"enabled": true,
"type": "AWS::S3::Bucket"
}
]
}
{
"types": [
{
"enabled": true,
"type": "AWS::S3::Bucket"
}
]
}
Authorizations
Responses
200
Successfully deleted configurations
403
Forbidden
application/json
429
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
application/problem+json
delete
DELETE /api/v1/aws/configurations HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*
No content
Authorizations
Path parameters
accountIdstringRequired
Responses
200
Successfully deleted configuration
403
Forbidden
application/json
404
Configuration not found
application/json
429
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
application/problem+json
delete
DELETE /api/v1/aws/configurations/{accountId} HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*
No content
Last updated
Was this helpful?