Update expense

PUT

/api/expenses/{id}

const url = 'https://api.getvespy.com/api/expenses/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"amountCents":1,"category":"maintenance","categoryId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","description":"example","incurredOn":"2026-04-15","name":"example","vendorId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","vendorName":"example","workOrderId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request PUT \
  --url https://api.getvespy.com/api/expenses/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "amountCents": 1, "category": "maintenance", "categoryId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "description": "example", "incurredOn": "2026-04-15", "name": "example", "vendorId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "vendorName": "example", "workOrderId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'

Authorizations

bearerAuth

Parameters

Path Parameters

required

string format: uuid

Request Body^required

application/json

Any of:

object

amountCents

integer

>= 1

category

string

Allowed values: maintenance utility tax insurance management other

categoryId

string format: uuid

description

string

nullable >= 1 characters <= 500 characters

incurredOn

string format: date

name

string

nullable >= 1 characters <= 160 characters

vendorId

required

string format: uuid

nullable

vendorName

string

nullable >= 1 characters <= 160 characters

workOrderId

string format: uuid

nullable

Responses

200

Default Response

application/json

object

expense

required

object

amountCents

required

integer

>= 1

amountPaidCents

required

integer

category

required

string

Allowed values: maintenance utility tax insurance management other

categoryId

required

string format: uuid

nullable

createdAt

required

string format: date-time

description

required

string

nullable

required

string format: uuid

incurredOn

required

string format: date

lastPaidAt

required

string format: date-time

nullable

lease

required

object

endDate

required

string format: date

nullable

required

string format: uuid

startDate

required

string format: date

status

required

string

Allowed values: draft active terminated expired

leaseId

required

string format: uuid

nullable

name

required

string

nullable <= 160 characters

organizationId

required

string format: uuid

outstandingCents

required

integer

owner

required

object

fullName

required

string

required

string format: uuid

ownerId

required

string format: uuid

nullable

paymentStatus

required

string

Allowed values: pending partial paid

property

required

object

city

required

string

>= 1 characters <= 120 characters

required

string format: uuid

name

required

string

state

required

string

>= 2 characters <= 2 characters

propertyId

required

string format: uuid

nullable

status

required

string

Allowed values: active voided

unit

required

object

required

string format: uuid

unitNumber

required

string

nullable

unitId

required

string format: uuid

nullable

vendorId

required

string format: uuid

nullable

vendorName

required

string

nullable

workOrderId

required

string format: uuid

nullable

Example

{
  "expense": {
    "category": "maintenance",
    "lease": {
      "status": "draft"
    },
    "paymentStatus": "pending",
    "status": "active"
  }
}

400

Default Response

application/json

object

code

string

errors

Array<object>

object

code

required

string

message

required

string

path

required

string

message

required

string

Example^generated

{
  "code": "example",
  "errors": [
    {
      "code": "example",
      "message": "example",
      "path": "example"
    }
  ],
  "message": "example"
}

401

Default Response

application/json

object

code

string

errors

Array<object>

object

code

required

string

message

required

string

path

required

string

message

required

string

Example^generated

{
  "code": "example",
  "errors": [
    {
      "code": "example",
      "message": "example",
      "path": "example"
    }
  ],
  "message": "example"
}

403

Default Response

application/json

object

code

string

errors

Array<object>

object

code

required

string

message

required

string

path

required

string

message

required

string

Example^generated

{
  "code": "example",
  "errors": [
    {
      "code": "example",
      "message": "example",
      "path": "example"
    }
  ],
  "message": "example"
}

404

Default Response

application/json

object

code

string

errors

Array<object>

object

code

required

string

message

required

string

path

required

string

message

required

string

Example^generated

{
  "code": "example",
  "errors": [
    {
      "code": "example",
      "message": "example",
      "path": "example"
    }
  ],
  "message": "example"
}

409

Default Response

application/json

object

code

string

errors

Array<object>

object

code

required

string

message

required

string

path

required

string

message

required

string

Example^generated

{
  "code": "example",
  "errors": [
    {
      "code": "example",
      "message": "example",
      "path": "example"
    }
  ],
  "message": "example"
}

Update expense

Authorizations

Parameters

Path Parameters

Request Bodyrequired

Responses

200

Example

400

Examplegenerated

401

Examplegenerated

403

Examplegenerated

404

Examplegenerated

409

Examplegenerated

Request Body^required

Example^generated

Example^generated

Example^generated

Example^generated

Example^generated