{ "name": "GetRepoNotifications", "fully_qualified_name": "GithubApi.GetRepoNotifications@0.1.0", "description": "Retrieve notifications for the user in a specific repository.\n\nThis tool lists all notifications for the authenticated user in a specified GitHub repository. Use it to keep track of issues, pull requests, and other updates relevant to the user.", "toolkit": { "name": "ArcadeGithubApi", "description": null, "version": "0.1.0" }, "input": { "parameters": [ { "name": "repository_owner", "required": true, "description": "The account owner of the repository. The name is not case sensitive.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The account owner of the repository. The name is not case sensitive." }, "inferrable": true, "http_endpoint_parameter_name": "owner" }, { "name": "repository_name", "required": true, "description": "The name of the GitHub repository, not case sensitive.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The name of the repository. The name is not case sensitive." }, "inferrable": true, "http_endpoint_parameter_name": "repo" }, { "name": "updated_after_timestamp", "required": false, "description": "Show notifications updated after this timestamp. Use ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Only show notifications updated after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`." }, "inferrable": true, "http_endpoint_parameter_name": "since" }, { "name": "updated_before", "required": false, "description": "Display notifications updated before this time in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Only show notifications updated before the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`." }, "inferrable": true, "http_endpoint_parameter_name": "before" }, { "name": "results_per_page", "required": false, "description": "Number of notifications to display per page, with a maximum of 100.", "value_schema": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The number of results per page (max 100)." }, "inferrable": true, "http_endpoint_parameter_name": "per_page" }, { "name": "results_page_number", "required": false, "description": "Specify the page number of the results to fetch. Useful for paginating through notifications.", "value_schema": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Page number of the results to fetch." }, "inferrable": true, "http_endpoint_parameter_name": "page" }, { "name": "include_read_notifications", "required": false, "description": "If `true`, include notifications that have been marked as read.", "value_schema": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "If `true`, show notifications marked as read." }, "inferrable": true, "http_endpoint_parameter_name": "all" }, { "name": "show_only_participation_notifications", "required": false, "description": "If `true`, only show notifications where the user is directly participating or mentioned.", "value_schema": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "If `true`, only shows notifications in which the user is directly participating or mentioned." }, "inferrable": true, "http_endpoint_parameter_name": "participating" } ] }, "output": { "description": "Response from the API endpoint 'activity/list-repo-notifications-for-authenticated-user'.", "available_modes": [ "value", "error", "null" ], "value_schema": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null } }, "requirements": { "authorization": { "provider_id": "arcade-github", "provider_type": "oauth2", "id": null, "oauth2": null }, "secrets": [ { "key": "GIT_SERVER_URL" } ], "metadata": null }, "deprecation_message": null, "metadata": { "object_type": "api_wrapper_tool", "version": "1.1.0", "description": "Tools that enable LLMs to interact directly with the GitHub API." }, "http_endpoint": { "metadata": { "object_type": "http_endpoint", "version": "1.2.0", "description": "" }, "url": "{git_server_url}/api/v3/repos/{owner}/{repo}/notifications", "http_method": "GET", "headers": {}, "parameters": [ { "name": "all", "tool_parameter_name": "include_read_notifications", "description": "If `true`, show notifications marked as read.", "value_schema": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "If `true`, show notifications marked as read." }, "accepted_as": "query", "required": false, "deprecated": false, "default": false, "documentation_urls": [] }, { "name": "participating", "tool_parameter_name": "show_only_participation_notifications", "description": "If `true`, only shows notifications in which the user is directly participating or mentioned.", "value_schema": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "If `true`, only shows notifications in which the user is directly participating or mentioned." }, "accepted_as": "query", "required": false, "deprecated": false, "default": false, "documentation_urls": [] }, { "name": "since", "tool_parameter_name": "updated_after_timestamp", "description": "Only show notifications updated after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Only show notifications updated after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`." }, "accepted_as": "query", "required": false, "deprecated": false, "default": null, "documentation_urls": [] }, { "name": "before", "tool_parameter_name": "updated_before", "description": "Only show notifications updated before the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Only show notifications updated before the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`." }, "accepted_as": "query", "required": false, "deprecated": false, "default": null, "documentation_urls": [] }, { "name": "per_page", "tool_parameter_name": "results_per_page", "description": "The number of results per page (max 100).", "value_schema": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The number of results per page (max 100)." }, "accepted_as": "query", "required": false, "deprecated": false, "default": 30, "documentation_urls": [] }, { "name": "page", "tool_parameter_name": "results_page_number", "description": "Page number of the results to fetch.", "value_schema": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Page number of the results to fetch." }, "accepted_as": "query", "required": false, "deprecated": false, "default": 1, "documentation_urls": [] }, { "name": "owner", "tool_parameter_name": "repository_owner", "description": "The account owner of the repository. The name is not case sensitive.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The account owner of the repository. The name is not case sensitive." }, "accepted_as": "path", "required": true, "deprecated": false, "default": null, "documentation_urls": [] }, { "name": "repo", "tool_parameter_name": "repository_name", "description": "The name of the repository. The name is not case sensitive.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The name of the repository. The name is not case sensitive." }, "accepted_as": "path", "required": true, "deprecated": false, "default": null, "documentation_urls": [] } ], "documentation_urls": [], "secrets": [ { "arcade_key": "GIT_SERVER_URL", "parameter_name": "git_server_url", "accepted_as": "path", "formatted_value": null, "description": "", "is_auth_token": false }, { "arcade_key": "auth_token", "parameter_name": "Authorization", "accepted_as": "header", "formatted_value": "Bearer {authorization}", "description": "The OAuth token to use for authentication.", "is_auth_token": true } ], "request_body_spec": null, "use_request_body_schema_mode": false, "validate_request_body_schema": false } }