{"openapi":"3.1.0","info":{"title":"Data World (BYOK) API","version":"0.1.0","description":"Data World (BYOK) lets an AI assistant read your own Data World data through the Data World API with a key you supply (data.world API token (read-only is enough)). Read-only: 10 tools (get_current_user, list_my_datasets, list_my_projects, list_my_organizations, list_datasets_by_owner, get_dataset, get_file_metadata, list_projects_by_owner, get_project, list_project_insights). The BYOK key travels...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-data-world.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-data-world/docs"},"termsOfService":"https://connectorbay.com/byok-data-world/terms"},"servers":[{"url":"https://byok-data-world.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-data-world/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_current_user":{"post":{"operationId":"get_current_user","summary":"Show the data.world account the token belongs to: ID, display name and dates. Use for \"Which data.world account is my to","description":"Show the data.world account the token belongs to: ID, display name and dates. Use for \"Which data.world account is my token for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_current_userArguments","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_datasets":{"post":{"operationId":"list_my_datasets","summary":"List datasets owned by the token's account with visibility, license, tags and file, table and column counts. Use for \"Wh","description":"List datasets owned by the token's account with visibility, license, tags and file, table and column counts. Use for \"Which datasets do I own on data.world\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100).","title":"Limit"},"next":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Page token from the previous answer's nextPageToken, to fetch the next page.","title":"Next"}},"title":"list_my_datasetsArguments","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_projects":{"post":{"operationId":"list_my_projects","summary":"List data.world projects owned by the token's account with objective, visibility and statistics. Use for \"Which data.wor","description":"List data.world projects owned by the token's account with objective, visibility and statistics. Use for \"Which data.world projects do I own\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100).","title":"Limit"},"next":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Page token from the previous answer's nextPageToken, to fetch the next page.","title":"Next"}},"title":"list_my_projectsArguments","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_organizations":{"post":{"operationId":"list_my_organizations","summary":"List the organizations the token's account belongs to. Use for \"Which data.world organizations am I a member of\".","description":"List the organizations the token's account belongs to. Use for \"Which data.world organizations am I a member of\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100).","title":"Limit"},"next":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Page token from the previous answer's nextPageToken, to fetch the next page.","title":"Next"}},"title":"list_my_organizationsArguments","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_datasets_by_owner":{"post":{"operationId":"list_datasets_by_owner","summary":"List the datasets of one user or organization that the token may see. Use for \"What datasets does acme have on data.worl","description":"List the datasets of one user or organization that the token may see. Use for \"What datasets does acme have on data.world\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"owner":{"description":"Account that owns the dataset or project: a user or organization ID, for example 'acme'.","maxLength":200,"title":"Owner","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100).","title":"Limit"},"next":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Page token from the previous answer's nextPageToken, to fetch the next page.","title":"Next"}},"required":["owner"],"title":"list_datasets_by_ownerArguments","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_dataset":{"post":{"operationId":"get_dataset","summary":"Get one dataset: title, description, summary, tags, license, visibility, status and file, table and column counts. Use f","description":"Get one dataset: title, description, summary, tags, license, visibility, status and file, table and column counts. Use for \"Show the data.world dataset acme/sales-2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"owner":{"description":"Account that owns the dataset or project: a user or organization ID, for example 'acme'.","maxLength":200,"title":"Owner","type":"string"},"dataset_id":{"description":"Dataset ID (the slug in its URL), for example 'sales-2026'.","maxLength":200,"title":"Dataset Id","type":"string"}},"required":["owner","dataset_id"],"title":"get_datasetArguments","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_file_metadata":{"post":{"operationId":"get_file_metadata","summary":"Get the description, labels, size and dates of one file in a dataset. Use for \"Describe the file orders.csv in data.worl","description":"Get the description, labels, size and dates of one file in a dataset. Use for \"Describe the file orders.csv in data.world dataset acme/sales-2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"owner":{"description":"Account that owns the dataset or project: a user or organization ID, for example 'acme'.","maxLength":200,"title":"Owner","type":"string"},"dataset_id":{"description":"Dataset ID (the slug in its URL), for example 'sales-2026'.","maxLength":200,"title":"Dataset Id","type":"string"},"file":{"description":"File name inside the dataset, for example 'orders.csv'.","maxLength":200,"title":"File","type":"string"}},"required":["owner","dataset_id","file"],"title":"get_file_metadataArguments","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_projects_by_owner":{"post":{"operationId":"list_projects_by_owner","summary":"List the projects of one user or organization that the token may see. Use for \"What projects does acme have on data.worl","description":"List the projects of one user or organization that the token may see. Use for \"What projects does acme have on data.world\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"owner":{"description":"Account that owns the dataset or project: a user or organization ID, for example 'acme'.","maxLength":200,"title":"Owner","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100).","title":"Limit"},"next":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Page token from the previous answer's nextPageToken, to fetch the next page.","title":"Next"}},"required":["owner"],"title":"list_projects_by_ownerArguments","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_project":{"post":{"operationId":"get_project","summary":"Get one project: title, objective, summary, tags, license, visibility and statistics. Use for \"Show the data.world proje","description":"Get one project: title, objective, summary, tags, license, visibility and statistics. Use for \"Show the data.world project acme/churn-analysis\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"owner":{"description":"Account that owns the dataset or project: a user or organization ID, for example 'acme'.","maxLength":200,"title":"Owner","type":"string"},"project_id":{"description":"Project ID (the slug in its URL).","maxLength":200,"title":"Project Id","type":"string"}},"required":["owner","project_id"],"title":"get_projectArguments","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_project_insights":{"post":{"operationId":"list_project_insights","summary":"List the insights (analyses with notes and charts) of a project with title, author and dates. Use for \"What insights are","description":"List the insights (analyses with notes and charts) of a project with title, author and dates. Use for \"What insights are in the data.world project acme/churn-analysis\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_owner":{"description":"Owner of the project.","maxLength":200,"title":"Project Owner","type":"string"},"project_id":{"description":"Project ID.","maxLength":200,"title":"Project Id","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100).","title":"Limit"},"next":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Page token from the previous answer's nextPageToken, to fetch the next page.","title":"Next"}},"required":["project_owner","project_id"],"title":"list_project_insightsArguments","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}}}}