{"openapi":"3.1.0","info":{"title":"HR Partner (BYOK) API","version":"0.1.0","description":"HR Partner (BYOK) lets an AI assistant read your own HR Partner data through the HR Partner API with a key you supply (HR Partner company API key (API access must be switched on in the company)). Read-only: 12 tools (get_company, list_employees, get_employee, list_leave_requests, get_leave_request, list_leave_balances, list_checklists, list_goals, list_job_listings, list_training,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-hrpartner.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-hrpartner/docs"},"termsOfService":"https://connectorbay.com/byok-hrpartner/terms"},"servers":[{"url":"https://byok-hrpartner.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-hrpartner/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_company":{"post":{"operationId":"get_company","summary":"Show the HR Partner company the key belongs to: name, subscription expiry, employee limit, total and active employee cou","description":"Show the HR Partner company the key belongs to: name, subscription expiry, employee limit, total and active employee counts and time zone. Use for \"Which HR Partner company is this key for and how many active employees does it have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"active_modules":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to also include which product modules are enabled.","title":"Active Modules"}},"title":"get_companyArguments","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_employees":{"post":{"operationId":"list_employees","summary":"List employees with code, name, status flags, department, location, group, position, employment status and start and end","description":"List employees with code, name, status flags, department, location, group, position, employment status and start and end dates. Pay, tax and birth data are left out. Not paged: the answer is cut to the first 100 records, so narrow it with filters. Use for \"Which active employees work in the Sales department\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only employees whose first or last name matches this text.","title":"Search"},"department":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only records for this department name, or several separated by commas.","title":"Department"},"location":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only records for this location name, or several separated by commas.","title":"Location"},"group":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only employees in this group (may be labelled branch or entity in your company).","title":"Group"},"position":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only employees with this position title.","title":"Position"},"employment_status":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only employees with this employment status, for example 'Full Time'.","title":"Employment Status"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for only active employees, false for only inactive ones.","title":"Is Active"},"is_terminated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for only terminated employees, false to exclude them.","title":"Is Terminated"},"start_date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only employees who started on or after this date. Format yyyy-mm-dd.","title":"Start Date From"},"start_date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only employees who started on or before this date. Format yyyy-mm-dd.","title":"Start Date To"},"reports_to":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only employees who report to the employee with this code.","title":"Reports To"}},"title":"list_employeesArguments","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_employee":{"post":{"operationId":"get_employee","summary":"Get one employee by employee code: name, status flags, department, location, group, position, employment status, manager","description":"Get one employee by employee code: name, status flags, department, location, group, position, employment status, manager code and start and end dates. Pay, tax, birth, custom, contact and address data are left out. Use for \"Show the HR Partner record for employee code BLENA\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"employee_code":{"description":"The employee code from list_employees, for example 'BLENA'.","maxLength":60,"title":"Employee Code","type":"string"}},"required":["employee_code"],"title":"get_employeeArguments","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_leave_requests":{"post":{"operationId":"list_leave_requests","summary":"List leave requests with leave policy, status, start and end dates, duration and the employee. Free-text reasons and app","description":"List leave requests with leave policy, status, start and end dates, duration and the employee. Free-text reasons and approver notes are left out. Not paged: the answer is cut to the first 100 records, so narrow it with filters. Use for \"Which leave requests are waiting for approval\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"employee":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only records of the employee with this employee code (the code field from list_employees).","title":"Employee"},"department":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only records for this department name, or several separated by commas.","title":"Department"},"location":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only records for this location name, or several separated by commas.","title":"Location"},"status":{"anyOf":[{"enum":["submitted","pending","approved","rejected","revoked","withdrawn"],"type":"string"},{"type":"null"}],"default":null,"description":"Request status.","title":"Status"},"leave_request_type":{"anyOf":[{"enum":["taken","added"],"type":"string"},{"type":"null"}],"default":null,"description":"'taken' for time off or 'added' for TOIL/flexi additions.","title":"Leave Request Type"},"absence_reason":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only requests against this leave policy name, for example 'Annual Leave'.","title":"Absence Reason"},"leave_start_date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only requests starting on or after this date. Format yyyy-mm-dd.","title":"Leave Start Date From"},"leave_start_date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only requests starting on or before this date. Format yyyy-mm-dd.","title":"Leave Start Date To"}},"title":"list_leave_requestsArguments","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_leave_request":{"post":{"operationId":"get_leave_request","summary":"Get one leave request by its id with policy, status, dates, duration and the employee. Free-text reasons and notes are l","description":"Get one leave request by its id with policy, status, dates, duration and the employee. Free-text reasons and notes are left out. Use for \"Show HR Partner leave request 144\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"leave_request_id":{"description":"Leave request id from list_leave_requests.","maxLength":20,"title":"Leave Request Id","type":"string"}},"required":["leave_request_id"],"title":"get_leave_requestArguments","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_leave_balances":{"post":{"operationId":"list_leave_balances","summary":"List leave balances per employee and leave policy: entitlement, current balance, carry-over and units. The calculation c","description":"List leave balances per employee and leave policy: entitlement, current balance, carry-over and units. The calculation can be slow, so filter by employee or department. Not paged: the answer is cut to the first 100 records, so narrow it with filters. Use for \"How much annual leave does employee A12345 have left\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"employee":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only records of the employee with this employee code (the code field from list_employees).","title":"Employee"},"department":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only records for this department name, or several separated by commas.","title":"Department"},"location":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only records for this location name, or several separated by commas.","title":"Location"},"absence_reason":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only balances of this leave policy name, for example 'Annual Leave'.","title":"Absence Reason"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to include active employees (server default true).","title":"Is Active"},"is_terminated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to include terminated employees (server default true).","title":"Is Terminated"}},"title":"list_leave_balancesArguments","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_checklists":{"post":{"operationId":"list_checklists","summary":"List onboarding and other checklists assigned to employees with name, status, assignment and completion dates and progre","description":"List onboarding and other checklists assigned to employees with name, status, assignment and completion dates and progress percentage. Not paged: the answer is cut to the first 100 records, so narrow it with filters. Use for \"Which onboarding checklists are still incomplete\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"employee":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only records of the employee with this employee code (the code field from list_employees).","title":"Employee"},"checklist_status":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated statuses: new, incomplete, complete, archived.","title":"Checklist Status"},"checklist_template":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only checklists made from this template name.","title":"Checklist Template"},"assigned_date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only checklists assigned on or after this date. Format yyyy-mm-dd.","title":"Assigned Date From"},"assigned_date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only checklists assigned on or before this date. Format yyyy-mm-dd.","title":"Assigned Date To"}},"title":"list_checklistsArguments","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_goals":{"post":{"operationId":"list_goals","summary":"List goals with scope, type, description, target and current value, completion flags and due date. Not paged: the answer","description":"List goals with scope, type, description, target and current value, completion flags and due date. Not paged: the answer is cut to the first 100 records, so narrow it with filters. Use for \"Which employee goals are active and not yet completed\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"employee":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only records of the employee with this employee code (the code field from list_employees).","title":"Employee"},"goal_scope":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated scopes: company, employee, other.","title":"Goal Scope"},"goal_type":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated types: number, currency, counter, percentage, objective.","title":"Goal Type"},"goal_is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for only active goals.","title":"Goal Is Active"},"goal_is_completed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for only completed goals.","title":"Goal Is Completed"},"due_date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only goals due on or after this date. Format yyyy-mm-dd.","title":"Due Date From"},"due_date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only goals due on or before this date. Format yyyy-mm-dd.","title":"Due Date To"}},"title":"list_goalsArguments","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_job_listings":{"post":{"operationId":"list_job_listings","summary":"List job listings with title, summary, location, department, position, employment status, publish dates, active flag and","description":"List job listings with title, summary, location, department, position, employment status, publish dates, active flag and view count. Use for \"Which job listings are active in HR Partner\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only listings with this text in the title, summary or content.","title":"Search"},"department":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only records for this department name, or several separated by commas.","title":"Department"},"location":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only records for this location name, or several separated by commas.","title":"Location"},"position":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only listings for this position title.","title":"Position"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for only active listings.","title":"Is Active"},"publish_at_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only listings published on or after this date. Format yyyy-mm-dd.","title":"Publish At From"},"publish_at_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only listings published on or before this date. Format yyyy-mm-dd.","title":"Publish At To"}},"title":"list_job_listingsArguments","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_training":{"post":{"operationId":"list_training","summary":"List employee training records with training type, course, institution, dates, status and the employee. Comments and cos","description":"List employee training records with training type, course, institution, dates, status and the employee. Comments and costs are left out. Not paged: the answer is cut to the first 100 records, so narrow it with filters. Use for \"Who has completed First Aid training\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"employee":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only records of the employee with this employee code (the code field from list_employees).","title":"Employee"},"department":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only records for this department name, or several separated by commas.","title":"Department"},"training_type":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only records of this training type, for example 'First Aid'.","title":"Training Type"},"training_status":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only records with this status.","title":"Training Status"},"course_name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only records whose course name contains this text.","title":"Course Name"},"completion_date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only training completed on or after this date. Format yyyy-mm-dd.","title":"Completion Date From"},"completion_date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only training completed on or before this date. Format yyyy-mm-dd.","title":"Completion Date To"}},"title":"list_trainingArguments","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_anniversaries":{"post":{"operationId":"list_anniversaries","summary":"List active employees with their work anniversaries in a month range: name, position, start date and years worked. Use f","description":"List active employees with their work anniversaries in a month range: name, position, start date and years worked. Use for \"Whose work anniversary is coming up in July to December\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"department":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only records for this department name, or several separated by commas.","title":"Department"},"location":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only records for this location name, or several separated by commas.","title":"Location"},"start_month":{"anyOf":[{"maximum":12,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"First month of the range, 1 (January) to 12.","title":"Start Month"},"end_month":{"anyOf":[{"maximum":12,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Last month of the range, 1 to 12.","title":"End Month"},"selected_year":{"anyOf":[{"maximum":2100,"minimum":2000,"type":"integer"},{"type":"null"}],"default":null,"description":"Four digit year to report for; a future year forecasts length of service.","title":"Selected Year"}},"title":"list_anniversariesArguments","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_lookup_list":{"post":{"operationId":"get_lookup_list","summary":"Get one of HR Partner's dropdown lists (departments, locations, positions, leave types, tags, training types and more) t","description":"Get one of HR Partner's dropdown lists (departments, locations, positions, leave types, tags, training types and more) to find valid filter values. Use for \"Which departments exist in HR Partner\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"lookup_name":{"description":"Which list.","enum":["absence_reasons","absence_statuses","departments","locations","groups","positions","employment_statuses","tags","training_types","training_statuses","stages","review_types","review_statuses"],"title":"Lookup Name","type":"string"}},"required":["lookup_name"],"title":"get_lookup_listArguments","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}}}}