API & KI

API-Referenz

Alle Endpunkte der REST-API mit Parametern und Antworten, erzeugt aus der OpenAPI-Beschreibung.

Diese Referenz entsteht aus der OpenAPI-Beschreibung einer laufenden Annuva-Instanz. Deine eigene Instanz veröffentlicht dasselbe Dokument unter /api/v1/openapi. Authentifizierung und Konventionen stehen unter REST-API. Die Kurzbeschreibungen der Endpunkte sind auf Englisch, so wie sie die API selbst liefert.

Klick auf einen Endpunkt, um Parameter und Antwort zu sehen.

API-Version 1.3.0

billing

POST/api/v1/billing/runRecurring billing run (draft invoices from due recurring charges)

Recurring billing run (draft invoices from due recurring charges)

Parameter

`dryRun`	Body	boolean
`until`	Body	string (date)

Antwort

200OKobject

customers

GET/api/v1/customersList customers

List customers

Parameter

`limit`	Query	integer
`offset`	Query	integer
`sort`	Query	string
`order`	Query	"asc" \| "desc"
`q`	Query	string
`customerId`	Query	string (uuid)
`filter[field]`	Query	string	Equality filter, e.g. filter[status]=open

Antwort

200OK{items: Customer[], limit: integer, offset: integer, total: integer}

POST/api/v1/customersCreate customer

Create customer

Parameter

`name`Pflicht	Body	string
`channel`	Body	"direct" \| "partner" \| "own_project" \| "internal"
`partnerId`	Body	string (uuid) \| null
`status`	Body	"active" \| "paused" \| "inactive" \| "in_preparation"
`language`	Body	"de" \| "en"
`contactName`	Body	string \| null
`email`	Body	string (email) \| null
`phone`	Body	string \| null
`billingAddress`	Body	string \| null
`vatId`	Body	string \| null
`hourlyRate`	Body	number \| null
`hostingSummary`	Body	string \| null
`notes`	Body	string \| null

Antwort

201CreatedCustomer

GET/api/v1/customers/{id}Get customer

Get customer

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKCustomer

PATCH/api/v1/customers/{id}Update customer

Update customer

Parameter

`id`Pflicht	Pfad	string (uuid)
`name`	Body	string
`channel`	Body	"direct" \| "partner" \| "own_project" \| "internal"
`partnerId`	Body	string (uuid) \| null
`status`	Body	"active" \| "paused" \| "inactive" \| "in_preparation"
`language`	Body	"de" \| "en"
`contactName`	Body	string \| null
`email`	Body	string (email) \| null
`phone`	Body	string \| null
`billingAddress`	Body	string \| null
`vatId`	Body	string \| null
`hourlyRate`	Body	number \| null
`hostingSummary`	Body	string \| null
`notes`	Body	string \| null

Antwort

200OKCustomer

DELETE/api/v1/customers/{id}Delete customer

Delete customer

Parameter

idPflicht Pfad string (uuid)

Antwort

204Deleted

POST/api/v1/customers/{id}/archiveArchive customer

Archive customer

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKCustomer

DELETE/api/v1/customers/{id}/archiveRestore archived customer

Restore archived customer

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKCustomer

dashboard

GET/api/v1/dashboardDashboard data

Dashboard data

Parameter

`year`	Query	integer
`customer`	Query	string (uuid)

Antwort

200OKobject

expenses

GET/api/v1/expensesList expenses

List expenses

Parameter

`limit`	Query	integer
`offset`	Query	integer
`sort`	Query	string
`order`	Query	"asc" \| "desc"
`q`	Query	string
`customerId`	Query	string (uuid)
`filter[field]`	Query	string	Equality filter, e.g. filter[status]=open

Antwort

200OK{items: Expense[], limit: integer, offset: integer, total: integer}

POST/api/v1/expensesCreate expense

Create expense

Parameter

`date`Pflicht	Body	string
`vendor`Pflicht	Body	string
`item`Pflicht	Body	string
`category`Pflicht	Body	"server" \| "domain" \| "package" \| "license" \| "hardware" \| "software" \| "service" \| "travel" \| "office" \| "other"
`assignedTo`Pflicht	Body	string (uuid)
`grossAmount`Pflicht	Body	number
`originalAmount`	Body	number \| null
`originalCurrency`	Body	string \| null
`status`	Body	"receipt" \| "expected" \| "planned"
`receiptFileId`	Body	string (uuid) \| null

Antwort

201CreatedExpense

GET/api/v1/expenses/{id}Get expense

Get expense

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKExpense

PATCH/api/v1/expenses/{id}Update expense

Update expense

Parameter

`id`Pflicht	Pfad	string (uuid)
`date`	Body	string
`vendor`	Body	string
`item`	Body	string
`category`	Body	"server" \| "domain" \| "package" \| "license" \| "hardware" \| "software" \| "service" \| "travel" \| "office" \| "other"
`assignedTo`	Body	string (uuid)
`grossAmount`	Body	number
`originalAmount`	Body	number \| null
`originalCurrency`	Body	string \| null
`status`	Body	"receipt" \| "expected" \| "planned"
`receiptFileId`	Body	string (uuid) \| null

Antwort

200OKExpense

DELETE/api/v1/expenses/{id}Delete expense

Delete expense

Parameter

idPflicht Pfad string (uuid)

Antwort

204Deleted

files

POST/api/v1/filesUpload a file

Upload a file

Parameter

file Body string (binary)

Antwort

201Stored fileobject

GET/api/v1/files/{id}Download a file

Download a file

Parameter

idPflicht Pfad string (uuid)

Antwort

200File content

invoice-templates

GET/api/v1/invoice-templatesList invoiceTemplates

List invoiceTemplates

Parameter

`limit`	Query	integer
`offset`	Query	integer
`sort`	Query	string
`order`	Query	"asc" \| "desc"
`q`	Query	string
`customerId`	Query	string (uuid)
`filter[field]`	Query	string	Equality filter, e.g. filter[status]=open

Antwort

200OK{items: InvoiceTemplate[], limit: integer, offset: integer, total: integer}

POST/api/v1/invoice-templatesCreate invoice template

Create invoice template

Parameter

`name`Pflicht	Body	string
`isDefault`	Body	boolean \| null
`logoFileId`	Body	string (uuid) \| null
`senderLine`	Body	string \| null
`introText`	Body	string \| null
`closingText`	Body	string \| null
`signatureFileId`	Body	string (uuid) \| null
`signatureName`	Body	string \| null
`footerLeft`	Body	string \| null
`footerCenter`	Body	string \| null
`footerRight`	Body	string \| null
`accentColor`	Body	string \| null
`paymentTermDays`	Body	integer

Antwort

201CreatedInvoiceTemplate

GET/api/v1/invoice-templates/{id}Get invoice template

Get invoice template

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKInvoiceTemplate

PATCH/api/v1/invoice-templates/{id}Update invoice template

Update invoice template

Parameter

`id`Pflicht	Pfad	string (uuid)
`name`	Body	string
`isDefault`	Body	boolean \| null
`logoFileId`	Body	string (uuid) \| null
`senderLine`	Body	string \| null
`introText`	Body	string \| null
`closingText`	Body	string \| null
`signatureFileId`	Body	string (uuid) \| null
`signatureName`	Body	string \| null
`footerLeft`	Body	string \| null
`footerCenter`	Body	string \| null
`footerRight`	Body	string \| null
`accentColor`	Body	string \| null
`paymentTermDays`	Body	integer

Antwort

200OKInvoiceTemplate

DELETE/api/v1/invoice-templates/{id}Delete invoice template

Delete invoice template

Parameter

idPflicht Pfad string (uuid)

Antwort

204Deleted

POST/api/v1/invoice-templates/previewPreview an invoice template – also unsaved values – as a sample invoice (admin)

Preview an invoice template – also unsaved values – as a sample invoice (admin)

Parameter

`name`	Body	string
`isDefault`	Body	boolean \| null
`logoFileId`	Body	string (uuid) \| null
`senderLine`	Body	string \| null
`introText`	Body	string \| null
`closingText`	Body	string \| null
`signatureFileId`	Body	string (uuid) \| null
`signatureName`	Body	string \| null
`footerLeft`	Body	string \| null
`footerCenter`	Body	string \| null
`footerRight`	Body	string \| null
`accentColor`	Body	string \| null
`paymentTermDays`	Body	integer

Antwort

200Sample invoice as PDF

invoices

GET/api/v1/invoicesList invoices

List invoices

Parameter

`limit`	Query	integer
`offset`	Query	integer
`sort`	Query	string
`order`	Query	"asc" \| "desc"
`q`	Query	string
`customerId`	Query	string (uuid)
`filter[field]`	Query	string	Equality filter, e.g. filter[status]=open

Antwort

200OK{items: Invoice[], limit: integer, offset: integer, total: integer}

POST/api/v1/invoicesCreate draft invoice

Create draft invoice

Parameter

`customerId`Pflicht	Body	string (uuid)
`description`Pflicht	Body	string
`dueDate`	Body	string \| null
`language`	Body	"de" \| "en"
`lines`Pflicht	Body	object[]
`notes`	Body	string \| null
`partnerId`	Body	string (uuid) \| null
`recipientType`	Body	"customer" \| "partner"
`serviceDateFrom`	Body	string \| null
`serviceDateTo`	Body	string \| null
`templateId`	Body	string (uuid) \| null

Antwort

201Draft createdInvoice

GET/api/v1/invoices/{id}Get invoice

Get invoice

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKInvoice

PATCH/api/v1/invoices/{id}Update draft invoice

Update draft invoice

Parameter

`id`Pflicht	Pfad	string (uuid)
`customerId`	Body	string (uuid)
`description`	Body	string
`dueDate`	Body	string \| null
`language`	Body	"de" \| "en"
`lines`	Body	object[]
`notes`	Body	string \| null
`partnerId`	Body	string (uuid) \| null
`recipientType`	Body	"customer" \| "partner"
`serviceDateFrom`	Body	string \| null
`serviceDateTo`	Body	string \| null
`templateId`	Body	string (uuid) \| null

Antwort

200OKInvoice

DELETE/api/v1/invoices/{id}Delete draft invoice

Delete draft invoice

Parameter

idPflicht Pfad string (uuid)

Antwort

204Deleted

POST/api/v1/invoices/{id}/issueIssue invoice (number, PDF)

Issue invoice (number, PDF)

Parameter

`id`Pflicht	Pfad	string (uuid)
`date`	Body	string (date)

Antwort

200OKInvoice

POST/api/v1/invoices/{id}/payMark as paid

Mark as paid

Parameter

`id`Pflicht	Pfad	string (uuid)
`paidAt`	Body	string (date)

Antwort

200OKInvoice

POST/api/v1/invoices/{id}/reopenPaid → open

Paid → open

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKInvoice

POST/api/v1/invoices/{id}/cancelCancel via cancellation invoice

Cancel via cancellation invoice

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKInvoice

POST/api/v1/invoices/{id}/sendSend by e-mail

Send by e-mail

Parameter

`id`Pflicht	Pfad	string (uuid)
`message`	Body	string
`to`	Body	string (email)

Antwort

200OKInvoice

POST/api/v1/invoices/{id}/remindSend payment reminder

Send payment reminder

Parameter

`id`Pflicht	Pfad	string (uuid)
`message`	Body	string
`to`	Body	string (email)

Antwort

200OKInvoice

GET/api/v1/invoices/{id}/pdfInvoice PDF (draft preview or stored PDF)

Invoice PDF (draft preview or stored PDF)

Parameter

idPflicht Pfad string (uuid)

Antwort

200PDF

offers

GET/api/v1/offersList offers

List offers

Parameter

`limit`	Query	integer
`offset`	Query	integer
`sort`	Query	string
`order`	Query	"asc" \| "desc"
`q`	Query	string
`customerId`	Query	string (uuid)
`filter[field]`	Query	string	Equality filter, e.g. filter[status]=open

Antwort

200OK{items: Offer[], limit: integer, offset: integer, total: integer}

POST/api/v1/offersCreate offer

Create offer

Parameter

`customerId`Pflicht	Body	string (uuid)
`number`Pflicht	Body	string
`date`Pflicht	Body	string
`validUntil`	Body	string \| null
`amount`Pflicht	Body	number
`status`	Body	"open" \| "accepted" \| "rejected"
`description`	Body	string \| null
`fileId`	Body	string (uuid) \| null

Antwort

201CreatedOffer

GET/api/v1/offers/{id}Get offer

Get offer

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKOffer

PATCH/api/v1/offers/{id}Update offer

Update offer

Parameter

`id`Pflicht	Pfad	string (uuid)
`customerId`	Body	string (uuid)
`number`	Body	string
`date`	Body	string
`validUntil`	Body	string \| null
`amount`	Body	number
`status`	Body	"open" \| "accepted" \| "rejected"
`description`	Body	string \| null
`fileId`	Body	string (uuid) \| null

Antwort

200OKOffer

DELETE/api/v1/offers/{id}Delete offer

Delete offer

Parameter

idPflicht Pfad string (uuid)

Antwort

204Deleted

partners

GET/api/v1/partnersList partners

List partners

Parameter

`limit`	Query	integer
`offset`	Query	integer
`sort`	Query	string
`order`	Query	"asc" \| "desc"
`q`	Query	string
`customerId`	Query	string (uuid)
`filter[field]`	Query	string	Equality filter, e.g. filter[status]=open

Antwort

200OK{items: Partner[], limit: integer, offset: integer, total: integer}

POST/api/v1/partnersCreate partner

Create partner

Parameter

`name`Pflicht	Body	string
`email`	Body	string (email) \| null
`billingAddress`	Body	string \| null
`notes`	Body	string \| null

Antwort

201CreatedPartner

GET/api/v1/partners/{id}Get partner

Get partner

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKPartner

PATCH/api/v1/partners/{id}Update partner

Update partner

Parameter

`id`Pflicht	Pfad	string (uuid)
`name`	Body	string
`email`	Body	string (email) \| null
`billingAddress`	Body	string \| null
`notes`	Body	string \| null

Antwort

200OKPartner

DELETE/api/v1/partners/{id}Delete partner

Delete partner

Parameter

idPflicht Pfad string (uuid)

Antwort

204Deleted

profile

GET/api/v1/profileOwn profile

Own profile

Parameter

Keine Parameter.

Antwort

200OKobject

PATCH/api/v1/profileUpdate own profile

Update own profile

Parameter

Keine Parameter.

Antwort

200OKobject

GET/api/v1/profile/two-factorTwo-factor status of the own account

Two-factor status of the own account

Parameter

Keine Parameter.

Antwort

200OK{enabled: boolean, recoveryCodesLeft: integer}

GET/api/v1/tokensOwn API tokens

Own API tokens

Parameter

Keine Parameter.

Antwort

200OKobject

POST/api/v1/tokensCreate API token

Create API token

Parameter

Keine Parameter.

Antwort

201Token (shown once)

recurring-charges

GET/api/v1/recurring-chargesList recurringCharges

List recurringCharges

Parameter

`limit`	Query	integer
`offset`	Query	integer
`sort`	Query	string
`order`	Query	"asc" \| "desc"
`q`	Query	string
`customerId`	Query	string (uuid)
`filter[field]`	Query	string	Equality filter, e.g. filter[status]=open

Antwort

200OK{items: RecurringCharge[], limit: integer, offset: integer, total: integer}

POST/api/v1/recurring-chargesCreate recurring charge

Create recurring charge

Parameter

`customerId`Pflicht	Body	string (uuid)
`service`Pflicht	Body	"hosting" \| "domain" \| "package" \| "maintenance" \| "other"
`description`	Body	string \| null
`amountPerYear`Pflicht	Body	number
`interval`	Body	"yearly" \| "quarterly" \| "monthly"
`nextInvoiceDate`Pflicht	Body	string
`startsAfterSetup`	Body	boolean \| null

Antwort

201CreatedRecurringCharge

GET/api/v1/recurring-charges/{id}Get recurring charge

Get recurring charge

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKRecurringCharge

PATCH/api/v1/recurring-charges/{id}Update recurring charge

Update recurring charge

Parameter

`id`Pflicht	Pfad	string (uuid)
`customerId`	Body	string (uuid)
`service`	Body	"hosting" \| "domain" \| "package" \| "maintenance" \| "other"
`description`	Body	string \| null
`amountPerYear`	Body	number
`interval`	Body	"yearly" \| "quarterly" \| "monthly"
`nextInvoiceDate`	Body	string
`startsAfterSetup`	Body	boolean \| null

Antwort

200OKRecurringCharge

DELETE/api/v1/recurring-charges/{id}Delete recurring charge

Delete recurring charge

Parameter

idPflicht Pfad string (uuid)

Antwort

204Deleted

recurring-costs

GET/api/v1/recurring-costsList recurringCosts

List recurringCosts

Parameter

`limit`	Query	integer
`offset`	Query	integer
`sort`	Query	string
`order`	Query	"asc" \| "desc"
`q`	Query	string
`customerId`	Query	string (uuid)
`filter[field]`	Query	string	Equality filter, e.g. filter[status]=open

Antwort

200OK{items: RecurringCost[], limit: integer, offset: integer, total: integer}

POST/api/v1/recurring-costsCreate recurring cost

Create recurring cost

Parameter

`name`Pflicht	Body	string
`type`Pflicht	Body	"domain" \| "package" \| "server" \| "other"
`provider`Pflicht	Body	string
`assignedTo`Pflicht	Body	string (uuid)
`costPerYear`Pflicht	Body	number
`rebilledPerYear`	Body	number
`nextRenewal`	Body	string \| null
`autoRenew`	Body	boolean \| null
`endsAt`	Body	string \| null

Antwort

201CreatedRecurringCost

GET/api/v1/recurring-costs/{id}Get recurring cost

Get recurring cost

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKRecurringCost

PATCH/api/v1/recurring-costs/{id}Update recurring cost

Update recurring cost

Parameter

`id`Pflicht	Pfad	string (uuid)
`name`	Body	string
`type`	Body	"domain" \| "package" \| "server" \| "other"
`provider`	Body	string
`assignedTo`	Body	string (uuid)
`costPerYear`	Body	number
`rebilledPerYear`	Body	number
`nextRenewal`	Body	string \| null
`autoRenew`	Body	boolean \| null
`endsAt`	Body	string \| null

Antwort

200OKRecurringCost

DELETE/api/v1/recurring-costs/{id}Delete recurring cost

Delete recurring cost

Parameter

idPflicht Pfad string (uuid)

Antwort

204Deleted

resources

GET/api/v1/resourcesList resources

List resources

Parameter

`limit`	Query	integer
`offset`	Query	integer
`sort`	Query	string
`order`	Query	"asc" \| "desc"
`q`	Query	string
`customerId`	Query	string (uuid)
`filter[field]`	Query	string	Equality filter, e.g. filter[status]=open

Antwort

200OK{items: Resource[], limit: integer, offset: integer, total: integer}

POST/api/v1/resourcesCreate resource

Create resource

Parameter

`customerId`Pflicht	Body	string (uuid)
`kind`Pflicht	Body	"domain" \| "container" \| "proxy_host" \| "package" \| "server" \| "other"
`name`Pflicht	Body	string
`location`	Body	string \| null
`details`	Body	string \| null
`externalRef`	Body	string \| null

Antwort

201CreatedResource

GET/api/v1/resources/{id}Get resource

Get resource

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKResource

PATCH/api/v1/resources/{id}Update resource

Update resource

Parameter

`id`Pflicht	Pfad	string (uuid)
`customerId`	Body	string (uuid)
`kind`	Body	"domain" \| "container" \| "proxy_host" \| "package" \| "server" \| "other"
`name`	Body	string
`location`	Body	string \| null
`details`	Body	string \| null
`externalRef`	Body	string \| null

Antwort

200OKResource

DELETE/api/v1/resources/{id}Delete resource

Delete resource

Parameter

idPflicht Pfad string (uuid)

Antwort

204Deleted

settings

GET/api/v1/settingsBusiness settings

Business settings

Parameter

Keine Parameter.

Antwort

200OKSettings

PATCH/api/v1/settingsUpdate settings (admin)

Update settings (admin)

Parameter

`name`	Body	string
`companyName`	Body	string \| null
`address`	Body	string \| null
`email`	Body	string (email) \| null
`phone`	Body	string \| null
`website`	Body	string \| null
`taxNumber`	Body	string \| null
`vatId`	Body	string \| null
`bankName`	Body	string \| null
`iban`	Body	string \| null
`bic`	Body	string \| null
`vatMode`	Body	"small_business" \| "regular"
`defaultVatRate`	Body	number
`currency`	Body	string
`locale`	Body	"de-DE" \| "de-AT" \| "de-CH" \| "en-GB" \| "en-US"
`timezone`	Body	string
`defaultHourlyRate`	Body	number
`defaultHostingPerYear`	Body	number
`invoiceNumberFormat`	Body	string
`recurringInvoiceMonth`	Body	integer
`taxPaymentMonth`	Body	integer
`serverCostAllocation`	Body	"equal_among_hosting_customers" \| "none"
`domainPassThrough`	Body	"at_cost" \| "markup"

Antwort

200OKSettings

system

GET/api/healthHealth check

Health check

Parameter

Keine Parameter.

Antwort

200Healthy

POST/api/mcpMCP server (Streamable HTTP, JSON-RPC)

MCP server (Streamable HTTP, JSON-RPC)

Parameter

Keine Parameter.

Antwort

200MCP response

tasks

GET/api/v1/tasksList tasks

List tasks

Parameter

`limit`	Query	integer
`offset`	Query	integer
`sort`	Query	string
`order`	Query	"asc" \| "desc"
`q`	Query	string
`customerId`	Query	string (uuid)
`filter[field]`	Query	string	Equality filter, e.g. filter[status]=open

Antwort

200OK{items: Task[], limit: integer, offset: integer, total: integer}

POST/api/v1/tasksCreate task

Create task

Parameter

`title`Pflicht	Body	string
`dueDate`	Body	string \| null
`customerId`	Body	string (uuid) \| null
`status`	Body	"open" \| "waiting_for_go" \| "done"
`note`	Body	string \| null

Antwort

201CreatedTask

GET/api/v1/tasks/{id}Get task

Get task

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKTask

PATCH/api/v1/tasks/{id}Update task

Update task

Parameter

`id`Pflicht	Pfad	string (uuid)
`title`	Body	string
`dueDate`	Body	string \| null
`customerId`	Body	string (uuid) \| null
`status`	Body	"open" \| "waiting_for_go" \| "done"
`note`	Body	string \| null

Antwort

200OKTask

DELETE/api/v1/tasks/{id}Delete task

Delete task

Parameter

idPflicht Pfad string (uuid)

Antwort

204Deleted

tax-adjustments

GET/api/v1/tax-adjustmentsList taxAdjustments

List taxAdjustments

Parameter

`limit`	Query	integer
`offset`	Query	integer
`sort`	Query	string
`order`	Query	"asc" \| "desc"
`q`	Query	string
`customerId`	Query	string (uuid)
`filter[field]`	Query	string	Equality filter, e.g. filter[status]=open

Antwort

200OK{items: TaxAdjustment[], limit: integer, offset: integer, total: integer}

POST/api/v1/tax-adjustmentsCreate tax adjustment

Create tax adjustment

Parameter

`year`Pflicht	Body	integer
`description`Pflicht	Body	string
`profitAdjustment`Pflicht	Body	number

Antwort

201CreatedTaxAdjustment

GET/api/v1/tax-adjustments/{id}Get tax adjustment

Get tax adjustment

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKTaxAdjustment

PATCH/api/v1/tax-adjustments/{id}Update tax adjustment

Update tax adjustment

Parameter

`id`Pflicht	Pfad	string (uuid)
`year`	Body	integer
`description`	Body	string
`profitAdjustment`	Body	number

Antwort

200OKTaxAdjustment

DELETE/api/v1/tax-adjustments/{id}Delete tax adjustment

Delete tax adjustment

Parameter

idPflicht Pfad string (uuid)

Antwort

204Deleted

tax-years

GET/api/v1/tax-yearsList taxYears

List taxYears

Parameter

`limit`	Query	integer
`offset`	Query	integer
`sort`	Query	string
`order`	Query	"asc" \| "desc"
`q`	Query	string
`customerId`	Query	string (uuid)
`filter[field]`	Query	string	Equality filter, e.g. filter[status]=open

Antwort

200OK{items: TaxYear[], limit: integer, offset: integer, total: integer}

POST/api/v1/tax-yearsCreate tax year

Create tax year

Parameter

`year`Pflicht	Body	integer
`marginalRatePercent`	Body	number \| null
`profitPerAssessment`	Body	number \| null

Antwort

201CreatedTaxYear

GET/api/v1/tax-years/{id}Get tax year

Get tax year

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKTaxYear

PATCH/api/v1/tax-years/{id}Update tax year

Update tax year

Parameter

`id`Pflicht	Pfad	string (uuid)
`year`	Body	integer
`marginalRatePercent`	Body	number \| null
`profitPerAssessment`	Body	number \| null

Antwort

200OKTaxYear

DELETE/api/v1/tax-years/{id}Delete tax year

Delete tax year

Parameter

idPflicht Pfad string (uuid)

Antwort

204Deleted

users

GET/api/v1/usersList users (admin)

List users (admin)

Parameter

Keine Parameter.

Antwort

200OKobject

POST/api/v1/usersCreate user (admin)

Create user (admin)

Parameter

Keine Parameter.

Antwort

201Created

PATCH/api/v1/users/{id}Update user (admin)

Update user (admin)

Parameter

idPflicht Pfad string (uuid)

Antwort

200OKobject

DELETE/api/v1/users/{id}Delete user (admin)

Delete user (admin)

Parameter

idPflicht Pfad string (uuid)

Antwort

204Deleted

DELETE/api/v1/users/{id}/two-factorReset two-factor authentication of a user (admin)

Reset two-factor authentication of a user (admin)

Parameter

idPflicht Pfad string (uuid)

Antwort

204Two-factor authentication switched off

Diese Seite auf GitHub bearbeiten