OpenAPI Extensions

This document describes the OpenAPI extensions used in GitHub's REST API OpenAPI descriptions.

`x-displayName`

To define a display name, typically for documentation interfaces, for the corresponding tag.

This applies to the Tag Object.

The value should be a string.

tags:
  name: actions
  description: Endpoints to manage GitHub Actions using the REST API.
  x-displayName: GitHub Actions

Provides extra information used to generate Octokit SDKs.

The x-github specification extension is applied to the Operation Object.

Field Name	Type	Description
triggersNotification	boolean	Operations that trigger notification are more likely to trigger abuse limits. We increase the default throttling from 1s between requests to 3s between requests for these operations.
deprecationDate	string	The date when we publicly announce that the operation will eventually be removed. After this date, the `deprecated` property should also be set to `true`. Format: `YYYY-MM-DD`
removalDate	string	The date when we stop displaying documentation for the operation on docs.github.com and stop including it in new Octokit major versions. Format: `YYYY-MM-DD`
githubCloudOnly	boolean	Used in a separate plugin for GitHub Enterprise Cloud users.
enabledForGitHubApps	boolean	True if this operation is enabled for apps
previews	array	Previews will be deprecated soon. An array of API previews, with name, description, and whether the preview is required for this particular operation.

x-github:
  enabledForGitHubApps: true
  githubCloudOnly: false
  previews: []

Path parameter extension marking a certain parameter as supporting multiple URL segments. It's recommended to use an URL encoded value when possible.

The x-multi-segment extension applies only on path parameters. The value should be a boolean. Defaults to false.

- name: ref
  in: path
  required: true
  schema:
    type: string
  x-multi-segment: true