{"openapi":"3.1.0","info":{"title":"O*NET (BYOK) API","version":"0.1.0","description":"O*NET (BYOK) lets an AI assistant read your own O*NET data through the O*NET API with a key you supply (O*NET Web Services API key). Read-only: 11 tools (search_occupations, list_occupations, get_occupation, list_occupation_skills, list_occupation_knowledge, list_occupation_tasks, list_occupation_technology, list_related_occupations, get_occupation_job_zone, crosswalk_soc, convert_taxonomy_code)....\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-onet.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-onet/docs"},"termsOfService":"https://connectorbay.com/byok-onet/terms"},"servers":[{"url":"https://byok-onet.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-onet/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/search_occupations":{"post":{"operationId":"search_occupations","summary":"Search O*NET occupations by keyword in titles and related terms; returns code, title and the bright-outlook tag. Use for","description":"Search O*NET occupations by keyword in titles and related terms; returns code, title and the bright-outlook tag. Use for \"Which O*NET occupations match 'data scientist'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keyword":{"description":"Words to search for, for example 'data scientist'.","maxLength":200,"title":"Keyword","type":"string"},"start":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Index of the first result to return (1 for the first; default 1).","title":"Start"},"end":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the last result to return, for paging; leave out for the service default page size.","title":"End"}},"required":["keyword"],"title":"search_occupationsArguments","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_occupations":{"post":{"operationId":"list_occupations","summary":"List all O*NET occupations in order of title, code or job zone, with job zone and bright-outlook flags. Use for \"List O*","description":"List all O*NET occupations in order of title, code or job zone, with job zone and bright-outlook flags. Use for \"List O*NET occupations in job zone order\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sort":{"anyOf":[{"enum":["title","code","zone"],"type":"string"},{"type":"null"}],"default":"title","description":"Order by title, code or zone.","title":"Sort"},"start":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Index of the first result to return (1 for the first; default 1).","title":"Start"},"end":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the last result to return, for paging; leave out for the service default page size.","title":"End"}},"title":"list_occupationsArguments","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_occupation":{"post":{"operationId":"get_occupation","summary":"Get the overview of one occupation: title, description, sample job titles, related occupations and what other reports ex","description":"Get the overview of one occupation: title, description, sample job titles, related occupations and what other reports exist for it. Use for \"Describe O*NET occupation 15-1252.00\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"code":{"description":"O*NET-SOC occupation code such as '15-1252.00' (software developers).","maxLength":200,"title":"Code","type":"string"}},"required":["code"],"title":"get_occupationArguments","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_occupation_skills":{"post":{"operationId":"list_occupation_skills","summary":"List the key skills of an occupation (summary report) with each skill's name and definition. Use for \"Which skills matte","description":"List the key skills of an occupation (summary report) with each skill's name and definition. Use for \"Which skills matter most for software developers in O*NET\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"code":{"description":"O*NET-SOC occupation code such as '15-1252.00' (software developers).","maxLength":200,"title":"Code","type":"string"},"start":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Index of the first result to return (1 for the first; default 1).","title":"Start"},"end":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the last result to return, for paging; leave out for the service default page size.","title":"End"}},"required":["code"],"title":"list_occupation_skillsArguments","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_occupation_knowledge":{"post":{"operationId":"list_occupation_knowledge","summary":"List the key knowledge areas of an occupation (summary report) with names and definitions. Use for \"What knowledge areas","description":"List the key knowledge areas of an occupation (summary report) with names and definitions. Use for \"What knowledge areas does O*NET list for registered nurses (29-1141.00)\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"code":{"description":"O*NET-SOC occupation code such as '15-1252.00' (software developers).","maxLength":200,"title":"Code","type":"string"},"start":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Index of the first result to return (1 for the first; default 1).","title":"Start"},"end":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the last result to return, for paging; leave out for the service default page size.","title":"End"}},"required":["code"],"title":"list_occupation_knowledgeArguments","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_occupation_tasks":{"post":{"operationId":"list_occupation_tasks","summary":"List the typical tasks of an occupation (summary report). Use for \"What tasks do O*NET occupation 11-9021.00 constructio","description":"List the typical tasks of an occupation (summary report). Use for \"What tasks do O*NET occupation 11-9021.00 construction managers perform\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"code":{"description":"O*NET-SOC occupation code such as '15-1252.00' (software developers).","maxLength":200,"title":"Code","type":"string"},"start":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Index of the first result to return (1 for the first; default 1).","title":"Start"},"end":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the last result to return, for paging; leave out for the service default page size.","title":"End"}},"required":["code"],"title":"list_occupation_tasksArguments","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_occupation_technology":{"post":{"operationId":"list_occupation_technology","summary":"List technology categories and example tools (software, equipment) used in an occupation, flagging hot and in-demand tec","description":"List technology categories and example tools (software, equipment) used in an occupation, flagging hot and in-demand technologies. Use for \"Which software do O*NET data analysts use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"code":{"description":"O*NET-SOC occupation code such as '15-1252.00' (software developers).","maxLength":200,"title":"Code","type":"string"},"start":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Index of the first result to return (1 for the first; default 1).","title":"Start"},"end":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the last result to return, for paging; leave out for the service default page size.","title":"End"}},"required":["code"],"title":"list_occupation_technologyArguments","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_related_occupations":{"post":{"operationId":"list_related_occupations","summary":"List occupations related to a given occupation. Use for \"Which occupations are related to software developers in O*NET\".","description":"List occupations related to a given occupation. Use for \"Which occupations are related to software developers in O*NET\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"code":{"description":"O*NET-SOC occupation code such as '15-1252.00' (software developers).","maxLength":200,"title":"Code","type":"string"},"start":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Index of the first result to return (1 for the first; default 1).","title":"Start"},"end":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the last result to return, for paging; leave out for the service default page size.","title":"End"}},"required":["code"],"title":"list_related_occupationsArguments","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_occupation_job_zone":{"post":{"operationId":"get_occupation_job_zone","summary":"Get the job zone of an occupation: typical education, related experience, training and examples. Use for \"What preparati","description":"Get the job zone of an occupation: typical education, related experience, training and examples. Use for \"What preparation level does O*NET assign to occupation 15-1252.00\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"code":{"description":"O*NET-SOC occupation code such as '15-1252.00' (software developers).","maxLength":200,"title":"Code","type":"string"}},"required":["code"],"title":"get_occupation_job_zoneArguments","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/crosswalk_soc":{"post":{"operationId":"crosswalk_soc","summary":"Find O*NET occupations that match a Standard Occupational Classification (SOC) code or title. Use for \"Which O*NET occup","description":"Find O*NET occupations that match a Standard Occupational Classification (SOC) code or title. Use for \"Which O*NET occupations map to SOC code 15-1252\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keyword":{"description":"SOC code or title to look up, for example '15-1252' or 'software developers'.","maxLength":100,"title":"Keyword","type":"string"},"start":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Index of the first result to return (1 for the first; default 1).","title":"Start"},"end":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the last result to return, for paging; leave out for the service default page size.","title":"End"}},"required":["keyword"],"title":"crosswalk_socArguments","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/convert_taxonomy_code":{"post":{"operationId":"convert_taxonomy_code","summary":"Translate an O*NET-SOC code between taxonomy versions (2010, 2019 or the active one). Use for \"What is the active O*NET-","description":"Translate an O*NET-SOC code between taxonomy versions (2010, 2019 or the active one). Use for \"What is the active O*NET-SOC code for 2010 code 15-1132.00\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"source":{"description":"Taxonomy version the code belongs to: 2010, 2019 or active.","enum":["2010","2019","active"],"title":"Source","type":"string"},"target":{"description":"Taxonomy version to translate to: 2010, 2019 or active.","enum":["2010","2019","active"],"title":"Target","type":"string"},"code":{"description":"O*NET-SOC code in the source taxonomy, for example '15-1132.00'.","maxLength":200,"title":"Code","type":"string"}},"required":["source","target","code"],"title":"convert_taxonomy_codeArguments","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}}}}