Advanced
1 tool in this toolset, each with its tier, traits, description and arguments.
sevdesk_api_get
Read any sevDesk API endpoint (advanced)
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.