Integrations

The Integrations API allows you to manage cloud provider integrations in Firefly.

List Integrations

Get integrations by provider type

get

Retrieves all integrations for a specific cloud provider

Authorizations

JWTAuth

AuthorizationstringRequired

JWT authentication token

Path parameters

providerTypestring · enumRequired

The cloud provider type

Possible values:

Responses

200

Successfully retrieved integrations

application/json

400

Bad Request Error

application/json

401

Unauthorized Error

application/json

404

Not Found Error

application/json

500

Internal Server Error

application/json

get

/api/integrations/{providerType}

HTTPcURLJavaScriptPython

GET /v2/api/integrations/{providerType} HTTP/1.1
Host: api.firefly.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "text",
    "accountId": "text",
    "name": "text",
    "active": true,
    "lastScan": "2026-02-10T15:57:17.560Z",
    "creationDate": "2026-02-10T15:57:17.560Z",
    "accountNumber": "text",
    "projectId": "text"
  }
]

Create Integration

Create a new integration

post

Creates a new cloud integration (AWS or K8s)

Authorizations

JWTAuth

AuthorizationstringRequired

JWT authentication token

Path parameters

providerTypestring · enumRequired

The cloud provider type (aws or k8s)

Possible values:

Body

application/json

or

Responses

200

Successfully created integration

application/json

Responseone of

or

400

Bad Request Error

application/json

401

Unauthorized Error

application/json

409

Integration already exists

application/json

500

Internal Server Error

application/json

post

/api/integrations/{providerType}

HTTPcURLJavaScriptPython

POST /v2/api/integrations/{providerType} HTTP/1.1
Host: api.firefly.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "accountNumber": "text",
  "nickname": "text"
}

{
  "externalId": "text"
}

Delete Integration

Delete a K8s integration

delete

Deletes an existing K8s integration by cluster ID

Authorizations

JWTAuth

AuthorizationstringRequired

JWT authentication token

Path parameters

providerTypestring · enumRequired

The provider type (only k8s supported for delete)

Possible values:

clusterIdstringRequired

The cluster ID to delete

Responses

200

Successfully deleted integration

application/json

400

Bad Request Error

application/json

401

Unauthorized Error

application/json

404

Not Found Error

application/json

500

Internal Server Error

application/json

delete

/api/integrations/{providerType}/{clusterId}

HTTPcURLJavaScriptPython

DELETE /v2/api/integrations/{providerType}/{clusterId} HTTP/1.1
Host: api.firefly.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "clusterId": "text"
}

Get AWS External ID

Get AWS external ID

get

Retrieves the AWS external ID for the account, used in IAM role trust policies

Authorizations

JWTAuth

AuthorizationstringRequired

JWT authentication token

Responses

200

Successfully retrieved external ID

application/json

401

Unauthorized Error

application/json

500

Internal Server Error

application/json

get

/api/integrations/aws/external-id

HTTPcURLJavaScriptPython

GET /v2/api/integrations/aws/external-id HTTP/1.1
Host: api.firefly.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "externalId": "text"
}