---
title: "Manage Revenue"
method: POST
path: "/api/facade/manage_revenue"
tags: ["facade"]
---

# Manage Revenue

`POST /api/facade/manage_revenue`

## Request

- Base URL: `https://api.vruum.ai`
- URL: `https://api.vruum.ai/api/facade/manage_revenue`
- Auth: `HTTPBearer` (a scheme the document does not define)

Manage revenue connections and explicitly reviewed project finance facts.

Actions:
- service_margin_statement: record an explicitly reviewed finance statement
  (journey, closed period, earned-revenue/cost lines, canonical labor IDs,
  source documents, coverage, confirmation; corrections name the prior receipt).
- connect: return the Stripe App OAuth URL ({destination, livemode}).
- reconcile: enqueue an idempotent provider scan ({idempotency_key,
  object_family}).
- replay: retry one failed evidence record (id = evidence record UUID).
- decide_binding: confirm or reject one suggestion (id = binding UUID,
  payload = {decision}).
- disconnect_preview: return a short-lived nonce and exact retention impact.
- disconnect: destroy delegated credentials using that nonce
  ({preview_nonce}); historical ledger evidence is retained.

## Request body

- WriterRequest: Uniform request body for every facade writer.
  - `action` string, required: The operation to perform — see the tool description for the action vocabulary and each action's id/payload semantics.
  - `id` union: Target entity id, or an ARRAY of ids to apply the same action+payload to each (max 100; see the tool description for which entity the id names per action).
    - string
    - string[]
  - `payload` object, nullable: Action-specific fields, validated by the underlying route's own schema (a bad field 422s with that route's precise errors). See the tool description per action.
  - `items` object[], nullable: For create-like actions only: an array of per-item payloads processed in order with per-item results (max 100). Mutually exclusive with `id` and `payload`.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/vruum/apis/vruum-public-api.md) · [All operations](https://skmtc.dev/vruum/apis/vruum-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vruum/apis/vruum-public-api/revisions/b8ada111c30a?raw)