Skip to content

Advanced

1 tool in this toolset, each with its tier, traits, description and arguments.

sevdesk_api_get 

Read any sevDesk API endpoint (advanced)

Readread-onlyidempotent

Last resort: a read-only GET of a sevDesk API endpoint that no other tool covers, e.g. /TextTemplate (Textvorlagen: head and foot texts), /PartUnity (units of parts), /Document (attached documents) or /Contact/{id}/getTabsItemCount. Prefer the specific tools: they check inputs, explain fields and format money and dates. Returns sevDesk's raw objects, cleaned as untrusted data: invisible characters removed, strings cut at 2,000 characters, binary content (base64 files, thumbnails), sevClient references and nesting deeper than 12 levels removed and listed in omittedFields. At most about 100 KB per call: rows beyond that are left out (omittedItems) and nextOffset continues there; answers over 1 MiB are refused, so lower limit. limit (1–1000) and offset are always sent; endpoints that do not page ignore them. Refused before anything is sent: endpoints that change data, return files or start jobs (getPdf, getXml, render, sendBy, sendByWithRender, bookAmount, enshrine, cancelInvoice, resetToDraft, resetToOpen, changeParameter, sendViaEmail, getNext…Number, names starting with save, create, update, delete, book, send or a similar verb, and everything under Export, ExportJob, Progress, Report, DocServer and SevSequence), and the query parameters token, api_key, authorization, limit, offset, countAll, download, preventSendBy, enshrine… and useNextNumber.

pathrequiredstring
API path below /api/v1, e.g. /TextTemplate or /Contact/123/getTabsItemCount: up to 6 segments of letters, digits and _, ids as plain numbers. Filters go into query.
queryoptionalobject
sevDesk query parameters (filters), at most 20, named as sevDesk names them, e.g. {"contact[id]": 5, "contact[objectName]": "Contact"} or {"depth": 1}. Booleans are sent as 1/0. sevDesk silently ignores filters it does not know.
limitoptionalinteger
Page size, 1–1000. Default: 100.
offsetoptionalinteger
Rows to skip, for paging: pass the previous result's nextOffset. Default: 0.