{"openapi":"3.1.0","info":{"title":"Sketchfab (BYOK) API","version":"0.1.0","description":"Sketchfab (BYOK) lets an AI assistant read your own Sketchfab data through the Sketchfab API with a key you supply (Sketchfab API token). Read-only: 11 tools (get_me, get_my_account, list_my_models, list_my_collections, search_models, list_models, get_model, list_categories, list_collections, get_collection, list_collection_models). The BYOK key travels with each request, is used for that one...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sketchfab.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sketchfab/docs"},"termsOfService":"https://connectorbay.com/byok-sketchfab/terms"},"servers":[{"url":"https://byok-sketchfab.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sketchfab/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_me":{"post":{"operationId":"get_me","summary":"Show the Sketchfab profile of the token's owner: username, display name, counts of models, collections, followers and li","description":"Show the Sketchfab profile of the token's owner: username, display name, counts of models, collections, followers and likes. Email and the API token itself are not returned. Use for \"Which Sketchfab account is my token for and how many models do I have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_meArguments","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_my_account":{"post":{"operationId":"get_my_account","summary":"Show the plan limits of the Sketchfab account: plan name, upload size limit, private model and view-only limits and rene","description":"Show the plan limits of the Sketchfab account: plan name, upload size limit, private model and view-only limits and renewal date. Use for \"What are my Sketchfab plan limits\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_my_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/list_my_models":{"post":{"operationId":"list_my_models","summary":"List your own Sketchfab models (the first page) with views, likes, polygon counts and viewer URLs. Use for \"Which 3D mod","description":"List your own Sketchfab models (the first page) with views, likes, polygon counts and viewer URLs. Use for \"Which 3D models have I uploaded to Sketchfab\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_my_modelsArguments","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_my_collections":{"post":{"operationId":"list_my_collections","summary":"List your own Sketchfab collections with model counts and dates. Use for \"Which Sketchfab collections do I have\".","description":"List your own Sketchfab collections with model counts and dates. Use for \"Which Sketchfab collections do I have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_my_collectionsArguments","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_models":{"post":{"operationId":"search_models","summary":"Search public Sketchfab 3D models by keywords with optional filters; returns metadata and viewer URLs only (no downloads","description":"Search public Sketchfab 3D models by keywords with optional filters; returns metadata and viewer URLs only (no downloads). Use for \"Find downloadable low poly tree models on Sketchfab\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"type":{"anyOf":[{"const":"models","type":"string"},{"type":"null"}],"default":"models","description":"Kind of result; only models is supported by this tool.","title":"Type"},"q":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Space-separated keywords, for example 'low poly tree'.","title":"Q"},"user":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only models by this username.","title":"User"},"downloadable":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to list only downloadable models.","title":"Downloadable"},"animated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to list only animated models.","title":"Animated"},"staffpicked":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to list only staff picks.","title":"Staffpicked"},"max_face_count":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only models with at most this many faces.","title":"Max Face Count"},"license":{"anyOf":[{"enum":["by","by-sa","by-nd","by-nc","by-nc-sa","by-nc-nd","cc0","ed","st"],"type":"string"},{"type":"null"}],"default":null,"description":"Only models under this license code.","title":"License"},"date":{"anyOf":[{"enum":[1,7,31],"type":"integer"},{"type":"null"}],"default":null,"description":"Only models published in the last 1, 7 or 31 days.","title":"Date"},"sort_by":{"anyOf":[{"enum":["likeCount","-likeCount","viewCount","-viewCount","publishedAt","-publishedAt","processedAt","-processedAt"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by likeCount, viewCount, publishedAt or processedAt; prefix with - for descending. Without it results are ranked by relevance.","title":"Sort By"}},"title":"search_modelsArguments","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_models":{"post":{"operationId":"list_models","summary":"List recently published public Sketchfab models, optionally for one user, newest first by default. Use for \"What new 3D ","description":"List recently published public Sketchfab models, optionally for one user, newest first by default. Use for \"What new 3D models were published on Sketchfab\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"user":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only models by this username.","title":"User"},"sort_by":{"anyOf":[{"enum":["createdAt","-createdAt","viewCount","-viewCount"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by createdAt or viewCount; prefix with - for descending.","title":"Sort By"},"staffpicked":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to list only staff picks.","title":"Staffpicked"},"downloadable":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to list only downloadable models.","title":"Downloadable"},"animated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to list only animated models.","title":"Animated"}},"title":"list_modelsArguments","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_model":{"post":{"operationId":"get_model","summary":"Get one public Sketchfab model by UID: description, tags, categories, polygon and texture counts, views, likes, creator ","description":"Get one public Sketchfab model by UID: description, tags, categories, polygon and texture counts, views, likes, creator and viewer URL. Use for \"Show details of this Sketchfab 3D model\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"uid":{"description":"Sketchfab model UID (32 hex characters, from a search or list), for example '7w7pAitdq5Ybm0ZG3hVmcWVKFFB'.","maxLength":60,"title":"Uid","type":"string"}},"required":["uid"],"title":"get_modelArguments","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_categories":{"post":{"operationId":"list_categories","summary":"List the Sketchfab model categories with their slugs and UIDs. Use for \"What categories does Sketchfab have\".","description":"List the Sketchfab model categories with their slugs and UIDs. Use for \"What categories does Sketchfab have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sort_by":{"anyOf":[{"enum":["slug","-slug"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by slug; prefix with - for descending.","title":"Sort By"}},"title":"list_categoriesArguments","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_collections":{"post":{"operationId":"list_collections","summary":"List public Sketchfab collections, optionally of one user, with model counts. Use for \"What Sketchfab collections exist ","description":"List public Sketchfab collections, optionally of one user, with model counts. Use for \"What Sketchfab collections exist for this user\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"user":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only collections created by this username.","title":"User"},"sort_by":{"anyOf":[{"enum":["createdAt","-createdAt","subscriberCount","-subscriberCount"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by createdAt or subscriberCount; prefix with - for descending.","title":"Sort By"}},"title":"list_collectionsArguments","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_collection":{"post":{"operationId":"get_collection","summary":"Get one public Sketchfab collection by UID with name, description, model count and owner. Use for \"Show this Sketchfab c","description":"Get one public Sketchfab collection by UID with name, description, model count and owner. Use for \"Show this Sketchfab collection\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"uid":{"description":"Sketchfab collection UID (from list_collections).","maxLength":60,"title":"Uid","type":"string"}},"required":["uid"],"title":"get_collectionArguments","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_collection_models":{"post":{"operationId":"list_collection_models","summary":"List the models in a public Sketchfab collection (first page). Use for \"Which models are in this Sketchfab collection\".","description":"List the models in a public Sketchfab collection (first page). Use for \"Which models are in this Sketchfab collection\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"uid":{"description":"Sketchfab collection UID (from list_collections).","maxLength":60,"title":"Uid","type":"string"}},"required":["uid"],"title":"list_collection_modelsArguments","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}}}}