Action: Create Gist

GitHub Operation

This GitHub action creates a new gist (a code snippet or text file) in a user's account.

Example User Story

I want to create a gist to share a reusable code snippet with my team for quick reference.

Fields

Field Name	Field Type	Required
description	String	No
public	Boolean	No
files	Map	Yes

Related Connections

GitHub

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "create-gist",
  "state": "inDev",
  "meta": {
    "short": "Create Gist",
    "description": "Creates a new gist on GitHub with the provided files and description."
  },
  "input": [
    {
      "name": "description",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Description of the gist"
      }
    },
    {
      "name": "public",
      "type": "Boolean",
      "required": false,
      "meta": {
        "description": "Whether the gist should be public or private"
      }
    },
    {
      "name": "files",
      "type": "Map",
      "required": true,
      "meta": {
        "description": "Files to include in the gist, where the key is the filename and the value is the file content"
      }
    }
  ],
  "output": [
    {
      "name": "gistId",
      "type": "String",
      "selector": [
        "id"
      ],
      "meta": {
        "description": "ID of the created gist"
      }
    },
    {
      "name": "gistUrl",
      "type": "String",
      "selector": [
        "html_url"
      ],
      "meta": {
        "description": "URL of the created gist"
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/gists",
        "headers": {
          "Content-Type": "application/json"
        },
        "bodyTemplate": {
          "value": "{\"description\": \"{{.input.description}}\", \"public\": {{.input.public}}, \"files\": {{.input.files}}}",
          "placeholders": [
            {
              "name": "description",
              "type": "String",
              "description": "Description of the gist",
              "required": false
            },
            {
              "name": "public",
              "type": "Boolean",
              "description": "Whether the gist should be public or private",
              "required": false
            },
            {
              "name": "files",
              "type": "Map",
              "description": "Files to include in the gist",
              "required": true
            }
          ]
        }
      }
    }
  ]
}