{"openapi":"3.1.0","info":{"title":"Snipe-IT Cloud (BYOK) API","version":"0.1.0","description":"Snipe-IT Cloud (BYOK) lets an AI assistant read your own Snipe-IT Cloud data through the Snipe-IT Cloud API with a key you supply (personal API token). Read-only: 11 tools (list_assets, get_asset_by_tag, list_licenses, list_accessories, list_consumables, list_components, list_status_labels, list_manufacturers, list_companies, list_departments, list_maintenances). The BYOK key travels with each...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-snipe-it.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-snipe-it/docs"},"termsOfService":"https://connectorbay.com/byok-snipe-it/terms"},"servers":[{"url":"https://byok-snipe-it.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-snipe-it/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_assets":{"post":{"operationId":"list_assets","summary":"List hardware assets with tag, serial, model, status, category, manufacturer, location, current assignee name and purcha","description":"List hardware assets with tag, serial, model, status, category, manufacturer, location, current assignee name and purchase data. Returns total plus a page of rows. Use for \"Which assets are ready to deploy in my Snipe-IT\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tenant":{"description":"Your Snipe-IT cloud subdomain: the part before .snipe-it.io in your address.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Tenant","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many rows to return (1 to 100, default 50).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of rows to skip, for paging.","title":"Offset"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text to search for in the record's searchable fields.","title":"Search"},"status":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Status group: RTD, Deployed, Undeployable, Archived, Requestable, Pending, Deleted or Asset (all).","title":"Status"},"status_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only assets with this status label ID.","title":"Status Id"},"model_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only assets of this model ID.","title":"Model Id"},"category_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only assets of this category ID.","title":"Category Id"},"manufacturer_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only assets of this manufacturer ID.","title":"Manufacturer Id"},"location_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only assets at this location ID.","title":"Location Id"},"sort":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"created_at","description":"Column to sort by (default created_at).","title":"Sort"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction: asc or desc.","title":"Order"}},"required":["tenant"],"title":"list_assetsArguments","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_asset_by_tag":{"post":{"operationId":"get_asset_by_tag","summary":"Get one asset by its asset tag: model, status, category, location, assignee name, purchase date and cost, warranty. Use ","description":"Get one asset by its asset tag: model, status, category, location, assignee name, purchase date and cost, warranty. Use for \"What is the status of asset tag A-0001 in Snipe-IT\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tenant":{"description":"Your Snipe-IT cloud subdomain: the part before .snipe-it.io in your address.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Tenant","type":"string"},"asset_tag":{"description":"The asset tag printed on the asset, for example 'A-0001'.","maxLength":200,"title":"Asset Tag","type":"string"},"deleted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to look among deleted assets.","title":"Deleted"}},"required":["tenant","asset_tag"],"title":"get_asset_by_tagArguments","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_licenses":{"post":{"operationId":"list_licenses","summary":"List software licenses with manufacturer, seat counts, free seats, purchase and expiry data. Product keys and license ho","description":"List software licenses with manufacturer, seat counts, free seats, purchase and expiry data. Product keys and license holder details are not returned. Use for \"Which Snipe-IT licenses have free seats\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tenant":{"description":"Your Snipe-IT cloud subdomain: the part before .snipe-it.io in your address.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Tenant","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many rows to return (1 to 100, default 50).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of rows to skip, for paging.","title":"Offset"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text to search for in the record's searchable fields.","title":"Search"},"manufacturer_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only licenses of this manufacturer ID.","title":"Manufacturer Id"},"category_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only licenses of this category ID.","title":"Category Id"},"supplier_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only licenses from this supplier ID.","title":"Supplier Id"},"maintained":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True or false to filter by maintenance flag.","title":"Maintained"},"sort":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"created_at","description":"Column to sort by (default created_at).","title":"Sort"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction: asc or desc.","title":"Order"}},"required":["tenant"],"title":"list_licensesArguments","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_accessories":{"post":{"operationId":"list_accessories","summary":"List accessories (keyboards, cables ...) with manufacturer, category, location, total quantity, minimum quantity and rem","description":"List accessories (keyboards, cables ...) with manufacturer, category, location, total quantity, minimum quantity and remaining quantity. Use for \"Which accessories are running low in Snipe-IT\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tenant":{"description":"Your Snipe-IT cloud subdomain: the part before .snipe-it.io in your address.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Tenant","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many rows to return (1 to 100, default 50).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of rows to skip, for paging.","title":"Offset"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text to search for in the record's searchable fields.","title":"Search"},"category_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only accessories of this category ID.","title":"Category Id"},"company_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only accessories of this company ID.","title":"Company Id"},"sort":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"created_at","description":"Column to sort by (default created_at).","title":"Sort"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction: asc or desc.","title":"Order"}},"required":["tenant"],"title":"list_accessoriesArguments","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_consumables":{"post":{"operationId":"list_consumables","summary":"List consumables (paper, toner ...) with category, manufacturer, item number, quantity, minimum amount and remaining amo","description":"List consumables (paper, toner ...) with category, manufacturer, item number, quantity, minimum amount and remaining amount. Use for \"How many consumables are left in Snipe-IT\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tenant":{"description":"Your Snipe-IT cloud subdomain: the part before .snipe-it.io in your address.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Tenant","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many rows to return (1 to 100, default 50).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of rows to skip, for paging.","title":"Offset"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text to search for in the record's searchable fields.","title":"Search"},"name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only consumables with this name.","title":"Name"},"category_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only consumables of this category ID.","title":"Category Id"},"manufacturer_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only consumables of this manufacturer ID.","title":"Manufacturer Id"},"sort":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"created_at","description":"Column to sort by (default created_at).","title":"Sort"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction: asc or desc.","title":"Order"}},"required":["tenant"],"title":"list_consumablesArguments","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_components":{"post":{"operationId":"list_components","summary":"List components (RAM, drives ...) with category, serial, location, quantity, minimum amount and remaining amount. Use fo","description":"List components (RAM, drives ...) with category, serial, location, quantity, minimum amount and remaining amount. Use for \"Which hardware components are tracked in Snipe-IT\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tenant":{"description":"Your Snipe-IT cloud subdomain: the part before .snipe-it.io in your address.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Tenant","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many rows to return (1 to 100, default 50).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of rows to skip, for paging.","title":"Offset"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text to search for in the record's searchable fields.","title":"Search"},"name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only components with this name.","title":"Name"},"sort":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"created_at","description":"Column to sort by (default created_at).","title":"Sort"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction: asc or desc.","title":"Order"}},"required":["tenant"],"title":"list_componentsArguments","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_status_labels":{"post":{"operationId":"list_status_labels","summary":"List asset status labels with type (deployable, undeployable, pending, archived) and how many assets use each. Use for \"","description":"List asset status labels with type (deployable, undeployable, pending, archived) and how many assets use each. Use for \"What status labels exist in Snipe-IT and how many assets have each\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tenant":{"description":"Your Snipe-IT cloud subdomain: the part before .snipe-it.io in your address.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Tenant","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many rows to return (1 to 100, default 50).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of rows to skip, for paging.","title":"Offset"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text to search for in the record's searchable fields.","title":"Search"},"status_type":{"anyOf":[{"enum":["deployable","undeployable","pending","archived"],"type":"string"},{"type":"null"}],"default":null,"description":"Only labels of this type.","title":"Status Type"},"sort":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"created_at","description":"Column to sort by (default created_at).","title":"Sort"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction: asc or desc.","title":"Order"}},"required":["tenant"],"title":"list_status_labelsArguments","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_manufacturers":{"post":{"operationId":"list_manufacturers","summary":"List manufacturers with website, support URL and counts of assets, licenses, accessories and consumables. Use for \"Which","description":"List manufacturers with website, support URL and counts of assets, licenses, accessories and consumables. Use for \"Which manufacturers have the most assets in Snipe-IT\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tenant":{"description":"Your Snipe-IT cloud subdomain: the part before .snipe-it.io in your address.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Tenant","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many rows to return (1 to 100, default 50).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of rows to skip, for paging.","title":"Offset"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text to search for in the record's searchable fields.","title":"Search"},"sort":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"created_at","description":"Column to sort by (default created_at).","title":"Sort"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction: asc or desc.","title":"Order"}},"required":["tenant"],"title":"list_manufacturersArguments","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_companies":{"post":{"operationId":"list_companies","summary":"List companies (the multi-company feature) with counts of assets, licenses, accessories, consumables, components and use","description":"List companies (the multi-company feature) with counts of assets, licenses, accessories, consumables, components and users. Use for \"Which companies are set up in Snipe-IT\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tenant":{"description":"Your Snipe-IT cloud subdomain: the part before .snipe-it.io in your address.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Tenant","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many rows to return (1 to 100, default 50).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of rows to skip, for paging.","title":"Offset"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text to search for in the record's searchable fields.","title":"Search"},"name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only companies with this name.","title":"Name"},"sort":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"created_at","description":"Column to sort by (default created_at).","title":"Sort"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction: asc or desc.","title":"Order"}},"required":["tenant"],"title":"list_companiesArguments","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_departments":{"post":{"operationId":"list_departments","summary":"List departments with their location and number of users (manager details are left out). Use for \"How many users are in ","description":"List departments with their location and number of users (manager details are left out). Use for \"How many users are in each department in Snipe-IT\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tenant":{"description":"Your Snipe-IT cloud subdomain: the part before .snipe-it.io in your address.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Tenant","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many rows to return (1 to 100, default 50).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of rows to skip, for paging.","title":"Offset"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text to search for in the record's searchable fields.","title":"Search"},"name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only departments with this name.","title":"Name"},"location_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only departments at this location ID.","title":"Location Id"},"sort":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"created_at","description":"Column to sort by (default created_at).","title":"Sort"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction: asc or desc.","title":"Order"}},"required":["tenant"],"title":"list_departmentsArguments","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_maintenances":{"post":{"operationId":"list_maintenances","summary":"List asset maintenance records with asset, title, type, supplier, cost, start and completion date. Use for \"What mainten","description":"List asset maintenance records with asset, title, type, supplier, cost, start and completion date. Use for \"What maintenance has been done on my Snipe-IT assets\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tenant":{"description":"Your Snipe-IT cloud subdomain: the part before .snipe-it.io in your address.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Tenant","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many rows to return (1 to 100, default 50).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of rows to skip, for paging.","title":"Offset"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text to search for in the record's searchable fields.","title":"Search"},"asset_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only maintenances of this asset ID.","title":"Asset Id"},"sort":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"created_at","description":"Column to sort by (default created_at).","title":"Sort"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction: asc or desc.","title":"Order"}},"required":["tenant"],"title":"list_maintenancesArguments","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}}}}