{"openapi":"3.1.0","info":{"title":"Logz.io (BYOK) API","version":"0.1.0","description":"Logz.io (BYOK) lets an AI assistant read your own Logz.io data through the Logz.io API with a key you supply (Logz.io API token (Tools > Manage tokens > API tokens)). Read-only: 7 tools (whoami, list_associated_accounts, list_alerts, list_log_types, list_notification_endpoints, list_users, search_logs). The BYOK key travels with each request, is used for that one call only and is never stored,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-logzio.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-logzio/docs"},"termsOfService":"https://connectorbay.com/byok-logzio/terms"},"servers":[{"url":"https://byok-logzio.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-logzio/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/whoami":{"post":{"operationId":"whoami","summary":"Show the Logz.io account the token belongs to: account name and id. The answer shape is not documented, so it is returne","description":"Show the Logz.io account the token belongs to: account name and id. The answer shape is not documented, so it is returned as the API sends it, trimmed. Use for \"Which Logz.io account is my API token for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Your Logz.io API host prefix by account region: api (US), api-eu (EU), api-au (Australia), api-ca (Canada) or api-uk (UK).","enum":["api","api-eu","api-au","api-ca","api-uk"],"title":"Region","type":"string"}},"required":["region"],"title":"whoamiArguments","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_associated_accounts":{"post":{"operationId":"list_associated_accounts","summary":"List the accounts derived from the token's account: all sub-accounts and the owner account for an owner token, otherwise","description":"List the accounts derived from the token's account: all sub-accounts and the owner account for an owner token, otherwise just the one account. The answer shape is not documented, so it is returned as the API sends it, trimmed. Use for \"Which sub-accounts does my Logz.io account have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Your Logz.io API host prefix by account region: api (US), api-eu (EU), api-au (Australia), api-ca (Canada) or api-uk (UK).","enum":["api","api-eu","api-au","api-ca","api-uk"],"title":"Region","type":"string"}},"required":["region"],"title":"list_associated_accountsArguments","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_alerts":{"post":{"operationId":"list_alerts","summary":"List the log alerts with title, description, tags, enabled flag, search window in minutes, schedule and last update. Use","description":"List the log alerts with title, description, tags, enabled flag, search window in minutes, schedule and last update. Use for \"Which Logz.io alerts are enabled\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Your Logz.io API host prefix by account region: api (US), api-eu (EU), api-au (Australia), api-ca (Canada) or api-uk (UK).","enum":["api","api-eu","api-au","api-ca","api-uk"],"title":"Region","type":"string"}},"required":["region"],"title":"list_alertsArguments","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_log_types":{"post":{"operationId":"list_log_types","summary":"List the log types known to the account. Use for \"What log types does my Logz.io account receive\".","description":"List the log types known to the account. Use for \"What log types does my Logz.io account receive\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Your Logz.io API host prefix by account region: api (US), api-eu (EU), api-au (Australia), api-ca (Canada) or api-uk (UK).","enum":["api","api-eu","api-au","api-ca","api-uk"],"title":"Region","type":"string"}},"required":["region"],"title":"list_log_typesArguments","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_notification_endpoints":{"post":{"operationId":"list_notification_endpoints","summary":"List the alert notification endpoints (Slack, PagerDuty, email hooks and others) configured in the account. The answer s","description":"List the alert notification endpoints (Slack, PagerDuty, email hooks and others) configured in the account. The answer shape is not documented, so it is returned as the API sends it, trimmed. Use for \"Where do my Logz.io alerts send notifications\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Your Logz.io API host prefix by account region: api (US), api-eu (EU), api-au (Australia), api-ca (Canada) or api-uk (UK).","enum":["api","api-eu","api-au","api-ca","api-uk"],"title":"Region","type":"string"}},"required":["region"],"title":"list_notification_endpointsArguments","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_users":{"post":{"operationId":"list_users","summary":"List the users of the Logz.io account, optionally for one sub-account. The answer shape is not documented, so it is retu","description":"List the users of the Logz.io account, optionally for one sub-account. The answer shape is not documented, so it is returned as the API sends it, trimmed. Use for \"Who has access to my Logz.io account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Your Logz.io API host prefix by account region: api (US), api-eu (EU), api-au (Australia), api-ca (Canada) or api-uk (UK).","enum":["api","api-eu","api-au","api-ca","api-uk"],"title":"Region","type":"string"},"account_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Sub-account id to list users of; leave out for the token's own account.","title":"Account Id"}},"required":["region"],"title":"list_usersArguments","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/search_logs":{"post":{"operationId":"search_logs","summary":"Search the account's logs with a Lucene query string. By default only today's and yesterday's data (UTC) is searched; sh","description":"Search the account's logs with a Lucene query string. By default only today's and yesterday's data (UTC) is searched; shift the window with day_offset or add a timestamp range to the query. Wildcards must not start with * or ?. Returns the raw search response, trimmed. Use for \"Find error logs from the checkout service in my Logz.io account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Your Logz.io API host prefix by account region: api (US), api-eu (EU), api-au (Australia), api-ca (Canada) or api-uk (UK).","enum":["api","api-eu","api-au","api-ca","api-uk"],"title":"Region","type":"string"},"query":{"description":"Lucene query string, for example 'level:error AND service:checkout'.","maxLength":500,"title":"Query","type":"string"},"size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many log records to return (1 to 1000).","title":"Size"},"allow_leading_wildcard":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"Leave false: Logz.io requires leading wildcards (a query term starting with * or ?) to be disallowed.","title":"Allow Leading Wildcard"},"day_offset":{"anyOf":[{"maximum":90,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Move the two-day search window back by this many days (0 means today and yesterday).","title":"Day Offset"}},"required":["region","query"],"title":"search_logsArguments","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}}}}