6.0.1 • Published 4 years ago

@octokit/plugin-enterprise-rest v6.0.1

Weekly downloads
1,082,108
License
MIT
Repository
github
Last release
4 years ago

plugin-enterprise-rest.js

Octokit plugin for GitHub Enterprise REST APIs

@latest Build Status Greenkeeper badge

@octokit/rest does not include methods for Enterprise Administration as they are not usable against https://api.github.com. This plugin adds these endpoints based on the GitHub Enterprise version you need.

Usage

const Octokit = require("@octokit/rest").plugin(
  require("@octokit/plugin-enterprise-rest/ghe-2.18")
);
const octokit = new Octokit({
  baseUrl: "https://github.acme-inc.com/api/v3"
});

octokit.enterpriseAdmin.promoteOrdinaryUserToSiteAdministrator({
  username: "octocat"
});

There can be differences in REST API between api.github.com and the different GitHub Enterprise versions. Some of the endpoint methods from @octokit/rest might not work. For these cases you can load the endpoint methods for all scopes for a certain GitHub Enterprise version, not only the .enterprise scope. This will override existing endpoint methods.

const Octokit = require("@octokit/rest").plugin(
  require("@octokit/plugin-enterprise-rest/ghe-2.18/all")
);
const octokit = new Octokit({
  baseUrl: "https://github.acme-inc.com/api/v3"
});

octokit.issues.addLabels({
  owner,
  repo,
  number,
  labels: ["foo", "bar"]
});
// now sends `["foo", "bar"]` in the request body, instead of `{"labels": ["foo", "bar"]}`

API docs

See the README.md files in the ghe-* folders for a list of available endpoint methods for the respective GitHub Enterprise version.

How it works

The route definitions for the currently supported GitHub Enterprise versions are build automatically from @octokit/routes. Each time there is a new @octokit/routes release, Greenkeeper will send a pull request which updates the dependency in package.json and package-lock.json. That kicks of a build on Travis CI where the greenkeeper-routes-update script is run. If there is a change, the script updates the *.json definition files in the pull request.

LICENSE

MIT

6.0.1

4 years ago

6.0.0

4 years ago

5.0.0

4 years ago

4.0.0

4 years ago

3.6.2

5 years ago

3.6.1

5 years ago

3.6.0

5 years ago

3.5.0

5 years ago

3.4.2

5 years ago

3.4.1

5 years ago

3.4.0

5 years ago

3.3.0

5 years ago

3.2.0

5 years ago

3.1.0

5 years ago

3.0.0

5 years ago

2.2.2

5 years ago

2.2.1

5 years ago

2.2.0

5 years ago

2.1.2

5 years ago

2.1.1

5 years ago

2.1.0

5 years ago

2.0.3

5 years ago

2.0.2

5 years ago

2.0.1

5 years ago

2.0.0

5 years ago

1.0.0

5 years ago