Skip to content

All resources

billing-items

4 endpoints

get /projects/{id}/billing-items

List a project's billing items

Requires authentication

Admin only. Milestones, one-off charges, and per-task fixed prices, in display order.

Parameters

NameInTypeRequiredDescription
idpathintegeryesProject id

Responses

  • 200 OK · object
  • 401 Unauthorized · apimodel.ErrorEnvelope
  • 403 Forbidden · apimodel.ErrorEnvelope

post /projects/{id}/billing-items

Add a billing item to a project

Requires authentication

Admin only. Kind "task_fixed" requires a taskId; the other kinds forbid one.

Parameters

NameInTypeRequiredDescription
idpathintegeryesProject id

Request body: dto.CreateBillingItemRequest

NameTypeRequiredDescription
amountCentsintegerno
kinddomain.BillingItemKindno
namestringno
sortOrderintegerno
statusdomain.BillingItemStatusno
taskIdintegernoTaskID is required for kind "task_fixed" and forbidden otherwise.

Responses

  • 201 Created · object
  • 401 Unauthorized · apimodel.ErrorEnvelope
  • 403 Forbidden · apimodel.ErrorEnvelope
  • 422 Unprocessable Entity · apimodel.ErrorEnvelope

patch /projects/{id}/billing-items/{itemId}

Edit a billing item

Requires authentication

Admin only. An invoiced item returns 409 — changing one after invoicing is a credit note, not an edit.

Parameters

NameInTypeRequiredDescription
idpathintegeryesProject id
itemIdpathintegeryesBilling item id

Request body: dto.UpdateBillingItemRequest

NameTypeRequiredDescription
amountCentsintegerno
namestringno
sortOrderintegerno
statusdomain.BillingItemStatusno

Responses

  • 200 OK · object
  • 401 Unauthorized · apimodel.ErrorEnvelope
  • 403 Forbidden · apimodel.ErrorEnvelope
  • 404 Not Found · apimodel.ErrorEnvelope
  • 409 Conflict · apimodel.ErrorEnvelope

delete /projects/{id}/billing-items/{itemId}

Delete a billing item

Requires authentication

Admin only. An invoiced item returns 409.

Parameters

NameInTypeRequiredDescription
idpathintegeryesProject id
itemIdpathintegeryesBilling item id

Responses

  • 204 No Content
  • 401 Unauthorized · apimodel.ErrorEnvelope
  • 403 Forbidden · apimodel.ErrorEnvelope
  • 404 Not Found · apimodel.ErrorEnvelope
  • 409 Conflict · apimodel.ErrorEnvelope