Fly has a GraphQL API which is used by some of their own tools - I found it while browsing around their code on GitHub.
\nIt's very much undocumented, which means you would be very foolish to write any software against it and expect it to continue to work as Fly make changes.
\nOnly it is kind of documented, because GraphQL introspection provides decent documentation.
\n(Also it's used by example code published by Fly, so maybe it's more supported than I initially thought.)
\nThe endpoint is https://api.fly.io/graphql - you need a Authorization: Bearer xxx HTTP header to access it, where you can get the xxx token by running flyctl auth token.
Or, you can point your browser directly at https://api.fly.io/graphql - they are running a copy of GraphiQL there which provides an interactive explorer plus documentation and schema tabs.
\nAnd if you're signed in to the Fly web interface it will use your .fly.io cookies to authenticate your GraphQL requests - so no need to worry about that Authorization header.
Here's a query I used to answer the question \"what volumes do I have attached, across all of my instances?\"
\n{\n apps {\n nodes {\n name\n volumes {\n nodes {\n name\n }\n }\n }\n }\n}Here's a much more fun query:
\n{\n # Your user account:\n viewer {\n avatarUrl\n createdAt\n email\n # This returned the following for me:\n # [\"backend_wordpress\", \"response_headers_middleware\", \"firecracker\", \"dashboard_logs\"]\n featureFlags\n }\n nearestRegion {\n # This returned \"sjc\"\n code\n }\n personalOrganization {\n name\n creditBalance\n creditBalanceFormatted\n # Not sure what these are but they look interesting - I have 7\n loggedCertificates {\n totalCount\n nodes {\n cert\n id\n root\n }\n }\n isCreditCardSaved\n wireGuardPeers {\n # Returned one entry for me, with name:\n # interactive-Simons-MacBook-Pro-swillison-gmail-com-26\n # Presumably the flyctl CLI command set this up\n totalCount\n nodes {\n name\n network\n peerip\n pubkey\n region\n }\n }\n }\n}This one returns recent logs (only for the past hour / max of 50 values - those are the highest numbers that can be used for those parameters):
\n{\n apps {\n nodes {\n name\n vms {\n totalCount\n nodes {\n recentLogs(limit: 50, range: 3600) {\n id\n region\n message\n timestamp\n }\n }\n }\n }\n }\n}And another one which digs into the details of attached volumes:
\n{\n apps {\n nodes {\n name\n services {\n checks {\n httpPath\n httpMethod\n name\n }\n description\n }\n volumes {\n nodes {\n id\n name\n createdAt\n host {\n id\n }\n sizeGb\n status\n usedBytes\n region\n app {\n name\n }\n attachedAllocation {\n privateIP\n # Not sure why attachedAllocation on a volume gives app HTTP traffic logs:\n recentLogs {\n id\n message\n timestamp\n }\n canary\n events {\n message\n timestamp\n }\n }\n }\n }\n }\n }\n}