Approve a budget request

Approves a pending request, optionally changing the amount (and, for a new budget,
the budget to create). Only admin / budgets_manage users, who can approve their own
requests too.

Effects

  • more_funds on a funded ("Con saldo") budget, without periods or with
    period_scope: current_period: tops the budget up from the company's free balance,
    like POST /v1/budgets/{id}/top_up. If the balance doesn't cover it, it fails like
    the top-up (budgets/insufficient_company_funds with unreserved_cents) and the
    request stays pending.
  • more_funds with period_scope: next_periods: raises the budget's
    base_amount_cents from the next renewal on. It moves no balance today, so it never
    fails for lack of funds; next_period_shortfall_cents over 0 warns that the
    company's free balance wouldn't cover renewing it with the new base today.
  • more_funds on a tracking ("Solo control") budget: raises its
    allocated_amount_cents (or its base_amount_cents with next_periods). No
    balance moves.
  • new_budget: creates the budget like POST /v1/budgets, with the request as
    default (funded, the requester as Encargado, the amount asked for) and budget
    overriding it. The request's budget_id points to it from then on.

Any failure leaves the request pending.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

The UUID of the budget request.

Body Params

Body to approve a budget request. Every field is optional: an empty body approves the
amount asked for as it was asked for. Params go at the top level, except the new
budget's overrides, nested under budget.

int64
≥ 1

The amount approved, if different from the one asked for. Must be over 0
(budget_requests/invalid_amount). For new_budget, budget.allocated_amount_cents
takes precedence when sent.

string
enum

more_funds only: overrides the one asked for. It's checked against the budget as it
is now: required if it renews, and next_periods refused if it doesn't
(budget_requests/invalid_period_scope).

Allowed:
budget
object

new_budget only: what the admin changed in the budget to create ("Editar"). It
takes the same fields as POST /v1/budgets. Anything not sent defaults to the
request: mode funded ("Con saldo"), the requester as Encargado
(manager_id), the amount asked for, and the name, periodicity and participants
asked for.

Headers
uuid
required

UUID of the company on whose behalf the request is made. Required for every Finance endpoint.
See The company-id header for details on how to obtain
a value for this header and the error responses to expect when it is missing or invalid.

Responses

401

Unauthorized - missing or invalid authentication token, or a caller without budgets_manage.

404

Request not found (or outside the caller's scope).

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json