{"openapi":"3.1.0","info":{"title":"Levanta (BYOK) API","version":"0.1.0","description":"Levanta (BYOK) lets an AI assistant read your own Levanta data through the Levanta API with a key you supply (Levanta API key (Settings, API)). Read-only: 8 tools (list_brands, get_brand, list_products, get_performance_by_date, get_performance_by_product, get_performance_by_brand, get_performance_by_creator, list_conversions). The BYOK key travels with each request, is used for that one call only...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-levanta.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-levanta/docs"},"termsOfService":"https://connectorbay.com/byok-levanta/terms"},"servers":[{"url":"https://byok-levanta.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-levanta/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_brands":{"post":{"operationId":"list_brands","summary":"List the brands of the seller account in one marketplace with status, bio and storefront URL; filter by id or active. Us","description":"List the brands of the seller account in one marketplace with status, bio and storefront URL; filter by id or active. Use for \"Which brands do I have in Levanta\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"marketplace":{"description":"Marketplace to list (all, amazon.com, amazon.co.uk, walmart.com, shopify.com and others).","enum":["all","amazon.com","amazon.com.mx","amazon.co.uk","amazon.ca","amazon.de","amazon.es","amazon.fr","amazon.it","amazon.nl","walmart.com","shopify.com","wayfair.com"],"title":"Marketplace","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Rows per page (1 to 100, default 25).","title":"Limit"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's cursor field.","title":"Cursor"},"brand_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these brand ids, comma separated.","title":"Brand Ids"},"active":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Only active or inactive brands.","title":"Active"}},"required":["marketplace"],"title":"list_brandsArguments","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_brand":{"post":{"operationId":"get_brand","summary":"Get one brand with name, status, bio, URL and marketplace. Use for \"What are the details of my Levanta brand\".","description":"Get one brand with name, status, bio, URL and marketplace. Use for \"What are the details of my Levanta brand\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"brand_id":{"description":"Brand id (the id from list_brands).","maxLength":200,"title":"Brand Id","type":"string"}},"required":["brand_id"],"title":"get_brandArguments","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_products":{"post":{"operationId":"list_products","summary":"List the products with price, commission percentage, stock, category and brand; filter by brand, product, group or activ","description":"List the products with price, commission percentage, stock, category and brand; filter by brand, product, group or active. Use for \"Which products offer affiliate commission in Levanta\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"marketplace":{"description":"Marketplace to list (all, amazon.com, amazon.co.uk, walmart.com, shopify.com and others).","enum":["all","amazon.com","amazon.com.mx","amazon.co.uk","amazon.ca","amazon.de","amazon.es","amazon.fr","amazon.it","amazon.nl","walmart.com","shopify.com","wayfair.com"],"title":"Marketplace","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Rows per page (1 to 100, default 25).","title":"Limit"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's cursor field.","title":"Cursor"},"brand_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these brand ids, comma separated.","title":"Brand Ids"},"product_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these product ids, comma separated.","title":"Product Ids"},"group_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these variation group ids, comma separated.","title":"Group Ids"},"active":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Only active or inactive products.","title":"Active"}},"required":["marketplace"],"title":"list_productsArguments","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_performance_by_date":{"post":{"operationId":"get_performance_by_date","summary":"Get clicks, sales, commission, conversions, add-to-carts and page views per day for a period. Use for \"How did my Levant","description":"Get clicks, sales, commission, conversions, add-to-carts and page views per day for a period. Use for \"How did my Levanta affiliate program do day by day\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start":{"description":"Start of the period, UTC, YYYY-MM-DDTHH:mm:ss.SSSZ.","maxLength":30,"title":"Start","type":"string"},"end":{"description":"End of the period, UTC, YYYY-MM-DDTHH:mm:ss.SSSZ.","maxLength":30,"title":"End","type":"string"},"currency":{"anyOf":[{"enum":["USD","GBP","CAD","EUR","MXN"],"type":"string"},{"type":"null"}],"default":"USD","description":"Currency of the money columns (default USD).","title":"Currency"},"marketplaces":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only these marketplaces, comma separated (default all).","title":"Marketplaces"},"brand_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these brand ids, comma separated.","title":"Brand Ids"},"product_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these product ids (ASIN, Walmart item id, Shopify variant id), comma separated.","title":"Product Ids"},"creator_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these creator ids, comma separated.","title":"Creator Ids"}},"required":["start","end"],"title":"get_performance_by_dateArguments","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_performance_by_product":{"post":{"operationId":"get_performance_by_product","summary":"Get clicks, sales, commission and conversions per product for a period. Use for \"Which products sell best through Levant","description":"Get clicks, sales, commission and conversions per product for a period. Use for \"Which products sell best through Levanta creators\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start":{"description":"Start of the period, UTC, YYYY-MM-DDTHH:mm:ss.SSSZ.","maxLength":30,"title":"Start","type":"string"},"end":{"description":"End of the period, UTC, YYYY-MM-DDTHH:mm:ss.SSSZ.","maxLength":30,"title":"End","type":"string"},"currency":{"anyOf":[{"enum":["USD","GBP","CAD","EUR","MXN"],"type":"string"},{"type":"null"}],"default":"USD","description":"Currency of the money columns (default USD).","title":"Currency"},"marketplaces":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only these marketplaces, comma separated (default all).","title":"Marketplaces"},"brand_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these brand ids, comma separated.","title":"Brand Ids"},"product_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these product ids (ASIN, Walmart item id, Shopify variant id), comma separated.","title":"Product Ids"},"creator_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these creator ids, comma separated.","title":"Creator Ids"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Rows per page (1 to 100, default 25).","title":"Limit"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's cursor field.","title":"Cursor"}},"required":["start","end"],"title":"get_performance_by_productArguments","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_performance_by_brand":{"post":{"operationId":"get_performance_by_brand","summary":"Get clicks, sales, commission and conversions per brand for a period. Use for \"Which of my brands earns the most through","description":"Get clicks, sales, commission and conversions per brand for a period. Use for \"Which of my brands earns the most through Levanta\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start":{"description":"Start of the period, UTC, YYYY-MM-DDTHH:mm:ss.SSSZ.","maxLength":30,"title":"Start","type":"string"},"end":{"description":"End of the period, UTC, YYYY-MM-DDTHH:mm:ss.SSSZ.","maxLength":30,"title":"End","type":"string"},"currency":{"anyOf":[{"enum":["USD","GBP","CAD","EUR","MXN"],"type":"string"},{"type":"null"}],"default":"USD","description":"Currency of the money columns (default USD).","title":"Currency"},"marketplaces":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only these marketplaces, comma separated (default all).","title":"Marketplaces"},"brand_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these brand ids, comma separated.","title":"Brand Ids"},"product_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these product ids (ASIN, Walmart item id, Shopify variant id), comma separated.","title":"Product Ids"},"creator_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these creator ids, comma separated.","title":"Creator Ids"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Rows per page (1 to 100, default 25).","title":"Limit"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's cursor field.","title":"Cursor"}},"required":["start","end"],"title":"get_performance_by_brandArguments","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_performance_by_creator":{"post":{"operationId":"get_performance_by_creator","summary":"Get clicks, sales, commission and conversions per creator id for a period (creator names are left out). Use for \"Which L","description":"Get clicks, sales, commission and conversions per creator id for a period (creator names are left out). Use for \"Which Levanta creators drive the most sales\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start":{"description":"Start of the period, UTC, YYYY-MM-DDTHH:mm:ss.SSSZ.","maxLength":30,"title":"Start","type":"string"},"end":{"description":"End of the period, UTC, YYYY-MM-DDTHH:mm:ss.SSSZ.","maxLength":30,"title":"End","type":"string"},"currency":{"anyOf":[{"enum":["USD","GBP","CAD","EUR","MXN"],"type":"string"},{"type":"null"}],"default":"USD","description":"Currency of the money columns (default USD).","title":"Currency"},"marketplaces":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only these marketplaces, comma separated (default all).","title":"Marketplaces"},"brand_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these brand ids, comma separated.","title":"Brand Ids"},"product_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these product ids (ASIN, Walmart item id, Shopify variant id), comma separated.","title":"Product Ids"},"creator_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these creator ids, comma separated.","title":"Creator Ids"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Rows per page (1 to 100, default 25).","title":"Limit"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's cursor field.","title":"Cursor"}},"required":["start","end"],"title":"get_performance_by_creatorArguments","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_conversions":{"post":{"operationId":"list_conversions","summary":"List affiliate conversions (Walmart, Shopify, Wayfair) with date, quantity, sales, commission, status, creator id and pr","description":"List affiliate conversions (Walmart, Shopify, Wayfair) with date, quantity, sales, commission, status, creator id and product; order ids are left out. Use for \"Which Levanta conversions are still pending\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start":{"description":"Start of the period, UTC, YYYY-MM-DDTHH:mm:ss.SSSZ.","maxLength":30,"title":"Start","type":"string"},"end":{"description":"End of the period, UTC, YYYY-MM-DDTHH:mm:ss.SSSZ.","maxLength":30,"title":"End","type":"string"},"marketplaces":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only these marketplaces, comma separated.","title":"Marketplaces"},"brand_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these brand ids, comma separated.","title":"Brand Ids"},"product_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these product ids (ASIN, Walmart item id, Shopify variant id), comma separated.","title":"Product Ids"},"creator_ids":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Only these creator ids, comma separated.","title":"Creator Ids"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"Rows per page (1 to 500, default 100).","title":"Limit"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's cursor field.","title":"Cursor"}},"required":["start","end"],"title":"list_conversionsArguments","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}}}}