{"openapi":"3.1.0","info":{"title":"Omise (BYOK) API","version":"0.1.0","description":"Omise (BYOK) lets an AI assistant read your own Omise data through the Omise API with a key you supply (secret key (skey_...)). Read-only: 5 tools (get_account, get_capability_limits, list_payment_methods, get_forex_rate, list_transfer_schedules). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.omise.co....\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-omise-config.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-omise-config/docs"},"termsOfService":"https://connectorbay.com/byok-omise-config/terms"},"servers":[{"url":"https://byok-omise-config.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-omise-config/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/get_account":{"post":{"operationId":"get_account","summary":"Show the merchant account settings: country, funding currency, supported currencies, API version, webhook URI, installme","description":"Show the merchant account settings: country, funding currency, supported currencies, API version, webhook URI, installment and chaining flags. The account email is not returned. Use for \"What country, currency and webhook URL does my Omise account use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_accountArguments","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_capability_limits":{"post":{"operationId":"get_capability_limits","summary":"Show what the account may process: registration country, minimum and maximum charge, transfer and installment amounts (s","description":"Show what the account may process: registration country, minimum and maximum charge, transfer and installment amounts (smallest currency unit), supported transfer banks and tokenization methods. Use for \"What are my Omise charge limits and which banks can I pay out to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_capability_limitsArguments","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_payment_methods":{"post":{"operationId":"list_payment_methods","summary":"List every payment method the account can accept (cards, wallets, internet banking, installments, QR) with currencies, c","description":"List every payment method the account can accept (cards, wallets, internet banking, installments, QR) with currencies, card brands and installment terms. Use for \"Which payment methods and installment terms does my Omise account support\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_payment_methodsArguments","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_forex_rate":{"post":{"operationId":"get_forex_rate","summary":"Get the current exchange rate from a foreign currency into the account's funding currency. Only works when multi-currenc","description":"Get the current exchange rate from a foreign currency into the account's funding currency. Only works when multi-currency is enabled on the account. Use for \"What is the current Omise exchange rate for USD\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"currency":{"description":"Lowercase three-letter ISO 4217 code of the base currency, for example 'usd'.","maxLength":200,"title":"Currency","type":"string"}},"required":["currency"],"title":"get_forex_rateArguments","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_transfer_schedules":{"post":{"operationId":"list_transfer_schedules","summary":"List the account's automatic transfer (payout) schedules: amount or percentage of balance, currency, recipient id and wh","description":"List the account's automatic transfer (payout) schedules: amount or percentage of balance, currency, recipient id and whether payouts are real time. Use for \"How are my Omise payouts scheduled\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many schedules to return (1 to 100, default 20).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many schedules to skip from the beginning.","title":"Offset"},"order":{"anyOf":[{"enum":["chronological","reverse_chronological"],"type":"string"},{"type":"null"}],"default":null,"description":"chronological (oldest first) or reverse_chronological.","title":"Order"}},"title":"list_transfer_schedulesArguments","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}}}}