Release Notes

Welcome to the Coperniq API release notes. This section highlights noteworthy changes across endpoints, schemas, and docs.

Recent highlights

  • New: AHJs — GET /ahjs (search, filter, and lat+lng geo lookup), GET /ahjs/{id}, and PATCH /ahjs/{id} to update custom property values. v2 mirrors these under /v2 with the standard success envelope.
  • Updated: GET /properties — now documents the ahj record type (custom AHJ properties only) and adds an isCustom boolean to every property to distinguish custom columns from built-in standard ones.
  • New: Sections — line items on projects, invoices, and bills can now be grouped into named sections (matching quotes and work orders); read responses expose sectionName per line item.
  • New: Vendors — full CRUD via GET/POST /vendors, GET/PATCH/DELETE /vendors/{vendorId}, GET /vendors/search, and many-to-many project linking via POST/DELETE /projects/{projectId}/vendors/{vendorId}. Vendor-specific fields: vendorType (enum), website, and projectIds.
  • New: Labels — GET /labels (filter by type), POST /labels, GET /labels/{labelId}. type is WORK (work orders) or ASSET. v2 mirrors these under /v2 with the standard success envelope.
  • New: Assets — GET /assets (filter by account_id), POST /assets, GET/PATCH /assets/{assetId} (set isArchived: true via PATCH to archive). v2 mirrors these under /v2 with the standard success envelope.

Looking for a specific date? See the entries below.

April 29, 2026

Assets — list, create, read, update

Manage physical assets tied to a site and account. Reads use project-service GraphQL; creates and updates call fleet-service.

Endpoints

MethodPathDescription
GET/assetsList assets (filters, pagination, optional account_id)
POST/assetsCreate an asset
GET/assets/{assetId}Get asset by id
PATCH/assets/{assetId}Update asset fields, including archiving

v2 exposes the same routes under the /v2 prefix with the standard { status, message, data } JSON envelope where applicable.

Query parameters (GET /assets)

ParameterDescription
page, page_sizePagination (page_size max 100)
order_byasc or desc by createdAt (default desc)
account_idFilter by account
site_idFilter by site
status, typeExact match
manufacturerCase-insensitive contains
is_archivedtrue / false (default false)
updated_after, updated_beforeISO date-time filters on updatedAt

Create body highlights

  • Required: accountId, siteId, type, manufacturer, model, serialNumber.
  • Optional: status, labelIds, dates, description, image file ids, size, expectedLifetime.

PATCH notes

  • siteId and accountId cannot be changed after creation; PATCH requests that include either field are rejected by request validation with 400 rather than being silently ignored.
  • Set isArchived: true to archive an asset, or isArchived: false to unarchive it.

Invoice payments

New: List, get, and create payments on an invoice

You can list payments for an invoice, fetch a single payment by id, and record manual payments. Paths are scoped under the invoice (there is no global /payments resource).

MethodPathDescription
GET/invoices/{invoiceId}/paymentsList all payment records for an invoice
GET/invoices/{invoiceId}/payments/{paymentId}Get one payment on an invoice
POST/invoices/{invoiceId}/paymentsCreate a manual payment on an invoice

v1 returns a JSON array for list, a single object for get-by-id, and the payment service payload for create (amounts in dollars on reads; create accepts dollars and converts to cents for core).

v2 (/v2/...) uses the same paths with the standard { status, message, data } envelope and dollar amounts on all responses.

Create a payment

POST /invoices/{invoiceId}/payments
1{
2  "amount": 125.5,
3  "paymentMethod": "CHECK",
4  "paymentDate": "2026-04-28T18:00:00.000Z",
5  "notes": "Deposit received",
6  "paymentReference": "CHK-1042"
7}

Notes

  • paymentReference and notes are optional.
  • paymentMethod must be one of: CASH, ACH, CREDIT_CARD, KLARNA, AFFIRM, CHECK.
  • Core does not expose GET /payment-records/:id; get-by-id resolves the payment from the invoice’s nested payment records.