v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB
bill-approvals

Update a bill approval policy

Update an existing bill approval policy.

put/v3/bill-approvals/policies/{policyId}

Path parameters

policyIdstring required

BILL-generated ID of the approval policy. The value is in the {organization_id}-{unique_id} format.

Example:{{bill_approval_policy_id}}

Headers

sessionIdstring nullable

API session ID generated with /v3/login

Example:{{session_id}}
devKeystring nullable

Developer key generated with your BILL developer account

Example:{{developer_key}}

Request body

policyNamestring required

Bill approval policy name

approversstring[] required

List of approvers. For each approver, set the BILL-generated ID of the user. The value begins with 006.

Note: BILL requests approvals in the specified order.

Example request

{
  "policyName": "Approval policy for bills >= $1000",
  "rules": [
    {
      "key": "BILL_AMOUNT",
      "op": "gte",
      "values": [
        "1000"
      ]
    }
  ],
  "approvers": [
    "{{bill_approver_user_id}}"
  ]
}

Response

Update a bill approval policy response

idstring

BILL-generated ID of the approval policy. The value is in the {organization_id}-{unique_id} format.

policyNamestring

Bill approval policy name

statusstring

Bill approval policy status