{"openapi":"3.1.0","info":{"title":"Imgix (BYOK) API","version":"0.1.0","description":"Imgix (BYOK) lets an AI assistant read your own Imgix data through the Imgix API with a key you supply (Imgix Management API key). Read-only: 5 tools (list_sources, get_source, list_assets, list_reports, get_report). 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.imgix.com. Unofficial connector by Unify...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-imgix.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-imgix/docs"},"termsOfService":"https://connectorbay.com/byok-imgix/terms"},"servers":[{"url":"https://byok-imgix.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-imgix/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_sources":{"post":{"operationId":"list_sources","summary":"List the Imgix sources (image storage connections) of the account with deployment type, domains and enabled state. The s","description":"List the Imgix sources (image storage connections) of the account with deployment type, domains and enabled state. The secret URL signing token is not returned. Use for \"Which Imgix sources do I have and are they enabled\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sort":{"anyOf":[{"enum":["name","-name","enabled","-enabled","date_deployed","-date_deployed"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by name, enabled or date_deployed; prefix with - for descending.","title":"Sort"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many results to return per page.","title":"Page Size"},"page_number":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Zero-based page number.","title":"Page Number"}},"title":"list_sourcesArguments","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_source":{"post":{"operationId":"get_source","summary":"Get one Imgix source: name, enabled state, deployment status and type, Imgix subdomains and custom domains. Use for \"Sho","description":"Get one Imgix source: name, enabled state, deployment status and type, Imgix subdomains and custom domains. Use for \"Show the settings of this Imgix source\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"source_id":{"description":"Imgix source ID (from list_sources), for example '5d46fb3bd596f100018e123f'.","maxLength":40,"title":"Source Id","type":"string"}},"required":["source_id"],"title":"get_sourceArguments","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_assets":{"post":{"operationId":"list_assets","summary":"List assets of an Imgix source from the Asset Manager with path, type, size, dimensions, tags and dates (Asset Manager a","description":"List assets of an Imgix source from the Asset Manager with path, type, size, dimensions, tags and dates (Asset Manager attributes need an Enterprise plan). Cursor paging. Use for \"What images are in this Imgix source tagged 'dog'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"source_id":{"description":"Imgix source ID (from list_sources), for example '5d46fb3bd596f100018e123f'.","maxLength":40,"title":"Source Id","type":"string"},"keyword":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Search text across path, name and description.","title":"Keyword"},"tags":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only assets with all of these comma-separated tags.","title":"Tags"},"media_kind":{"anyOf":[{"enum":["IMAGE","ANIMATION","DOCUMENT","VECTOR"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this kind of asset.","title":"Media Kind"},"sort":{"anyOf":[{"enum":["date_created","-date_created","date_modified","-date_modified","file_size","-file_size"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by date_created, date_modified or file_size; prefix with - for descending.","title":"Sort"},"cursor":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: the cursor.next value of the previous answer.","title":"Cursor"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many assets to return (1 to 100).","title":"Limit"}},"required":["source_id"],"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/list_reports":{"post":{"operationId":"list_reports","summary":"List the Imgix analytics reports (CDN logs, source analytics, credit analytics) with period and download file URLs. Need","description":"List the Imgix analytics reports (CDN logs, source analytics, credit analytics) with period and download file URLs. Needs the Analytics permission. Use for \"What Imgix analytics reports are available\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"report_type":{"anyOf":[{"enum":["cdn_logs","credit_analytics_daily","credit_analytics_mtd","image_analytics","mild_errors","source_analytics"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this report type.","title":"Report Type"},"completed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to list only completed reports.","title":"Completed"},"sort":{"anyOf":[{"enum":["period_end","-period_end","period_start","-period_start","report_key","-report_key","report_type","-report_type"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by period_end, period_start, report_key or report_type; prefix with - for descending.","title":"Sort"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many results to return per page.","title":"Page Size"},"page_number":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Zero-based page number.","title":"Page Number"}},"title":"list_reportsArguments","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_report":{"post":{"operationId":"get_report","summary":"Get one Imgix analytics report by ID with its type, period and download file URLs. Use for \"Show this Imgix report and i","description":"Get one Imgix analytics report by ID with its type, period and download file URLs. Use for \"Show this Imgix report and its files\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"report_id":{"description":"Imgix report ID (from list_reports).","maxLength":40,"title":"Report Id","type":"string"}},"required":["report_id"],"title":"get_reportArguments","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}}}}