Skip to main content
GitHub create or update file contents action to create a new file or update an existing file in a GitHub repository. This is a write action that creates a commit with the file changes, including support for custom commit metadata such as author, committer, branch, and SHA validation.

​
Prerequisites

  • Your admin must install and configure the GitHub connector, add the GitHub actions pack under Admin > Actions, and enable this action.
  • A GitHub app must be installed on the relevant organization(s) and linked to the correct GitHub datasource in the Glean admin console.
  • The GitHub app must have write permissions to repository contents.

​
Supported parameters

ParameterTypeRequiredDescription
OwnerStringYesThe account owner of the repository (case-insensitive).
RepositoryStringYesThe name of the repository without the .git extension (case-insensitive).
File pathStringYesThe full path to the file in the repository, including filename and extension.
ContentStringYesThe new file content, Base64 encoded (e.g., “SGVsbG8gV29ybGQ=” for “Hello World”).
Commit messageStringYesThe commit message for this file creation or update.
BranchStringNoThe branch name to create or update the file on (defaults to repository’s default branch).
Author nameStringNoThe commit author’s name (requires author email if provided).
Author emailStringNoThe commit author’s email (requires author name if provided).
Author dateStringNoThe author’s timestamp in ISO 8601 format (defaults to committer date).
Committer nameStringNoThe committer’s name (requires committer email if provided).
Committer emailStringNoThe committer’s email (requires committer name if provided).
Committer dateStringNoThe committer’s timestamp in ISO 8601 format (defaults to current time).
SHAStringNoThe blob SHA of the file being replaced for validation (auto-fetched if omitted).
Note: If author and committer details are omitted, GitHub uses the authenticated user’s identity for both.

​
Usage examples

  • “Create a new README.md file in the ‘myorg/myproject’ repository with the content ‘Welcome to My Project’.”
  • “Update the config.json file in ‘facebook/react’ on the ‘develop’ branch with new configuration settings.”
  • “Add a new API documentation file at ‘docs/api/endpoints.md’ in the ‘microsoft/vscode’ repository.”

​
Troubleshooting

  • Possible cause: The GitHub connector is not fully set up, the GitHub app is not installed on the target organization, or the app is missing write permissions to repository contents.
  • Fix: Confirm that the GitHub connector is installed and authenticated, that the GitHub app is installed on the correct organization(s), and that it has write permissions to repository contents. If using a custom app, verify that the contents:write permission is enabled.
  • Possible cause: The content parameter is not Base64 encoded, or the encoding is incorrect.
  • Fix: Ensure that the content you pass to the action is properly Base64 encoded. If you are sending plain text, convert it to Base64 first. Verify the encoding by decoding it locally before sending to the action.
  • Possible cause: The GitHub organization has enabled OAuth App access restrictions, and the app used by this action is not allowed to access the target repository.
  • Fix: Ask your GitHub organization admin to approve or allow the GitHub app used by this action for the relevant repositories, then retry.
  • Possible cause: The file has been modified since you last read it, or the SHA provided does not match the current file version.
  • Fix: Retrieve the latest SHA for the file using a file reading action, then retry the update with the correct SHA. Alternatively, omit the SHA parameter to have it automatically fetched (but be aware this may overwrite concurrent changes).
  • Possible cause: The path parameter includes invalid characters, refers to a directory instead of a file, or the parent directories do not exist.
  • Fix: Verify the path is a valid file path (not a directory). GitHub automatically creates parent directories as needed, so you do not need to create them separately. Ensure the path does not start with a leading slash.

​
FAQs

The Content parameter must be Base64 encoded. For example, “SGVsbG8gV29ybGQ=” decodes to “Hello World”. Most programming languages have built-in Base64 encoding functions to help with this conversion.
When you include SHA, the action validates that you are updating the expected file version, preventing accidental overwrites. If you omit SHA, it is automatically fetched before applying the update. For read-modify-write workflows, always use the SHA to avoid race conditions.
Yes. GitHub automatically creates parent directories as needed when you specify a path like “docs/api/README.md”. You do not need to create the directories separately.
The action updates the existing file with the new content by creating a new commit. If you provide a SHA, it validates that the file version matches before updating. If the file does not exist, a new file is created instead.