Floyo API - Teams

get team balance retrieve your team's current flotime and partner nodes balance use this endpoint to check remaining credits before starting runs, or to monitor usage from your application to retrieve the team balance make an authenticated get request to /team/balance the balance returned is for the team your api key belongs to response attributes attribute type description plan string the team's current plan team object the team this balance belongs to contains name , slug , and public id flotime ms number remaining flotime balance from the team's plan, in milliseconds flex flotime ms number remaining flex flotime balance (purchased flotime outside the plan allocation), in milliseconds total flotime ms number total flotime available before active runs flotime ms + flex flotime ms active running ms number flotime currently reserved by running workflows, in milliseconds available flotime ms number flotime still available to start new runs total flotime ms active running ms partner nodes usd number remaining partner nodes balance, in usd calculated at string iso8601 timestamp when this balance snapshot was calculated the team object includes attribute type description name string display name of the team slug string url slug of the team public id string public id of the team, e g , team a1b2c3d4 example request curl curl x get "https //api floyo ai/team/balance" \\ h "authorization bearer \<your api key>" \\ h "accept application/json" example responses status 200 team balance retrieved successfully { "plan" "pro", "team" { "name" "acme studio", "slug" "acme studio", "public id" "team a1b2c3d4e5f6g7h8" }, "flotime ms" 3600000, "flex flotime ms" 600000, "total flotime ms" 4200000, "active running ms" 120000, "available flotime ms" 4080000, "partner nodes usd" 25 5, "calculated at" "2026 08 05t18 00 00 000z" } status 400 invalid team context { "error" "invalid team context", "message" "a valid team must be selected to retrieve its balance " } status 500 balance unavailable { "error" "failed to fetch team balance", "message" "the team balance is currently unavailable please try again " } tips & best practices check available flotime ms before starting runs available flotime ms subtracts flotime already reserved by active runs prefer this value over total flotime ms when deciding whether your team has enough credits to start a new workflow monitor partner nodes separately partner nodes are billed in usd and tracked independently from flotime if your workflows use partner nodes, check partner nodes usd as well — a run can fail with insufficient partner nodes credits even when flotime remains balance is a point in time snapshot the response reflects the balance at calculated at active runs and new purchases can change these values quickly, so re fetch before critical batches or when handling insufficient balance errors