Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Access token JWT. Use as Authorization: Bearer . In the API playground, paste the JWT only.

X-Fluide-Api-Key
string
header
default:fl_dev_your_key
required

Developer API key (fl_dev_...). Required on every API call with a machine access token.

X-Fluide-Client-Id
string
header
default:fluide-developer
required

First-party client audience. Must match the fluide_client_id claim on the JWT. Use fluide-developer for Connect.

Headers

X-Workspace-Id
string<uuid>

Partner / ISV only: UUID of the workspace that owns the client company. Required together with X-Acting-Company-Id when scoping product APIs to a merchant. See /getting-started/multi-tenancy.

X-Acting-Company-Id
string<uuid>

Partner / ISV only: UUID of the client company to act on. Must belong to the workspace in X-Workspace-Id.

Path Parameters

id
string
required

Body

application/json
month
number
required

Calendar month 1–12 within the budget fiscal year

Required range: 1 <= x <= 12
actualAmount
number

Optional actual total override instead of GL rollup

Response

201 - application/json
organizationId
string
required
companyId
string
required
budgetId
string
required
periodMonth
number
required

Calendar month 1–12 within fiscal year

budgetAmount
string
required
actualAmount
string
required
varianceAmount
string
required
metadata
object
required
id
string
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
deletedAt
string<date-time>