v1

latestOpenAPI 3.0.3Apache 2.02026-07-131453851.1 MB
Expense Categories

Update Expense Category

Update Expense Category

patch/accounting/expense-categories/{id}

Path parameters

idstring required

ID of the record you are acting upon.

Query parameters

rawboolean

Include raw response. Mostly used for debugging purposes

Headers

x-apideck-consumer-idstring required

ID of the consumer which you want to get or push data from

x-apideck-app-idstring required

The ID of your Unify application

x-apideck-service-idstring

Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API.

Request body

idstring

A unique identifier for an object.

display_idstring nullable

Id to be displayed.

namestring required

The name of the expense category.

codestring nullable

The code or external identifier of the expense category.

descriptionstring nullable

The description of the expense category.

status'active' | 'inactive' nullable

The status of the expense category.

rate_requiredboolean nullable

Whether the expense category requires rate/quantity entry (e.g. mileage at $/mile).

default_ratenumber nullable

Default rate when rate_required is true (e.g. 0.67 for mileage).

custom_mappingsCustomMappings nullable

When custom mappings are configured on the resource, the result is included here.

downstream_idstring nullable

The third-party API ID of original entity

row_versionstring nullable

A binary value used to detect updates to a object and prevent data conflicts. It is incremented each time an update is made to the object.

updated_bystring nullable

The user who last updated the object.

created_bystring nullable

The user who created the object.

updated_atstring date-time nullable

The date and time when the object was last updated.

created_atstring date-time nullable

The date and time when the object was created.

Example request

{
  "id": "12345",
  "display_id": "123456",
  "name": "Travel",
  "code": "TRAVEL-001",
  "description": "Travel-related expenses including flights, hotels, and ground transportation.",
  "status": "active",
  "account": {
    "id": "123456",
    "name": "Bank account",
    "nominal_code": "N091",
    "code": "453",
    "parent_id": "123456",
    "display_id": "123456"
  },
  "offset_account": {
    "id": "123456",
    "name": "Bank account",
    "nominal_code": "N091",
    "code": "453",
    "parent_id": "123456",
    "display_id": "123456"
  },
  "tax_rate": {
    "id": "123456",
    "code": "N-T",
    "name": "GST on Purchases",
    "rate": 10
  },
  "default_rate": 0.67,
  "downstream_id": "12345",
  "row_version": "1-12345",
  "updated_by": "12345",
  "created_by": "12345",
  "updated_at": "2020-09-30T07:43:32.000Z",
  "created_at": "2020-09-30T07:43:32.000Z",
  "pass_through": [
    {
      "extend_paths": [
        {
          "path": "$.nested.property",
          "value": {
            "TaxClassificationRef": {
              "value": "EUC-99990201-V1-00020000"
            }
          }
        }
      ]
    }
  ]
}

Response

Expense Categories

status_codeinteger required

HTTP Response Status Code

statusstring required

HTTP Response Status

servicestring required

Apideck ID of service provider

resourcestring required

Unified API resource name

operationstring required

Operation performed

_rawRaw nullable

Raw response from the integration when raw=true query param is provided

Example response

{
  "status_code": 200,
  "status": "OK",
  "service": "netsuite",
  "resource": "ExpenseCategories",
  "operation": "update",
  "data": {
    "id": "12345"
  }
}