CAcardda
Budget request

Reject a budget request

Rejects a pending request with a note the requester reads (resolution_note). Only admin / budgets_manage users.

post/v1/budget_requests/{id}/reject

Request

  • Base URL
    https://api.cardda.com
  • URL
    https://api.cardda.com/v1/budget_requests/{id}/reject
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

The UUID of the budget request.

Parameters

#/paths/~1v1~1bills/get/parameters/0 (unresolved $ref)

Request body

notestring required

Why it's rejected. Required.

Example request

{
  "note": "Este mes no hay saldo libre; vuelve a pedirlo en noviembre."
}

Response

The request, rejected.

idstring uuid required
company_idstring uuid required
kind'more_funds' | 'new_budget' required
  • more_funds ("Más fondos"): more money for an existing budget (budget_id).
  • new_budget ("Presupuesto nuevo"): a budget that doesn't exist yet; approving it creates the budget and budget_id points to it from then on.
status'pending' | 'approved' | 'rejected' | 'withdrawn' | 'canceled' required
  • pending: waiting for an admin.
  • approved: an admin approved it; the money moved (or the budget was created).
  • rejected: an admin rejected it; resolution_note says why.
  • withdrawn: whoever asked withdrew it.
  • canceled: the budget closed while it was pending (resolution_note is budget_closed).
budget_idstring uuid nullable

The budget asked about (more_funds), or the one created on approval (new_budget). null for a new_budget request not approved.

requested_amount_centsinteger required

What was asked for.

approved_amount_centsinteger nullable

What the admin approved (the amount asked for unless changed). null until approved.

currencystring required
period_scope'current_period' | 'next_periods' | 'null' nullable

Only for more_funds on a recurring budget (null otherwise):

  • current_period: the money is for the period in progress.
  • next_periods: raises what each period starts with (base_amount_cents) from the next renewal on.
reasonstring

Why the requester needs it.

resolution_notestring nullable

The admin's note when rejecting it. budget_closed when it was canceled because its budget closed.

namestring nullable

Name of the budget asked for (new_budget only).

recurrence_unit'week' | 'month' | 'year' | 'null' nullable

How often the budget asked for should renew (new_budget only). null if it shouldn't.

recurrence_everyinteger nullable

How many recurrence_unit each period of the budget asked for spans (new_budget only).

participant_idsstring[]

Users the requester wants in the new budget (new_budget only; empty otherwise).

origin_channel'web' | 'whatsapp' required

Where it was asked from.

resolved_atstring date-time nullable

When it was approved, rejected, withdrawn or canceled.

created_atstring date-time required

Example response

{
  "kind": "more_funds",
  "status": "pending",
  "requested_amount_cents": 500000,
  "approved_amount_cents": 400000,
  "currency": "CLP",
  "period_scope": "current_period",
  "reason": "Viaje a la feria de Santiago",
  "name": "Eventos Q4",
  "origin_channel": "web"
}

Changes

No recorded changes to this operation across all 1 revision of this API.