Agent Tools API

{'type': 'object', 'required': ['apps'], 'properties': {'apps': {'type': 'array', 'items': {'type': 'string', 'maxLength': 300}, 'maxItems': 10, 'minItems': 1, 'description': 'App Store or Google Play URLs, Apple numeric ids (id310633997) or Play package names (com.spotify.music)'}, 'sort': {'enum': ['newest', 'relevant'], 'type': 'string', 'description': 'Review order. Defaults to newest'}, 'countries': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[A-Za-z]{2}$'}, 'maxItems': 10, 'description': 'Two-letter country codes. Defaults to ["us"]'}, 'languages': {'type': 'array', 'items': {'type': 'string', 'maxLength': 12}, 'maxItems': 10, 'description': 'Google Play language codes. Defaults to ["en"]'}, 'sinceDate': {'type': 'string', 'maxLength': 40, 'description': 'ISO date; only reviews on or after it'}, 'maxReviewsPerApp': {'type': 'integer', 'maximum': 5000, 'minimum': 0, 'description': 'Reviews per app, country and language. Default 100, 0 returns app metadata only'}}}

{'type': 'object', 'required': ['ticket'], 'properties': {'ticket': {'type': 'string', 'pattern': '^fb_[0-9a-f]{32}$', 'description': 'The ticket id that submit_feedback returned.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ticket', 'status'], 'properties': {'note': {'type': 'string'}, 'reply': {'type': ['string', 'null']}, 'status': {'enum': ['pending', 'answered'], 'type': 'string'}, 'ticket': {'type': 'string'}}}

{'type': 'object', 'required': ['video'], 'properties': {'video': {'type': 'string', 'maxLength': 300, 'description': 'YouTube video URL (watch, youtu.be, shorts, embed, live) or 11-character video ID'}, 'format': {'enum': ['segments', 'text', 'srt', 'vtt'], 'type': 'string', 'description': 'segments = timestamped JSON plus text (default), text = plain text only, srt/vtt = subtitle file'}, 'languages': {'type': 'array', 'items': {'type': 'string', 'maxLength': 12}, 'maxItems': 10, 'description': 'Language codes in priority order, e.g. ["en", "pt-BR"]; a code also matches its regional variants. Defaults to ["en"]'}, 'translateTo': {'type': 'string', 'maxLength': 12, 'description': 'Translate the transcript into this language code when YouTube offers it'}, 'fallbackToAnyLanguage': {'type': 'boolean', 'description': "When none of the languages exist, return the video's original-language transcript (languageFallback: true) instead of an error. Defaults to true"}}}

{'type': 'object', 'properties': {'task': {'type': 'string', 'description': 'Alias for query: task phrase to search.'}, 'query': {'type': 'string', 'description': "Optional task keyword or phrase to search tools (e.g. 'recruiter', 'linkedin', 'feedback', 'broken links', 'jobs'). Omit to list all tools."}, 'keyword': {'type': 'string', 'description': 'Alias for query: keyword to search.'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['companies'], 'properties': {'remote': {'type': 'boolean', 'description': 'Keep only remote jobs when true'}, 'keyword': {'type': 'string', 'maxLength': 200, 'description': 'Keep jobs whose title or description mentions this text'}, 'location': {'type': 'string', 'maxLength': 200, 'description': 'Keep jobs whose location text or city contains this, or whose country matches this name or ISO code'}, 'companies': {'type': 'array', 'items': {'type': 'string', 'maxLength': 300}, 'maxItems': 50, 'minItems': 1, 'description': 'Careers page URLs or "ats:slug" tokens, e.g. ["greenhouse:airbnb", "https://jobs.lever.co/spotify"]'}, 'department': {'type': 'string', 'maxLength': 200, 'description': 'Keep jobs in a department matching this text'}, 'withSalary': {'type': 'boolean', 'description': 'Keep only jobs that publish a salary figure when true'}, 'postedSince': {'type': 'string', 'maxLength': 40, 'description': 'ISO date; keep jobs posted or updated on or after it'}, 'maxJobsPerCompany': {'type': 'integer', 'maximum': 5000, 'minimum': 1, 'description': 'Cap on jobs returned per company after filtering (default 1000)'}}}

{'type': 'object', 'required': ['posts'], 'properties': {'posts': {'type': 'array', 'items': {'type': 'string', 'maxLength': 300}, 'maxItems': 20, 'minItems': 1, 'description': 'Post URLs or numeric ids, e.g. ["https://x.com/jack/status/20", "20"]'}, 'includeThread': {'type': 'boolean', 'description': "Also return the author's earlier posts in the same self-thread, oldest first (default false, at most 25 posts)"}}}

{'type': 'object', 'required': ['kind', 'message'], 'properties': {'kind': {'enum': ['need_tool', 'need_data', 'bug', 'other'], 'type': 'string', 'description': 'need_tool: a tool you want. need_data: data a tool lacks. bug: something broke. other: anything else about the tools.'}, 'tool': {'type': 'string', 'pattern': '^[A-Za-z0-9_.:-]{1,64}$', 'description': 'Optional: the name of the tool this is about, for example find_tariff_codes.'}, 'message': {'type': 'string', 'maxLength': 1000, 'minLength': 10, 'description': 'What you need or what broke, in plain words, at most 1000 characters. Links, email addresses and phone numbers are removed. Never include secrets or personal details.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ticket', 'status'], 'properties': {'note': {'type': 'string'}, 'reply': {'type': ['string', 'null']}, 'status': {'enum': ['pending', 'answered'], 'type': 'string'}, 'ticket': {'type': 'string'}}}