{"openapi":"3.1.0","info":{"title":"Tolt (BYOK) API","version":"0.1.0","description":"Tolt (BYOK) lets an AI assistant read your own Tolt data through the Tolt API with a key you supply (Tolt API key). Read-only: 9 tools (list_programs, list_partners, get_partner, list_links, list_commissions, get_commission, list_transactions, get_transaction, list_promotion_codes). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-tolt.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-tolt/docs"},"termsOfService":"https://connectorbay.com/byok-tolt/terms"},"servers":[{"url":"https://byok-tolt.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-tolt/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_programs":{"post":{"operationId":"list_programs","summary":"List the affiliate programs of the organization with status and currency. Use for \"Which affiliate programs do I run in ","description":"List the affiliate programs of the organization with status and currency. Use for \"Which affiliate programs do I run in Tolt\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_programsArguments","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_partners":{"post":{"operationId":"list_partners","summary":"List the affiliate partners of a program with name, email, company, status, country and creation date. An email filter l","description":"List the affiliate partners of a program with name, email, company, status, country and creation date. An email filter looks up one partner. Payout details are left out. Use for \"Who are the active affiliate partners in my Tolt program\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"program_id":{"description":"Tolt program id (from list_programs), for example 'prg_abc123'.","maxLength":60,"title":"Program Id","type":"string"},"email":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Return only the partner with this exact email (case-insensitive).","title":"Email"},"group_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only partners of this group id.","title":"Group Id"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by creation time: desc (default) or asc.","title":"Order"},"created_after":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only records created after this date (ISO 8601, for example 2026-01-01).","title":"Created After"},"created_before":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only records created before this date (ISO 8601).","title":"Created Before"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many records to return (1 to 100, default 10).","title":"Limit"},"starting_after":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: id of the last record of the previous page.","title":"Starting After"}},"required":["program_id"],"title":"list_partnersArguments","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_partner":{"post":{"operationId":"get_partner","summary":"Get one partner with status, country and dates; optionally include performance stats (clicks, leads, customers, revenue ","description":"Get one partner with status, country and dates; optionally include performance stats (clicks, leads, customers, revenue and commission totals). Use for \"How much revenue has Tolt partner part_abc brought in\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"partner_id":{"description":"Tolt partner id, for example 'part_abc'.","maxLength":60,"title":"Partner Id","type":"string"},"include_stats":{"anyOf":[{"const":"stats","type":"string"},{"type":"null"}],"default":null,"description":"Pass 'stats' to include total clicks, leads, customers, revenue and commission.","title":"Include Stats"}},"required":["partner_id"],"title":"get_partnerArguments","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_links":{"post":{"operationId":"list_links","summary":"List the affiliate tracking links of a program (tracking parameter and value per partner). Use for \"Which tracking links","description":"List the affiliate tracking links of a program (tracking parameter and value per partner). Use for \"Which tracking links do my Tolt partners use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"program_id":{"description":"Tolt program id (from list_programs), for example 'prg_abc123'.","maxLength":60,"title":"Program Id","type":"string"},"partner_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only records of this partner id (from list_partners).","title":"Partner Id"},"param":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only links using this tracking parameter, for example 'ref'.","title":"Param"},"value":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only links with this tracking value.","title":"Value"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by creation time: desc (default) or asc.","title":"Order"},"created_after":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only records created after this date (ISO 8601, for example 2026-01-01).","title":"Created After"},"created_before":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only records created before this date (ISO 8601).","title":"Created Before"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many records to return (1 to 100, default 10).","title":"Limit"},"starting_after":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: id of the last record of the previous page.","title":"Starting After"}},"required":["program_id"],"title":"list_linksArguments","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_commissions":{"post":{"operationId":"list_commissions","summary":"List the commissions of a program with amount, revenue, source, status and the customer and transaction they came from. ","description":"List the commissions of a program with amount, revenue, source, status and the customer and transaction they came from. Use for \"Which Tolt commissions are still pending\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"program_id":{"description":"Tolt program id (from list_programs), for example 'prg_abc123'.","maxLength":60,"title":"Program Id","type":"string"},"partner_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only records of this partner id (from list_partners).","title":"Partner Id"},"customer_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only commissions of this customer id.","title":"Customer Id"},"transaction_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only commissions of this transaction id.","title":"Transaction Id"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by creation time: desc (default) or asc.","title":"Order"},"created_after":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only records created after this date (ISO 8601, for example 2026-01-01).","title":"Created After"},"created_before":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only records created before this date (ISO 8601).","title":"Created Before"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many records to return (1 to 100, default 10).","title":"Limit"},"starting_after":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: id of the last record of the previous page.","title":"Starting After"}},"required":["program_id"],"title":"list_commissionsArguments","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_commission":{"post":{"operationId":"get_commission","summary":"Get one commission by id. Use for \"Show Tolt commission com_1\".","description":"Get one commission by id. Use for \"Show Tolt commission com_1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"commission_id":{"description":"Tolt commission id, from list_commissions.","maxLength":60,"title":"Commission Id","type":"string"}},"required":["commission_id"],"title":"get_commissionArguments","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_transactions":{"post":{"operationId":"list_transactions","summary":"List the referred-customer payments (transactions) of a program with amount, billing interval, source and partner. Use f","description":"List the referred-customer payments (transactions) of a program with amount, billing interval, source and partner. Use for \"What payments came through Tolt partners this month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"program_id":{"description":"Tolt program id (from list_programs), for example 'prg_abc123'.","maxLength":60,"title":"Program Id","type":"string"},"partner_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only records of this partner id (from list_partners).","title":"Partner Id"},"customer_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only transactions of this customer id.","title":"Customer Id"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by creation time: desc (default) or asc.","title":"Order"},"created_after":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only records created after this date (ISO 8601, for example 2026-01-01).","title":"Created After"},"created_before":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only records created before this date (ISO 8601).","title":"Created Before"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many records to return (1 to 100, default 10).","title":"Limit"},"starting_after":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: id of the last record of the previous page.","title":"Starting After"}},"required":["program_id"],"title":"list_transactionsArguments","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_transaction":{"post":{"operationId":"get_transaction","summary":"Get one transaction by id. Use for \"Show Tolt transaction txn_1\".","description":"Get one transaction by id. Use for \"Show Tolt transaction txn_1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"transaction_id":{"description":"Tolt transaction id, from list_transactions.","maxLength":60,"title":"Transaction Id","type":"string"}},"required":["transaction_id"],"title":"get_transactionArguments","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_promotion_codes":{"post":{"operationId":"list_promotion_codes","summary":"List the promotion codes of a program with type, value and owning partner. Use for \"Which promo codes do my Tolt partner","description":"List the promotion codes of a program with type, value and owning partner. Use for \"Which promo codes do my Tolt partners have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"program_id":{"description":"Tolt program id (from list_programs), for example 'prg_abc123'.","maxLength":60,"title":"Program Id","type":"string"},"partner_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only records of this partner id (from list_partners).","title":"Partner Id"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only codes matching this text.","title":"Search"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by creation time: desc (default) or asc.","title":"Order"},"created_after":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only records created after this date (ISO 8601, for example 2026-01-01).","title":"Created After"},"created_before":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only records created before this date (ISO 8601).","title":"Created Before"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many records to return (1 to 100, default 10).","title":"Limit"},"starting_after":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: id of the last record of the previous page.","title":"Starting After"}},"required":["program_id"],"title":"list_promotion_codesArguments","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}}}}