EmbodiFlowDocs
Get startedDataWorkflows and algorithmsTraining and deploymentDeveloper reference
  • Developer reference

Authentication

  • Authentication overview
  • API keys
  • Personal access tokens
  • Browser sessions

REST API

  • Using the REST API
  • All endpoints
  • Projects
    • Recordings
      • Upload
        • Episodes and versions
          • Annotation
            • Quality and tasks
              • Search
                • Workflows
                  • Algorithms
                    • Models
                      • Artifacts and export
                        • Billing and usage
                          • GET
                            List feature entitlements
                          • GET
                            List plans
                          • GET
                            List current for a subscription
                          • PATCH
                            Update a billing state
                          • GET
                            List invoice snapshots for a current
                          • POST
                            Create a invoice snapshot
                          • GET
                            List usage attestation for a current
                          • GET
                            List usage summary for a current
                          • GET
                            Usage for the current or previous UTC calendar month
                          • GET
                            List usage ledger
                          • GET
                            List usage meters
                          • GET
                            List usage summary
                          • GET
                            Team storage cap and optional money budget
                          • PUT
                            Set the team storage cap and optional money budget
                          • POST
                            Estimate time, meter units, and list price for a planned action
                        • Team and governance
                          • Account and notifications
                            • Webhook endpoints

                              Events

                              • Outbound events
                              • Signature verification

                              Tools

                              • CLI
                              • SDK
                              • MCP

                              Updates

                              • Changelog

                              © 2026 EmbodiFlow

                              llms.txtOpenAPI JSON
                              1. Developer reference
                              2. REST API
                              3. Billing and usage
                              4. Set the team storage cap and optional money budget

                              Set the team storage cap and optional money budget

                              PUT
                              /v1/usage/budget
                              curl -X PUT 'https://api.embodiflow.io/v1/usage/budget' \
                                -H 'Authorization: Bearer $EMBODIFLOW_PAT' \
                                -H 'Content-Type: application/json' \
                                -d '{
                                  "storageLimitBytes": 0,
                                  "monthlyBudgetMinor": 0,
                                  "hardStop": true
                                }'

                              Authorization

                              Send a personal access token with every request.

                              • Authorization: Bearer PAT
                              Authentication guide

                              Header parameters

                              • If-Matchstring

                                Optional precondition. A matching tag proceeds and returns the new ETag. A stale tag returns 412 PRECONDITION_FAILED with no write. Absent proceeds (opt-in this release). If-Match: * succeeds when the resource exists. Malformed values return 400 IF_MATCH_INVALID.

                              • Idempotency-Keystring

                                Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.

                              Request body

                              Content-Typeapplication/json
                              • storageLimitBytesnumber
                              • monthlyBudgetMinornumber | null
                              • hardStopboolean

                              Responses

                              Success

                              • dataobjectrequired
                                • storageobjectrequired
                                • moneyobjectrequired
                              Response example
                              {
                                "data": {
                                  "storage": {
                                    "limitBytes": 0,
                                    "ceilingBytes": 0,
                                    "usedBytes": 0,
                                    "pendingBytes": 0,
                                    "trashBytes": 0,
                                    "percent": 0,
                                    "state": "ok"
                                  },
                                  "money": {
                                    "monthlyBudgetMinor": 0,
                                    "currency": "string",
                                    "hardStop": false,
                                    "spentMinor": 0
                                  }
                                }
                              }
                              Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1
                              Previous

                              GET /usage/budget

                              Next

                              POST /usage/estimates

                              curl -X PUT 'https://api.embodiflow.io/v1/usage/budget' \
                                -H 'Authorization: Bearer $EMBODIFLOW_PAT' \
                                -H 'Content-Type: application/json' \
                                -d '{
                                  "storageLimitBytes": 0,
                                  "monthlyBudgetMinor": 0,
                                  "hardStop": true
                                }'
                              Response example
                              Status code
                              200
                              ​
                              {
                                "data": {
                                  "storage": {
                                    "limitBytes": 0,
                                    "ceilingBytes": 0,
                                    "usedBytes": 0,
                                    "pendingBytes": 0,
                                    "trashBytes": 0,
                                    "percent": 0,
                                    "state": "ok"
                                  },
                                  "money": {
                                    "monthlyBudgetMinor": 0,
                                    "currency": "string",
                                    "hardStop": false,
                                    "spentMinor": 0
                                  }
                                }
                              }