{"openapi":"3.1.0","info":{"title":"SuperFaktura (BYOK) API","version":"0.1.0","description":"SuperFaktura (BYOK) lets an AI assistant read your own SuperFaktura data through the SuperFaktura API with a key you supply (SuperFaktura API access string in the form email=YOUR%40EMAIL&apikey=YOURTOKEN&module=ConnectorBay&company_id=YOURCOMPANYID (values URL encoded; company_id optional)). Read-only: 8 tools (list_stock_items, get_stock_item, list_stock_movements, list_tags,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-superfaktura-sk.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-superfaktura-sk/docs"},"termsOfService":"https://connectorbay.com/byok-superfaktura-sk/terms"},"servers":[{"url":"https://byok-superfaktura-sk.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-superfaktura-sk/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_stock_items":{"post":{"operationId":"list_stock_items","summary":"List stock (warehouse) items with name, SKU, description, quantity in stock, unit, unit price, VAT rate and dates. Pages","description":"List stock (warehouse) items with name, SKU, description, quantity in stock, unit, unit price, VAT rate and dates. Pages are path based: pass page 1 for the first page. Use for \"What items do I have in stock in SuperFaktura\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page":{"description":"Page number, starting at 1.","maximum":10000,"minimum":1,"title":"Page","type":"integer"},"per_page":{"description":"Items per page (1 to 100).","maximum":100,"minimum":1,"title":"Per Page","type":"integer"},"direction":{"description":"Sort direction: ASC or DESC.","enum":["ASC","DESC"],"title":"Direction","type":"string"}},"required":["page","per_page","direction"],"title":"list_stock_itemsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_stock_item":{"post":{"operationId":"get_stock_item","summary":"Get one stock item by id with SKU, description, quantity, unit, price, VAT and dates. Use for \"Show SuperFaktura stock i","description":"Get one stock item by id with SKU, description, quantity, unit, price, VAT and dates. Use for \"Show SuperFaktura stock item 1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Numeric id of the stock item.","minimum":1,"title":"Id","type":"integer"}},"required":["id"],"title":"get_stock_itemArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_stock_movements":{"post":{"operationId":"list_stock_movements","summary":"List the stock movement log of one item: quantity change, note, related document ids and time. Use for \"How did the stoc","description":"List the stock movement log of one item: quantity change, note, related document ids and time. Use for \"How did the stock of SuperFaktura item 9 change\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Numeric id of the stock item.","minimum":1,"title":"Id","type":"integer"},"page":{"description":"Page number, starting at 1.","maximum":10000,"minimum":1,"title":"Page","type":"integer"},"per_page":{"description":"Movements per page (1 to 100).","maximum":100,"minimum":1,"title":"Per Page","type":"integer"}},"required":["id","page","per_page"],"title":"list_stock_movementsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_tags":{"post":{"operationId":"list_tags","summary":"List the tags that can be attached to invoices, expenses and clients, as a map of tag id to tag name. Use for \"Which tag","description":"List the tags that can be attached to invoices, expenses and clients, as a map of tag id to tag name. Use for \"Which tags do I use in SuperFaktura\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_tagsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_cash_registers":{"post":{"operationId":"list_cash_registers","summary":"List cash registers with currency, name, description, number of items and current total. Use for \"What are my SuperFaktu","description":"List cash registers with currency, name, description, number of items and current total. Use for \"What are my SuperFaktura cash registers and their balances\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_cash_registersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_expense_categories":{"post":{"operationId":"list_expense_categories","summary":"List the expense categories as a tree: id, name, parent id and child categories. Use for \"Which expense categories are d","description":"List the expense categories as a tree: id, name, parent id and child categories. Use for \"Which expense categories are defined in SuperFaktura\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_expense_categoriesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_sequences":{"post":{"operationId":"list_sequences","summary":"List document numbering sequences grouped by document type (invoice, proforma, delivery, cash register and others) with ","description":"List document numbering sequences grouped by document type (invoice, proforma, delivery, cash register and others) with mask, period and next formatted number. Use for \"What numbering sequences are set up in SuperFaktura\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_sequencesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_countries":{"post":{"operationId":"list_countries","summary":"List countries known to SuperFaktura as a map of country id to country name. Use for \"Which countries can I choose in Su","description":"List countries known to SuperFaktura as a map of country id to country name. Use for \"Which countries can I choose in SuperFaktura\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_countriesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}