tinyjuice 0.2.1

[json table: 50 rows × 2 cols · blank=absent key · exact original via retrieve footer]
| function | type |
| --- | --- |
| {"description":"Checks if a GitHub App or OAuth access_token is valid for the specified client_id and retrieves its details, typically to verify its active status and grants. NOTE: This endpoint requires Basic Authentication using the OAuth App's client_id as username and client_secret as password. The access_token parameter must be an OAuth token issued by the specified OAuth App.","name":"GITHUB_CHECK_TOKEN","parameters":{"description":"Request schema for validating a GitHub App or OAuth token.","properties":{"access_token":{"description":"The OAuth access token issued by your OAuth App that you want to validate. Returns 404 if the token is invalid or not issued by this client_id.","examples":["gho_A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6Q7r8S9t0"],"title":"Access Token","type":"string"},"client_id":{"description":"The unique client ID of your GitHub OAuth App (must match the app that issued the token being checked).","examples":["Iv1.1234567890abcdef"],"title":"Client Id","type":"string"}},"required":["client_id","access_token"],"title":"CheckTokenRequest","type":"object"}} | function |
| {"description":"Tool to clear the value of a field for an item in a GitHub Project V2. Use when you need to remove or reset a field value (text, number, date, assignees, labels, single-select, iteration, or milestone fields).","name":"GITHUB_CLEAR_PROJECT_V2_ITEM_FIELD_VALUE","parameters":{"description":"Request parameters for clearing a field value in a GitHub Project V2 item.\\n\\nprojectId: The ID of the Project.\\nitemId: The ID of the item to update.\\nfieldId: The ID of the field to clear.","properties":{"fieldId":{"description":"The global node ID of the field to clear (e.g., 'PVTSSF_lAHOCNqc1s4BN3oqzg8vTnA'). Currently supports text, number, date, assignees, labels, single-select, iteration and milestone fields.","examples":["PVTSSF_lAHOCNqc1s4BN3oqzg8vTnA"],"title":"Field Id","type":"string"},"itemId":{"description":"The global node ID of the project item to update (e.g., 'PVTI_lAHOCNqc1s4BN3oqzgldG_w'). This identifies the specific item within the project whose field value will be cleared.","examples":["PVTI_lAHOCNqc1s4BN3oqzgldG_w"],"title":"Item Id","type":"string"},"projectId":{"description":"The global node ID of the Project (e.g., 'PVT_kwHOCNqc1s4BN3oq'). This identifies the project containing the item.","examples":["PVT_kwHOCNqc1s4BN3oq"],"title":"Project Id","type":"string"}},"required":["projectId","itemId","fieldId"],"title":"ClearProjectV2ItemFieldValueRequest","type":"object"}} | function |
| {"description":"Deletes GitHub Actions caches from a repository matching a specific `key` and an optional Git `ref`, used to manage storage or clear outdated/corrupted caches; the action succeeds even if no matching caches are found to delete.","name":"GITHUB_CLEAR_REPOSITORY_CACHE_BY_KEY","parameters":{"description":"Request schema for the `ClearRepositoryCacheByKey` action, defining parameters to identify and delete GitHub Actions caches.","properties":{"key":{"description":"The exact cache key used to identify specific caches for deletion. This key is often dynamically generated in workflows using expressions (e.g., `${{ runner.os }}-npm-${{ hashFiles('**/package-lock.json') }}`).","examples":["Linux-npm-6a99d79959699e7aa7597179767626e089597a38","Windows-pip-cache-mybranch-py39","macOS-gems-custom-key-v1"],"title":"Key","type":"string"},"owner":{"description":"The account owner of the repository. The name is not case sensitive.","examples":["octocat","my-organization"],"title":"Owner","type":"string"},"ref":{"description":"The full Git reference for narrowing down the cache deletion. For example, to target caches for a specific branch, use `refs/heads/<branch_name>`. To target caches for a pull request, use `refs/pull/<pull_number>/merge`. If omitted, caches matching the key across all refs are considered.","examples":["refs/heads/main","refs/pull/123/merge","refs/tags/v1.0.0"],"title":"Ref","type":"string"},"repo":{"description":"The name of the repository without the `.git` extension. The name is not case sensitive.","examples":["hello-world","my-awesome-project"],"title":"Repo","type":"string"}},"required":["owner","repo","key"],"title":"ClearRepositoryCacheByKeyRequest","type":"object"}} | function |
| {"description":"Removes all custom labels from a self-hosted runner for an organization; default labels (e.g., 'self-hosted', 'linux', 'x64') will remain.","name":"GITHUB_CLEAR_SELF_HOSTED_RUNNER_ORG_LABELS","parameters":{"description":"Request schema for `ClearSelfHostedRunnerOrgLabels`","properties":{"org":{"description":"The name of the GitHub organization that owns the self-hosted runner (case-insensitive).","examples":["octo-org","my-company"],"title":"Org","type":"string"},"runner_id":{"description":"Unique numeric identifier of the self-hosted runner. Can be obtained from listing runners for the organization.","examples":[123,456],"title":"Runner Id","type":"integer"}},"required":["org","runner_id"],"title":"ClearSelfHostedRunnerOrgLabelsRequest","type":"object"}} | function |
| {"description":"Tool to atomically create, update, or delete multiple files in a GitHub repository as a single commit. Uses Git Data APIs to avoid SHA mismatch conflicts that occur with the Contents API when multiple files are modified in parallel. Use when you need to make multi-file changes reliably. BRANCH CREATION: When committing to a new branch (e.g., 'fix/my-fix' or 'feature/new-feature'), you MUST provide 'base_branch' (typically 'main' or 'master') to create the branch from. If the branch already exists, base_branch is not needed. This action handles race conditions automatically: if the branch is updated by another commit between fetching the HEAD and updating the reference (resulting in a 422 'not a fast forward' error), the action will retry by refetching the HEAD and rebasing changes. Use max_retries to control this behavior.","name":"GITHUB_COMMIT_MULTIPLE_FILES","parameters":{"properties":{"author":{"additionalProperties":false,"description":"Git author or committer information.","properties":{"date":{"description":"ISO 8601 timestamp for the commit (optional, defaults to current time)","examples":["2024-01-15T10:30:00Z"],"title":"Date","type":"string"},"email":{"description":"Email address of the author or committer","examples":["john@example.com","jane@example.com"],"title":"Email","type":"string"},"name":{"description":"Name of the author or committer","examples":["John Doe","Jane Smith"],"title":"Name","type":"string"}},"required":["name","email"],"title":"AuthorCommitter","type":"object"},"base_branch":{"description":"REQUIRED when committing to a new branch that doesn't exist yet. Specifies the existing branch to create the new branch from (e.g., 'main' or 'master'). Not needed if 'branch' already exists in the repository.","examples":["main","master","develop"],"title":"Base Branch","type":"string"},"branch":{"description":"Target branch name to commit to. If this branch doesn't exist, you MUST provide 'base_branch' to create it. For new feature branches (e.g., 'fix/my-fix', 'feature/new-feature'), always set base_branch='main' (or your default branch).","examples":["main","develop","feature/new-feature"],"title":"Branch","type":"string"},"committer":{"additionalProperties":false,"description":"Git author or committer information.","properties":{"date":{"description":"ISO 8601 timestamp for the commit (optional, defaults to current time)","examples":["2024-01-15T10:30:00Z"],"title":"Date","type":"string"},"email":{"description":"Email address of the author or committer","examples":["john@example.com","jane@example.com"],"title":"Email","type":"string"},"name":{"description":"Name of the author or committer","examples":["John Doe","Jane Smith"],"title":"Name","type":"string"}},"required":["name","email"],"title":"AuthorCommitter","type":"object"},"deletes":{"description":"List of file paths to delete from the repository. Files must exist in the repository; attempting to delete non-existent files will result in an error. Ensure paths are exact with no leading/trailing whitespace.","examples":[["old-file.txt","deprecated/module.py"]],"items":{"type":"string"},"title":"Deletes","type":"array"},"force":{"default":false,"description":"Force update the branch reference. WARNING: Use with caution as this can overwrite commits. Only use this when you intentionally want to overwrite the branch history.","title":"Force","type":"boolean"},"max_retries":{"default":3,"description":"Maximum number of retries when encountering race conditions (422 'not a fast forward' errors). The action will refetch the HEAD and rebase changes on each retry. Set to 0 to disable retries.","maximum":10,"minimum":0,"title":"Max Retries","type":"integer"},"message":{"description":"Commit message describing the changes","examples":["Add new features","Update documentation","Fix bugs in authentication"],"title":"Message","type":"string"},"owner":{"description":"Repository owner (username or organization name)","examples":["octocat","my-organization"],"title":"Owner","type":"string"},"repo":{"description":"Repository name (without .git extension)","examples":["hello-world","my-project"],"title":"Repo","type":"string"},"upserts":{"description":"List of files to create or update. Each entry requires path, content, and optional encoding (utf-8 or base64)","examples":[[{"content":"# Hello","encoding":"utf-8","path":"README.md"}]],"items":{"description":"Represents a file to create or update.","properties":{"content":{"description":"File content as a string","examples":["print('Hello, World!')","# My Project\\n\\nWelcome!"],"title":"Content","type":"string"},"encoding":{"default":"utf-8","description":"Content encoding: 'utf-8' for text files or 'base64' for binary files","enum":["utf-8","base64"],"examples":["utf-8","base64"],"title":"Encoding","type":"string"},"path":{"description":"File path in the repository (e.g., 'src/main.py' or 'docs/readme.md')","examples":["src/main.py","README.md","docs/guide.md"],"title":"Path","type":"string"}},"required":["path","content"],"title":"FileUpsert","type":"object"},"title":"Upserts","type":"array"}},"required":["owner","repo","branch","message"],"title":"CommitMultipleFilesRequest","type":"object"}} | function |
| {"description":"Compares two commit points (commits, branches, tags, or SHAs) within a repository or across forks, using `BASE...HEAD` or `OWNER:REF...OWNER:REF` format for the `basehead` parameter.","name":"GITHUB_COMPARE_TWO_COMMITS","parameters":{"description":"Request schema for `CompareTwoCommits` action. Specifies the repository and the two commit points (base and head) to compare.","properties":{"basehead":{"description":"A string specifying the base and head references to compare, in the format `BASE...HEAD`. `BASE` and `HEAD` can be branch names (e.g., `main...develop`), tag names (e.g., `v1.0.0...v1.1.0`), or commit SHAs (abbreviated or full 40-character format). Both abbreviated and full SHAs are accepted; full 40-character SHAs are recommended for reliability in large repositories. Both references must exist in the specified repository. To compare branches across forks in the same network, use the format `OWNER:REF...OWNER:REF` (e.g., `octocat:main...another-user:main`). Do NOT pass GitHub URLs - only plain reference strings like 'main...develop' are accepted.","examples":["main...develop","v1.0.0...v1.1.0","0e9c6b6...5f8d3a0","553c2077f0edc3d5dc5d17262f6aa498e69d6f8e...7fd1a60b01f91b314f59955a4e4d4e80d8edf11d","octocat:main...my-fork-user:main"],"title":"Basehead","type":"string"},"owner":{"description":"The username or organization name that owns the repository. This field is not case-sensitive.","examples":["octocat","my-organization"],"title":"Owner","type":"string"},"page":{"default":1,"description":"Page number of the results to fetch, for pagination when the number of differences (commits or files) is large.","examples":["1","2"],"title":"Page","type":"integer"},"per_page":{"default":30,"description":"Number of results (e.g., files or commits) to return per page, with a maximum of 100, for pagination.","examples":["30","100"],"title":"Per Page","type":"integer"},"repo":{"description":"The name of the repository, without the `.git` extension. This field is not case-sensitive.","examples":["Spoon-Knife","my-project"],"title":"Repo","type":"string"}},"required":["owner","repo","basehead"],"title":"CompareTwoCommitsRequest","type":"object"}} | function |
| {"description":"Generates a JIT configuration for a GitHub organization's new self-hosted runner to run a single job then unregister; requires admin:org scope and the runner_group_id must exist in the organization.","name":"GITHUB_CONFIGURE_JIT_RUNNER_FOR_ORG","parameters":{"description":"Parameters to generate a just-in-time (JIT) runner configuration for a GitHub organization.","properties":{"labels":{"description":"Custom labels to assign to the new self-hosted runner, used by GitHub Actions to route jobs. **Minimum items**: 1. **Maximum items**: 100.","examples":[["linux","x64","gpu"],["windows-latest","my-custom-label"]],"items":{"type":"string"},"maxItems":100,"minItems":1,"title":"Labels","type":"array"},"name":{"description":"Desired name for the new self-hosted runner, visible in the GitHub UI.","examples":["my-jit-runner-linux","temp-builder-1"],"title":"Name","type":"string"},"org":{"description":"Name of the GitHub organization (case-insensitive).","examples":["my-organization","github"],"title":"Org","type":"string"},"runner_group_id":{"description":"ID of the runner group to assign the new self-hosted runner. Must exist in the organization. You can get runner group IDs by calling the 'List self-hosted runner groups for an organization' endpoint (GET /orgs/{org}/actions/runner-groups).","examples":[1,42],"title":"Runner Group Id","type":"integer"},"work_folder":{"default":"_work","description":"Path to the working directory on the runner machine where jobs will execute, relative to the runner's installation directory.","examples":["_work","custom_work_dir"],"title":"Work Folder","type":"string"}},"required":["org","name","runner_group_id","labels"],"title":"ConfigureJitRunnerForOrgRequest","type":"object"}} | function |
| {"description":"Sets or updates the OIDC subject claim customization template for an existing GitHub organization by specifying which claims (e.g., 'repo', 'actor') form the OIDC token's subject (`sub`). This action customizes which claim keys are included in the OIDC subject claim for the specified organization. It allows for fine-tuning the content of the subject claim based on organizational needs.","name":"GITHUB_CONFIGURE_OIDC_SUBJECT_CLAIM_TEMPLATE","parameters":{"description":"Request schema for `ConfigureOidcSubjectClaimTemplate`.","properties":{"include_claim_keys":{"description":"Array of unique strings, each a valid claim key (e.g., 'repo', 'actor'; alphanumeric/underscores only), to include in the OIDC subject claim (`sub`).","examples":[["repo","context","actor"],["workflow","ref","repository_owner"]],"items":{"type":"string"},"title":"Include Claim Keys","type":"array"},"org":{"description":"The GitHub organization name (case-insensitive).","examples":["my-github-org"],"title":"Org","type":"string"}},"required":["org","include_claim_keys"],"title":"ConfigureOidcSubjectClaimTemplateRequest","type":"object"}} | function |
| {"description":"Converts an existing organization member, who is not an owner, to an outside collaborator, restricting their access to explicitly granted repositories.","name":"GITHUB_CONVERT_ORG_MEMBER_TO_OUTSIDE_COLLABORATOR","parameters":{"description":"Request schema for `ConvertOrgMemberToOutsideCollaborator`","properties":{"async":{"default":false,"description":"If true, performs the conversion asynchronously (API returns a 202 status when the job is successfully queued).","title":"Async","type":"boolean"},"org":{"description":"The organization name (case-insensitive).","examples":["octo-org","my-company-gh"],"title":"Org","type":"string"},"username":{"description":"The GitHub username of the member to convert.","examples":["octocat","user-to-convert"],"title":"Username","type":"string"}},"required":["org","username"],"title":"ConvertOrgMemberToOutsideCollaboratorRequest","type":"object"}} | function |
| {"description":"Creates a Git blob in a repository, requiring content and encoding ('utf-8' or 'base64'). Requires write access to the repository.","name":"GITHUB_CREATE_A_BLOB","parameters":{"description":"Defines the request parameters for creating a new Git blob.","properties":{"content":{"description":"The content to be stored in the new blob.","examples":["This is the raw content of the file.","SGVsbG8gV29ybGQ=\\\\n"],"title":"Content","type":"string"},"encoding":{"default":"utf-8","description":"The encoding for the 'content'; \\"utf-8\\" or \\"base64\\".","examples":["utf-8","base64"],"title":"Encoding","type":"string"},"owner":{"description":"The username or organization name that owns the repository. This field is not case-sensitive. You must have write access to the repository.","examples":["octocat"],"title":"Owner","type":"string"},"repo":{"description":"The name of the repository, without the '.git' extension. This field is not case-sensitive. The repository must exist and you must have write access to it.","examples":["Hello-World"],"title":"Repo","type":"string"}},"required":["owner","repo","content"],"title":"CreateABlobRequest","type":"object"}} | function |
| {"description":"Creates a new check run for a specific commit in a repository, used by external services to report status, detailed feedback, annotations, and images directly within the GitHub UI. NOTE: This endpoint requires GitHub App authentication - OAuth tokens and personal access tokens cannot create check runs.","name":"GITHUB_CREATE_A_CHECK_RUN","parameters":{"description":"Request schema to create a new check run on GitHub.","properties":{"actions":{"description":"A list of up to three action objects defining interactive buttons displayed on GitHub after the check run completes. Each object needs a `label` (button text), `identifier` (unique ID for the action), and `description` (tooltip). Clicking a button sends a `check_run.requested_action` webhook to your app.","items":{"additionalProperties":false,"description":"Model for a check run action.","properties":{"description":{"description":"A short explanation of what this action would do (max 40 characters).","maxLength":40,"title":"Description","type":"string"},"identifier":{"description":"A reference for the action on the integrator's system (max 20 characters).","maxLength":20,"title":"Identifier","type":"string"},"label":{"description":"The text to be displayed on a button in the web UI (max 20 characters).","maxLength":20,"title":"Label","type":"string"}},"required":["label","identifier","description"],"title":"CheckRunAction","type":"object"},"title":"Actions","type":"array"},"completed_at":{"description":"The ISO 8601 timestamp (YYYY-MM-DDTHH:MM:SSZ) indicating when the check run finished. **Required if `status` is `completed`**.","examples":["2018-05-04T01:14:52Z"],"format":"date-time","title":"Completed At","type":"string"},"conclusion":{"description":"**Required if `completed_at` is provided or if `status` is `completed`**. Specifies the final outcome of the check (e.g., 'success', 'failure'). Note: Setting `conclusion` automatically sets `status` to `completed`. GitHub alone can set a conclusion to `stale`.","enum":["action_required","cancelled","failure","neutral","success","skipped","stale","timed_out"],"title":"ConclusionEnm","type":"string"},"details_url":{"description":"The URL of the integrator's site providing full details of the check. If omitted, the GitHub App's homepage is used. This URL is available from the check's UI.","examples":["https://example.com/build/status"],"title":"Details Url","type":"string"},"external_id":{"description":"A unique identifier for the check run on the integrator's system. This helps in correlating check runs between GitHub and the external system.","examples":["42"],"title":"External Id","type":"string"},"head_sha":{"description":"The SHA of the commit for which the check run is created.","examples":["009b8392b1d19195ab1750317ce01ed503788888"],"title":"Head Sha","type":"string"},"name":{"description":"The name of the check to be displayed in the GitHub UI. For example, \\"Code Coverage\\" or \\"Linter\\".","examples":["mighty_linter"],"title":"Name","type":"string"},"output__annotations":{"description":"A list of annotation objects detailing issues at specific code locations. Annotations are visible in the 'Checks' and 'Files changed' tabs of a pull request. Each annotation object should specify `path`, `start_line`, `end_line`, `annotation_level` ('notice', 'warning', or 'failure'), and `message`. Optional fields include `start_column`, `end_column`, `title`, and `raw_details`. Up to 50 annotations per API request; for more, use subsequent 'Update a check run' calls. GitHub Actions limits are 10 warnings and 10 errors per step.","items":{"additionalProperties":false,"description":"Model for a check run annotation.","properties":{"annotation_level":{"description":"The level of the annotation (notice, warning, or failure).","enum":["notice","warning","failure"],"title":"Annotation Level","type":"string"},"end_column":{"description":"The end column of the annotation. Annotations only support start_column and end_column on the same line.","title":"End Column","type":"integer"},"end_line":{"description":"The end line of the annotation.","title":"End Line","type":"integer"},"message":{"description":"A short description of the feedback for these lines of code.","title":"Message","type":"string"},"path":{"description":"The path of the file to add an annotation to.","title":"Path","type":"string"},"raw_details":{"description":"Details about this annotation.","title":"Raw Details","type":"string"},"start_column":{"description":"The start column of the annotation. Annotations only support start_column and end_column on the same line.","title":"Start Column","type":"integer"},"start_line":{"description":"The start line of the annotation.","title":"Start Line","type":"integer"},"title":{"description":"The title that represents the annotation.","title":"Title","type":"string"}},"required":["path","start_line","end_line","annotation_level","message"],"title":"CheckRunAnnotation","type":"object"},"title":"Output  Annotations","type":"array"},"output__images":{"description":"A list of image objects to display in the check run's output in the GitHub UI. Each object requires `alt` (alternative text), `image_url` (URL of the image), and an optional `caption`.","items":{"additionalProperties":false,"description":"Model for a check run image.","properties":{"alt":{"description":"The alternative text for the image.","title":"Alt","type":"string"},"caption":{"description":"A short image description.","title":"Caption","type":"string"},"image_url":{"description":"The full URL of the image.","title":"Image Url","type":"string"}},"required":["alt","image_url"],"title":"CheckRunImage","type":"object"},"title":"Output  Images","type":"array"},"output__summary":{"description":"A summary of the check run's findings. Supports Markdown. **Maximum length**: 65,535 characters.","examples":["Found 2 critical issues and 5 warnings."],"title":"Output  Summary","type":"string"},"output__text":{"description":"Detailed textual information about the check run's output. Supports Markdown. **Maximum length**: 65,535 characters.","title":"Output  Text","type":"string"},"output__title":{"description":"A descriptive title for the output of the check run, displayed in the GitHub UI. For example, 'Linter Scan Summary'.","examples":["Linter Scan Summary"],"title":"Output  Title","type":"string"},"owner":{"description":"The account owner of the repository. This name is not case sensitive.","examples":["octocat"],"title":"Owner","type":"string"},"repo":{"description":"The name of the repository, without the `.git` extension. This name is not case sensitive.","examples":["Hello-World"],"title":"Repo","type":"string"},"started_at":{"description":"The ISO 8601 timestamp (YYYY-MM-DDTHH:MM:SSZ) indicating when the check run began.","examples":["2018-05-04T01:14:52Z"],"format":"date-time","title":"Started At","type":"string"},"status":{"default":"queued","description":"The current status of the check run. Only GitHub Actions can set `status` to `waiting`, `pending`, or `requested`.","enum":["queued","in_progress","completed","waiting","requested","pending"],"title":"Status","type":"string"}},"required":["owner","repo","name","head_sha"],"title":"CreateACheckRunRequest","type":"object"}} | function |
| {"description":"Creates a new check suite for a specific commit (`head_sha`) in an original repository (not a fork). IMPORTANT: This endpoint requires a GitHub App installation access token - OAuth tokens and classic personal access tokens cannot use this endpoint. GitHub dispatches a `check_suite` webhook event with the `requested` action upon success.","name":"GITHUB_CREATE_A_CHECK_SUITE","parameters":{"description":"Request schema for `CreateACheckSuite`","properties":{"head_sha":{"description":"SHA of the commit for which to create the check suite, typically the head commit of a branch.","examples":["7638417db6d59f3c431d3e1f261cc637155684cd"],"title":"Head Sha","type":"string"},"owner":{"description":"Account owner of the repository (case-insensitive).","examples":["octocat"],"title":"Owner","type":"string"},"repo":{"description":"Repository name, without the `.git` extension (case-insensitive).","examples":["Hello-World"],"title":"Repo","type":"string"}},"required":["owner","repo","head_sha"],"title":"CreateACheckSuiteRequest","type":"object"}} | function |
| {"description":"Creates a GitHub Codespace for the authenticated user, requiring a JSON request body with either `repository_id` (integer) or a `pull_request` object (containing `pull_request_number` (integer) and `repository_id` (integer)). This action allows users to set up a development environment quickly by creating a codespace from a specified repository or pull request.","name":"GITHUB_CREATE_A_CODESPACE_FOR_THE_AUTHENTICATED_USER","parameters":{"description":"Request body for POST /user/codespaces.\\n\\nProvide either:\\n- repository_id (int) + ref (string branch/commit/PR ref), or\\n- pull_request object with pull_request_number (int) and repository_id (int).\\n\\nOther optional fields supported by the API (machine, location, devcontainer_path, etc.) can be added later if needed.","properties":{"pull_request":{"additionalProperties":false,"properties":{"pull_request_number":{"description":"Pull request number.","title":"Pull Request Number","type":"integer"},"repository_id":{"description":"Repository ID for the pull request.","title":"Repository Id","type":"integer"}},"required":["pull_request_number","repository_id"],"title":"PullRequestPayload","type":"object"},"ref":{"description":"Git ref (branch, tag, or commit SHA) to use for the codespace.","examples":["main","refs/heads/main","a1b2c3d"],"title":"Ref","type":"string"},"repository_id":{"description":"ID of the repository to create the codespace from.","title":"Repository Id","type":"integer"}},"title":"CreateACodespaceForTheAuthenticatedUserRequest","type":"object"}} | function |
| {"description":"Creates a GitHub Codespace for an open pull request in a Codespaces-enabled repository, with options to customize its configuration.","name":"GITHUB_CREATE_A_CODESPACE_FROM_A_PULL_REQUEST","parameters":{"description":"Request to create a GitHub Codespace from a pull request, specifying its configuration.","properties":{"client_ip":{"description":"Client's public IP address for location auto-detection if proxied and `geo` or `location` are not specified.","examples":["192.0.2.1"],"title":"Client Ip","type":"string"},"devcontainer_path":{"description":"Path to a `devcontainer.json` file in the repository that defines the development environment.","examples":[".devcontainer/devcontainer.json","devcontainer.json"],"title":"Devcontainer Path","type":"string"},"display_name":{"description":"Custom name for the codespace.","examples":["My Feature Branch Codespace"],"title":"Display Name","type":"string"},"geo":{"description":"Geographic area for this codespace (e.g., `UsEast`, `EuropeWest`); supersedes `location`. If unspecified, typically IP-derived.","enum":["EuropeWest","SoutheastAsia","UsEast","UsWest"],"examples":["UsEast","EuropeWest","SoutheastAsia"],"title":"GeoEnm","type":"string"},"idle_timeout_minutes":{"description":"Minutes of inactivity after which the codespace is automatically stopped. A default timeout applies if unspecified.","examples":[30,60],"title":"Idle Timeout Minutes","type":"integer"},"location":{"description":"Requested geographic location (e.g., `EastUs`, `WestEurope`). This parameter is deprecated; use `geo`. If unspecified, location may be IP-derived.","examples":["EastUs","WestEurope"],"title":"Location","type":"string"},"machine":{"description":"Machine type for this codespace (e.g., `standardLinux`). Varies by CPU, RAM, storage. Uses default if unspecified.","examples":["standardLinux","standardLinux8gb","standardLinux16gb","standardLinux32gb"],"title":"Machine","type":"string"},"multi_repo_permissions_opt_out":{"description":"Set to `true` to prevent GitHub from requesting additional repository permissions defined in `devcontainer.json`. Defaults to `false` (permissions will be requested).","title":"Multi Repo Permissions Opt Out","type":"boolean"},"owner":{"description":"The username of the account that owns the repository. This is case-insensitive.","examples":["octocat"],"title":"Owner","type":"string"},"pull_number":{"description":"The unique number identifying the pull request.","examples":[1347],"title":"Pull Number","type":"integer"},"repo":{"description":"The name of the repository, without the `.git` extension. This is case-insensitive.","examples":["Spoon-Knife"],"title":"Repo","type":"string"},"retention_period_minutes":{"description":"Retention period in minutes (0-43200, i.e., up to 30 days) for a stopped codespace. 0 means immediate deletion.","examples":[1440,43200],"title":"Retention Period Minutes","type":"integer"},"working_directory":{"description":"Working directory for the codespace upon opening. Defaults to the repository root if unspecified.","examples":["/workspaces/my-project/src"],"title":"Working Directory","type":"string"}},"required":["owner","repo","pull_number"],"title":"CreateACodespaceFromAPullRequestRequest","type":"object"}} | function |
| {"description":"Creates a GitHub Codespace for the authenticated user in a specified repository, which must be accessible and use a valid `devcontainer.json` if `devcontainer_path` is specified.","name":"GITHUB_CREATE_A_CODESPACE_IN_A_REPOSITORY","parameters":{"description":"Request schema for `CreateACodespaceInARepository`","properties":{"client_ip":{"description":"IP address to infer preferred region if `location` and `geo` are unspecified; useful for proxied requests.","examples":["192.168.1.100"],"title":"Client Ip","type":"string"},"devcontainer_path":{"description":"Path to a `devcontainer.json` in the repository; uses `.devcontainer/devcontainer.json` or `devcontainer.json` at root if not specified.","examples":[".devcontainer/my-custom-devcontainer.json"],"title":"Devcontainer Path","type":"string"},"display_name":{"description":"Custom display name for the codespace; a default name is generated if not provided.","examples":["My Development Codespace"],"title":"Display Name","type":"string"},"geo":{"description":"Geographic area for the codespace, replacing `location`; determined by user IP if not specified.","enum":["EuropeWest","SoutheastAsia","UsEast","UsWest"],"examples":["EuropeWest","SoutheastAsia","UsEast","UsWest"],"title":"GeoEnm","type":"string"},"idle_timeout_minutes":{"description":"Minutes of inactivity before codespace auto-stops; uses a default timeout if not specified.","examples":[30,60],"title":"Idle Timeout Minutes","type":"integer"},"location":{"description":"Requested AWS region (best-effort, may differ); determined by user IP if not provided. Deprecated: use `geo`.","examples":["EastUs","WestUs","WestEurope","SoutheastAsia"],"title":"Location","type":"string"},"machine":{"description":"Machine type (CPU, RAM, storage). See 'List available machine types for a repository' action for options; uses a default type if not specified.","examples":["standardLinux","premiumLinux"],"title":"Machine","type":"string"},"multi_repo_permissions_opt_out":{"description":"If `true`, opts out of granting multi-repository permissions from `devcontainer.json`. If unspecified or `false`, permissions are granted if requested.","examples":[true,false],"title":"Multi Repo Permissions Opt Out","type":"boolean"},"owner":{"description":"Username or organization name owning the repository; not case-sensitive.","examples":["octocat","Microsoft"],"title":"Owner","type":"string"},"ref":{"description":"Git reference (e.g., branch name) for the codespace; uses repository's default branch if not provided.","examples":["main","feature-branch-name"],"title":"Ref","type":"string"},"repo":{"description":"Name of the repository, without the `.git` extension; not case-sensitive.","examples":["Spoon-Knife","vscode"],"title":"Repo","type":"string"},"retention_period_minutes":{"description":"Minutes an idle (stopped) codespace is retained before auto-deletion (0-43200, i.e., up to 30 days); uses a default period if not specified.","examples":[1440,43200],"title":"Retention Period Minutes","type":"integer"},"working_directory":{"description":"Directory to use as default when codespace opens; uses repository root if not specified.","examples":["/projects/my-app"],"title":"Working Directory","type":"string"}},"required":["owner","repo"],"title":"CreateACodespaceInARepositoryRequest","type":"object"}} | function |
| {"description":"Creates a new commit in a GitHub repository; the `tree` SHA and any `parents` SHAs must already exist in the repository.","name":"GITHUB_CREATE_A_COMMIT","parameters":{"description":"Defines the parameters to create a new commit in a GitHub repository.","properties":{"author__date":{"description":"Timestamp (ISO 8601: `YYYY-MM-DDTHH:MM:SSZ`) when the commit was authored.","examples":["2024-01-15T10:30:00Z"],"format":"date-time","title":"Author  Date","type":"string"},"author__email":{"description":"Email of the commit's author. Defaults to authenticated user if not provided.","examples":["mona@example.com"],"title":"Author  Email","type":"string"},"author__name":{"description":"Name of the commit's author. Defaults to authenticated user if not provided.","examples":["Mona Lisa Octocat"],"title":"Author  Name","type":"string"},"committer__date":{"description":"Timestamp (ISO 8601: `YYYY-MM-DDTHH:MM:SSZ`) when the commit was committed. Defaults to `author_date` or current time.","examples":["2024-01-15T10:35:00Z"],"format":"date-time","title":"Committer  Date","type":"string"},"committer__email":{"description":"Email of the committer. Defaults to author's email or authenticated user if not provided.","examples":["octocat@example.com"],"title":"Committer  Email","type":"string"},"committer__name":{"description":"Name of the committer. Defaults to author's name or authenticated user if not provided.","examples":["The Octocat"],"title":"Committer  Name","type":"string"},"message":{"description":"The commit message.","examples":["feat: implement user authentication endpoint"],"title":"Message","type":"string"},"owner":{"description":"Account owner of the repository (case-insensitive).","examples":["octocat"],"title":"Owner","type":"string"},"parents":{"description":"SHAs of parent commits; all must exist in the repository. Omit or provide an empty list for a root commit.","examples":["[\\"1a2b3c4d5e6f7g8h9i0jabcdef1234567890\\"]","[\\"parent_sha_main\\", \\"parent_sha_feature_branch\\"]"],"items":{"type":"string"},"title":"Parents","type":"array"},"repo":{"description":"Name of the repository, without the `.git` extension (case-insensitive).","examples":["Spoon-Knife"],"title":"Repo","type":"string"},"signature":{"description":"ASCII-armored detached PGP signature over the commit data. GitHub adds this to the `gpgsig` header if provided.","examples":["-----BEGIN PGP SIGNATURE-----\\\\n...\\\\n-----END PGP SIGNATURE-----"],"title":"Signature","type":"string"},"tree":{"description":"SHA of the tree object for this commit; must exist in the repository.","examples":["9c1a209e10072fe99393945673ace821a4827669"],"title":"Tree","type":"string"}},"required":["owner","repo","message","tree"],"title":"CreateACommitRequest","type":"object"}} | function |
| {"description":"Creates a comment on a specific commit, or on a specific line if `path` and `position` are provided.","name":"GITHUB_CREATE_A_COMMIT_COMMENT","parameters":{"description":"Request to create a comment on a specific commit or a line within a file's diff in a commit.","properties":{"body":{"description":"The text content of the comment.","examples":["This is a great commit!","LGTM :+1:"],"title":"Body","type":"string"},"commit_sha":{"description":"The SHA identifier of the commit to comment on.","examples":["a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"],"title":"Commit Sha","type":"string"},"line":{"description":"**Deprecated:** Use `position` instead. Line number in the file to comment on. `position` takes precedence if both are provided.","examples":["5","23"],"title":"Line","type":"integer"},"owner":{"description":"The username or organization name that owns the repository.","examples":["octocat","github"],"title":"Owner","type":"string"},"path":{"description":"Relative path of the file to comment on. If specified, `position` is also required.","examples":["src/main.py","docs/README.md"],"title":"Path","type":"string"},"position":{"description":"Line number in the diff's patch to comment on, relative to the commit's changes. Required if `path` is specified.","examples":["1","15"],"title":"Position","type":"integer"},"repo":{"description":"The name of the repository, without the `.git` extension.","examples":["Spoon-Knife","my-project"],"title":"Repo","type":"string"}},"required":["owner","repo","commit_sha","body"],"title":"CreateACommitCommentRequest","type":"object"}} | function |
| {"description":"Sets a commit's status (e.g., error, failure, pending, success from CI/CD) for a given SHA; max 1000 statuses per SHA/context.","name":"GITHUB_CREATE_A_COMMIT_STATUS","parameters":{"description":"Request schema for `CreateACommitStatus`","properties":{"context":{"default":"default","description":"Label to differentiate this status from other systems (e.g., 'ci/jenkins'); case-insensitive.","examples":["ci/jenkins","linter/eslint","default"],"title":"Context","type":"string"},"description":{"description":"Human-readable description of the status, displayed in GitHub UI.","examples":["Build successful","Tests passed with 0 failures","Deployment to staging failed"],"title":"Description","type":"string"},"owner":{"description":"Username or organization name of the repository owner (case-insensitive).","examples":["octocat","github"],"title":"Owner","type":"string"},"repo":{"description":"Repository name, without the `.git` extension (case-insensitive).","examples":["Hello-World","Spoon-Knife"],"title":"Repo","type":"string"},"sha":{"description":"SHA hash of the commit.","examples":["c5b97d5ae6c19d5c5df71a34c7fbeeda2479ccbc","6dcb09b5b57875f334f61aebed695e2e4193db5e"],"title":"Sha","type":"string"},"state":{"description":"State of the commit status, indicating check outcome or phase.","enum":["error","failure","pending","success"],"examples":["error","failure","pending","success"],"title":"State","type":"string"},"target_url":{"description":"URL linking to the source of the status (e.g., CI build log), displayed in GitHub UI.","examples":["http://ci.example.com/user/repo/build/sha","https://example.com/deployment/status/123"],"title":"Target Url","type":"string"}},"required":["owner","repo","sha","state"],"title":"CreateACommitStatusRequest","type":"object"}} | function |
| {"description":"Creates a custom role with defined permissions within a GitHub organization.","name":"GITHUB_CREATE_A_CUSTOM_ORGANIZATION_ROLE","parameters":{"description":"Request to create a custom organization role.","properties":{"description":{"description":"Optional short description of the custom role's purpose or permissions.","examples":["Grants read-only access to organization settings and member audit logs.","Allows managing repository security advisories."],"title":"Description","type":"string"},"name":{"description":"Unique name for the custom role.","examples":["Triage Access","Security Auditor","Release Manager"],"title":"Name","type":"string"},"org":{"description":"Name of the GitHub organization (case-insensitive) where the custom role will be created.","examples":["github","my-company-org"],"title":"Org","type":"string"},"permissions":{"description":"List of fine-grained permission strings defining actions granted by this role. Use the List Organization Fine-Grained Permissions action to get available permissions for your organization.","examples":["write_organization_custom_org_role","read_organization_custom_org_role","write_organization_custom_repo_role","read_organization_custom_repo_role","read_organization_audit_log"],"items":{"type":"string"},"title":"Permissions","type":"array"}},"required":["org","name","permissions"],"title":"CreateACustomOrganizationRoleRequest","type":"object"}} | function |
| {"description":"Creates a deploy key for a repository; the repository must exist and be accessible, and the provided key must be a valid public SSH key.","name":"GITHUB_CREATE_A_DEPLOY_KEY","parameters":{"description":"Request schema for creating a deploy key, which is an SSH key granting access to a single repository.","properties":{"key":{"description":"The full public SSH key. Ensure this is the public key, not the private key.","examples":["ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC... user@example.com"],"title":"Key","type":"string"},"owner":{"description":"The username of the account that owns the repository. This is not case sensitive.","examples":["octocat"],"title":"Owner","type":"string"},"read_only":{"description":"If `true`, the deploy key will only have read access. If `false` (default), the key will have read and write access. Write access grants significant privileges.","examples":[true,false],"title":"Read Only","type":"boolean"},"repo":{"description":"The name of the repository, without the `.git` extension. This is not case sensitive.","examples":["Hello-World"],"title":"Repo","type":"string"},"title":{"description":"A descriptive name for the new deploy key. If not provided, a default name will be generated.","examples":["Staging Server Key"],"title":"Title","type":"string"}},"required":["owner","repo","key"],"title":"CreateADeployKeyRequest","type":"object"}} | function |
[... 2 row(s) omitted ...]
| {"description":"Creates a status for an existing deployment, updating its operational state, associated URLs, and description.","name":"GITHUB_CREATE_A_DEPLOYMENT_STATUS","parameters":{"description":"Request schema for `CreateADeploymentStatus`","properties":{"auto_inactive":{"description":"If true, sets prior successful, non-transient, non-production deployments in the same repository and environment to `inactive`.","examples":["true","false"],"title":"Auto Inactive","type":"boolean"},"deployment_id":{"description":"The unique identifier of the deployment for which to create a status.","examples":[12345],"title":"Deployment Id","type":"integer"},"description":{"description":"Short description of the status (max 140 characters).","examples":["Deployment to staging completed successfully."],"title":"Description","type":"string"},"environment":{"description":"Name for the target deployment environment (e.g., `production`, `staging`). If unset, uses environment from previous status or deployment.","examples":["production","staging"],"title":"Environment","type":"string"},"environment_url":{"description":"URL for accessing the target deployment environment.","examples":["https://myapp-staging.example.com"],"title":"Environment Url","type":"string"},"log_url":{"description":"URL for deployment output. Preferred over `target_url`; setting this also sets `target_url` to the same value.","examples":["https://ci.example.com/job/my-app/15/console"],"title":"Log Url","type":"string"},"owner":{"description":"The account owner of the repository. The name is not case sensitive.","examples":["octocat"],"title":"Owner","type":"string"},"repo":{"description":"The name of the repository without the `.git` extension. The name is not case sensitive.","examples":["hello-world"],"title":"Repo","type":"string"},"state":{"description":"State of the status. Setting a transient deployment to `inactive` shows it as `destroyed` in GitHub.","enum":["error","failure","inactive","in_progress","queued","pending","success"],"examples":["success","pending","failure"],"title":"State","type":"string"},"target_url":{"description":"URL for deployment status updates or output. `log_url` is generally preferred.","examples":["https://example.com/deployment/output/123"],"title":"Target Url","type":"string"}},"required":["owner","repo","deployment_id","state"],"title":"CreateADeploymentStatusRequest","type":"object"}} | function |
[... 17 row(s) omitted ...]
| {"description":"Creates a webhook for a GitHub organization to deliver event notifications to a configured URL.","name":"GITHUB_CREATE_AN_ORGANIZATION_WEBHOOK","parameters":{"description":"Request schema for `CreateAnOrganizationWebhook`","properties":{"active":{"default":true,"description":"Boolean indicating if the webhook is active. `true` sends notifications, `false` does not. Defaults to `true`.","title":"Active","type":"boolean"},"config__content__type":{"description":"The media type for serializing webhook payloads. Supported: `json`, `form`. GitHub API defaults to `form` if this field is not set or is `None`.","examples":["json","form"],"title":"Config  Content  Type","type":"string"},"config__insecure__ssl":{"description":"Controls SSL certificate verification for `config_url`. '1' disables verification (not recommended), '0' enables. GitHub API defaults to '0' (verification enabled) if this field is not set or is `None`.","examples":["0","1"],"title":"Config  Insecure  Ssl","type":"string"},"config__password":{"description":"Password for basic authentication if the webhook endpoint (`config_url`) requires it, corresponding to `config_username`.","examples":["p@$$wOrd","securePassword123"],"title":"Config  Password","type":"string"},"config__secret":{"description":"Optional secret for generating an HMAC hex digest for payload verification (X-Hub-Signature-256 header). If provided, this is used as the key.","examples":["s3cr3tT0k3n","mySup3rS3cur3K3y"],"title":"Config  Secret","type":"string"},"config__url":{"description":"Required. The target URL for webhook payload delivery. This URL is a mandatory part of the webhook's `config` object and will receive POST requests for subscribed events.","examples":["https://example.com/webhook","https://my-service.com/github-events"],"title":"Config  Url","type":"string"},"config__username":{"description":"Username for basic authentication if the webhook endpoint (`config_url`) requires it. Use only if your endpoint is protected by basic auth.","examples":["webhook-user","admin"],"title":"Config  Username","type":"string"},"events":{"default":["push"],"description":"List of event names to trigger the webhook. Use `['*']` for all events. Defaults to `['push']` if not specified. See GitHub docs for event types.","examples":[["push","issues"],["*"],["release"],["check_run"]],"items":{"type":"string"},"title":"Events","type":"array"},"name":{"default":"web","description":"The name of the webhook. Must be \\"web\\" for organization webhooks. Defaults to \\"web\\".","title":"Name","type":"string"},"org":{"description":"The name of the GitHub organization. This name is not case-sensitive.","examples":["my-cool-org","GitHub"],"title":"Org","type":"string"}},"required":["org","config__url"],"title":"CreateAnOrganizationWebhookRequest","type":"object"}} | function |
| {"description":"Creates a project card in a GitHub project column (classic projects only). DEPRECATION NOTICE: GitHub Projects (classic) was sunset on August 23, 2024. This API only works with existing classic project columns. New classic projects cannot be created. Consider using GitHub Projects V2 (GraphQL API) instead. The request body must contain either: - `note`: A text note for the card - OR `content_id` AND `content_type`: To associate an issue or pull request","name":"GITHUB_CREATE_A_PROJECT_CARD","parameters":{"description":"Request schema for creating a GitHub project card (classic projects).\\n\\nYou must provide EITHER:\\n- `note`: A text note for the card\\nOR\\n- `content_id` AND `content_type`: To associate an issue or pull request with the card\\n\\nNOTE: GitHub Projects (classic) has been deprecated. This API only works with\\nexisting classic project columns that were created before August 23, 2024.","properties":{"column_id":{"description":"The unique identifier of the project column where the card will be created. This value is used as a path parameter in the API request URL (e.g., `/projects/columns/{column_id}/cards`).","examples":[1234567],"title":"Column Id","type":"integer"},"content_id":{"description":"The unique identifier of the issue or pull request to associate with this card. Required when content_type is specified. Get this from the issue/PR details (it's the numeric ID, not the issue number).","examples":[1,42,12345],"title":"Content Id","type":"integer"},"content_type":{"description":"Type of content to associate with the card.","enum":["Issue","PullRequest"],"examples":["Issue","PullRequest"],"title":"ContentTypeEnum","type":"string"},"note":{"description":"The text content for the card. Use this to create a note-only card. Either 'note' OR both 'content_id' and 'content_type' must be provided.","examples":["Review pending tasks","TODO: Update documentation"],"title":"Note","type":"string"}},"required":["column_id"],"title":"CreateAProjectCardRequest","type":"object"}} | function |
| {"description":"Creates a new column in a GitHub project (classic). DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action will return a 404 error on GitHub.com. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/","name":"GITHUB_CREATE_A_PROJECT_COLUMN","parameters":{"description":"Request schema for `CreateAProjectColumn`","properties":{"name":{"description":"The name for the new project column.","examples":["To Do","In Progress","Done"],"title":"Name","type":"string"},"project_id":{"description":"The unique identifier of the target GitHub project (classic) where the new column will be created.","title":"Project Id","type":"integer"}},"required":["project_id","name"],"title":"CreateAProjectColumnRequest","type":"object"}} | function |
| {"description":"Creates a pull request in a GitHub repository, requiring existing `base` and `head` branches; `title` or `issue` must be provided.","name":"GITHUB_CREATE_A_PULL_REQUEST","parameters":{"description":"Request schema for `CreateAPullRequest`","properties":{"base":{"description":"The name of the branch you want the changes pulled into. This must be an existing branch on the current (target) repository. You cannot submit a pull request to one repository that requests a merge to a base branch of another repository. ","examples":["main","develop"],"title":"Base","type":"string"},"body":{"description":"The detailed description or contents of the pull request.","examples":["This PR introduces a new feature that does X, Y, and Z.","Fixes #42 by addressing the off-by-one error."],"title":"Body","type":"string"},"draft":{"description":"Indicates whether the pull request should be created as a draft. Draft pull requests cannot be merged until marked as ready for review.","examples":[true,false],"title":"Draft","type":"boolean"},"head":{"description":"The name of the branch where your changes are implemented. IMPORTANT: This branch must already exist in the repository (or fork) before calling this action. You must first create the branch and push commits to it (using git or the 'Create a reference' action), then create the PR. For cross-repository pull requests, namespace `head` with the source owner and branch, like `username:branch`.","examples":["feature-branch","octocat:my-feature-branch"],"title":"Head","type":"string"},"head_repo":{"description":"The name of the repository (e.g., 'octocat/Hello-World') where the changes in the pull request were made. This field is required for cross-repository pull requests if both the source and target repositories are owned by the same organization but are different repositories.","examples":["octocat/my-forked-repo"],"format":"repo.nwo","title":"Head Repo","type":"string"},"issue":{"description":"The number of an existing issue in the repository to convert into a pull request. If provided, the issue's title and body may be used for the pull request. Required if `title` is not specified.","examples":["123","456"],"title":"Issue","type":"integer"},"maintainer_can_modify":{"description":"Indicates whether maintainers of the upstream repository can modify the pull request. This is primarily relevant for pull requests originating from forks.","examples":[true,false],"title":"Maintainer Can Modify","type":"boolean"},"owner":{"description":"The account owner of the repository. This name is not case-sensitive.","examples":["octocat"],"title":"Owner","type":"string"},"repo":{"description":"The name of the repository, without the `.git` extension. This name is not case-sensitive.","examples":["Spoon-Knife"],"title":"Repo","type":"string"},"title":{"description":"The title of the new pull request. Required unless `issue` is specified.","examples":["Amazing new feature","Fix for critical bug #123"],"title":"Title","type":"string"}},"required":["owner","repo","head","base"],"title":"CreateAPullRequestRequest","type":"object"}} | function |
| {"description":"Creates a NEW Git reference (branch or tag) in a repository. IMPORTANT: This action ONLY creates NEW references - if the reference already exists, it will fail with a 422 'Reference already exists' error. To update an existing reference, use the 'Update a reference' (GITHUB_UPDATE_A_REFERENCE) action instead. The repository must not be empty prior to this operation.","name":"GITHUB_CREATE_A_REFERENCE","parameters":{"description":"Request schema for `CreateAReference`","properties":{"owner":{"description":"The account owner of the repository. The name is not case sensitive.","examples":["octocat"],"title":"Owner","type":"string"},"ref":{"description":"Fully qualified reference to create (e.g., `refs/heads/master`, `refs/tags/v1.0.0`). Must start with `refs/` and contain at least two slashes.","examples":["refs/heads/new-feature-branch","refs/tags/v1.2.3"],"title":"Ref","type":"string"},"repo":{"description":"The name of the repository without the `.git` extension. The name is not case sensitive.","examples":["Hello-World"],"title":"Repo","type":"string"},"sha":{"description":"SHA-1 hash of an existing commit in the repository that the new reference will point to.","examples":["aa218f56b14c9653891f9e74264a383fa43fefbd","1234567890abcdef1234567890abcdef12345678"],"title":"Sha","type":"string"}},"required":["owner","repo","ref","sha"],"title":"CreateAReferenceRequest","type":"object"}} | function |
| {"description":"Generates a temporary (one-hour) registration token to add a new self-hosted runner to an organization for GitHub Actions.","name":"GITHUB_CREATE_A_REGISTRATION_TOKEN_FOR_AN_ORGANIZATION","parameters":{"description":"Request schema for `CreateARegistrationTokenForAnOrganization`","properties":{"org":{"description":"The name of the organization. This name is not case-sensitive.","examples":["octo-org","github"],"title":"Org","type":"string"}},"required":["org"],"title":"CreateARegistrationTokenForAnOrganizationRequest","type":"object"}} | function |
| {"description":"Generates a time-limited token required to register a new self-hosted runner with a specific repository.","name":"GITHUB_CREATE_A_REGISTRATION_TOKEN_FOR_A_REPOSITORY","parameters":{"description":"Request schema for `CreateARegistrationTokenForARepository`","properties":{"owner":{"description":"The username of the account or the organization name that owns the repository. This field is not case-sensitive.","examples":["octocat","github"],"title":"Owner","type":"string"},"repo":{"description":"The name of the repository, without the `.git` extension. This field is not case-sensitive.","examples":["hello-world","linguist"],"title":"Repo","type":"string"}},"required":["owner","repo"],"title":"CreateARegistrationTokenForARepositoryRequest","type":"object"}} | function |
| {"description":"Creates a release in a GitHub repository for a specified tag; the tag must be unique for published releases, and if a `discussion_category_name` is given, it must already exist.","name":"GITHUB_CREATE_A_RELEASE","parameters":{"properties":{"body":{"description":"A detailed description of the release. Markdown formatting is supported.","examples":["This release includes new features X, Y, and bug fixes for Z.","# New Features\\n- Feature A\\n- Feature B"],"title":"Body","type":"string"},"discussion_category_name":{"description":"If specified, a new discussion will be created in this category and linked to the release. The category must already exist in the repository's discussions.","examples":["Announcements","General"],"title":"Discussion Category Name","type":"string"},"draft":{"default":false,"description":"Set to `true` to create an unpublished (draft) release. Defaults to `false`.","title":"Draft","type":"boolean"},"generate_release_notes":{"default":false,"description":"Set to `true` to automatically generate the release title (`name`) and description (`body`) from the commit history since the last release. Defaults to `false`.","title":"Generate Release Notes","type":"boolean"},"make_latest":{"default":"true","description":"Specifies if this release should be marked as the latest for the repository. Draft releases and prereleases cannot be set as 'latest'.","enum":["true","false","legacy"],"examples":["true","false","legacy"],"title":"Make Latest","type":"string"},"name":{"description":"The title of the release. If omitted and `generate_release_notes` is false, it defaults to the `tag_name`.","examples":["Version 1.0.0","My Awesome Release"],"title":"Name","type":"string"},"owner":{"description":"The account owner of the repository (username or organization name). This field is not case-sensitive.","examples":["octocat","my-company"],"title":"Owner","type":"string"},"prerelease":{"default":false,"description":"Set to `true` to identify this release as a pre-release. Defaults to `false`.","title":"Prerelease","type":"boolean"},"repo":{"description":"The name of the repository, without the .git extension. This field is not case-sensitive.","examples":["Spoon-Knife","our-awesome-project"],"title":"Repo","type":"string"},"tag_name":{"description":"The name of the tag for this release. This tag must be unique for published releases.","examples":["v1.0.0","v1.0.1-alpha"],"title":"Tag Name","type":"string"},"target_commitish":{"description":"Specifies the commitish value (e.g., branch name, tag name, or commit SHA) from which the Git tag is created. Defaults to the repository's default branch if the tag specified in `tag_name` doesn't exist yet.","examples":["main","develop","c1f67a4f091588259dd3f8a27378e170d40c8472"],"title":"Target Commitish","type":"string"}},"required":["owner","repo","tag_name"],"title":"CreateReleaseRequest","type":"object"}} | function |
| {"description":"Generates a token, valid for one hour, to authenticate removing a self-hosted runner from an organization.","name":"GITHUB_CREATE_A_REMOVE_TOKEN_FOR_AN_ORGANIZATION","parameters":{"description":"Request schema for generating a token to remove a self-hosted runner from an organization.","properties":{"org":{"description":"The unique identifier or name of the GitHub organization. This name is not case-sensitive. For example, if your organization's URL is github.com/my-org, 'my-org' is the value.","examples":["my-github-org"],"title":"Org","type":"string"}},"required":["org"],"title":"CreateARemoveTokenForAnOrganizationRequest","type":"object"}} | function |
| {"description":"Generates a temporary (one-hour validity) token required to unregister and remove a self-hosted runner from a repository.","name":"GITHUB_CREATE_A_REMOVE_TOKEN_FOR_A_REPOSITORY","parameters":{"description":"Request schema for generating a token to remove a self-hosted runner from a repository.","properties":{"owner":{"description":"Username of the account owning the repository (not case-sensitive).","examples":["octo-org"],"title":"Owner","type":"string"},"repo":{"description":"Name of the repository, without the `.git` extension (not case-sensitive).","examples":["hello-world"],"title":"Repo","type":"string"}},"required":["owner","repo"],"title":"CreateARemoveTokenForARepositoryRequest","type":"object"}} | function |

[compacted tool output — this is a PARTIAL view; the full original (144524 bytes) is available by calling tokenjuice_retrieve with token "4395bf994dfc53618ea06e49b619b0b1" (marker ⟦tj:4395bf994dfc53618ea06e49b619b0b1⟧)]