Skip to main content
POST
/
v1
/
graph
/
discover
Auto-discover services
curl --request POST \
  --url https://api.example.com/v1/graph/discover
{
  "discovered": 123,
  "services": [
    {
      "name": "<string>",
      "type": "<string>",
      "arn": "<string>"
    }
  ]
}
Scan your AWS infrastructure to automatically discover services and populate the topology graph. Discovers ECS services, EC2 instances, RDS databases, and other resources.

​
Authentication

Requires a valid JWT token with admin role. 
Authorization: Bearer <your-jwt-token>
This endpoint requires AWS credentials configured in your tenant settings (awsRoleArn, awsExternalId, awsRegion). See Update tenant to configure AWS access.

​
Response

​
discovered
number
Total number of services discovered.
​
services
array
List of discovered services.
curl -X POST "https://api.causeflow.ai/v1/graph/discover" \
  -H "Authorization: Bearer <your-jwt-token>"

​
Example response

{
  "discovered": 12,
  "services": [
    {
      "name": "payment-service",
      "type": "ecs_service",
      "arn": "arn:aws:ecs:us-east-1:123456789:service/production/payment-service"
    },
    {
      "name": "order-db",
      "type": "rds_instance",
      "arn": "arn:aws:rds:us-east-1:123456789:db:order-db"
    }
  ]
}
Only admin role can trigger auto-discovery. The discovery process uses temporary STS credentials with read-only permissions to scan your AWS infrastructure.