Create an organization repository

Creates a new repository in the specified organization. The authenticated user must be a member of the organization.

OAuth scope requirements

When using OAuth, authorizations must include:

public_repo scope or repo scope to create a public repository. Note: For GitHub AE, use repo scope to create an internal repository.

repo scope to create a private repository

curl --location --request POST 'https://api.github.com/orgs//repos' \ --header 'Content-Type: application/json' \ --data-raw '{ "description": "This is your first repository", "has_issues": true, "has_projects": true, "has_wiki": true, "homepage": "https://github.com", "name": "Hello-World", "private": false }'

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

org

string

必需

Body 参数application/json

allow_merge_commit

boolean

可选

Either true to allow merging pull requests with a merge commit, or false to prevent merging pull requests with merge commits.

默认值:

true

allow_rebase_merge

boolean

可选

Either true to allow rebase-merging pull requests, or false to prevent rebase-merging.

默认值:

true

allow_squash_merge

boolean

可选

Either true to allow squash-merging pull requests, or false to prevent squash-merging.

默认值:

true

auto_init

boolean

可选

Pass true to create an initial commit with empty README.

默认值:

false

delete_branch_on_merge

boolean

可选

Either true to allow automatically deleting head branches when pull requests are merged, or false to prevent automatic deletion.

默认值:

false

description

string

可选

A short description of the repository.

gitignore_template

string

可选

Desired language or platform .gitignore template to apply. Use the name of the template without the extension. For example, "Haskell".

has_issues

boolean

可选

Either true to enable issues for this repository or false to disable them.

默认值:

true

has_projects

boolean

可选

Either true to enable projects for this repository or false to disable them. Note: If you're creating a repository in an organization that has disabled repository projects, the default is false, and if you pass true, the API returns an error.

默认值:

true

has_wiki

boolean

可选

Either true to enable the wiki for this repository or false to disable it.

默认值:

true

homepage

string

可选

A URL with more information about the repository.

is_template

boolean

可选

Either true to make this repo available as a template repository or false to prevent it.

默认值:

false

license_template

string

可选

Choose an open source license template that best suits your needs, and then use the license keyword as the license_template string. For example, "mit" or "mpl-2.0".

name

string

必需

The name of the repository.

private

boolean

可选

Whether the repository is private.

默认值:

false

team_id

integer

可选

The id of the team that will be granted access to this repository. This is only valid when creating a repository in an organization.

visibility

enum<string>

可选

Can be public or private. If your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+, visibility can also be internal. Note: For GitHub Enterprise Server and GitHub AE, this endpoint will only list repositories available to all users on the enterprise. For more information, see "Creating an internal repository" in the GitHub Help documentation.
The visibility parameter overrides the private parameter when you use both parameters with the nebula-preview preview header.

枚举值:

publicprivatevisibilityinternal

示例

返回响应

🟢201Response

application/json

Body

A git repository

allow_merge_commit

boolean

可选

Whether to allow merge commits for pull requests.

默认值:

true

示例值:

true

allow_rebase_merge

boolean

可选

Whether to allow rebase merges for pull requests.

默认值:

true

示例值:

true

allow_squash_merge

boolean

可选

Whether to allow squash merges for pull requests.

默认值:

true

示例值:

true

archive_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}

archived

boolean

必需

Whether the repository is archived.

默认值:

false

assignees_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/assignees{/user}

blobs_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}

branches_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/branches{/branch}

clone_url

string

必需

示例值:

https://github.com/octocat/Hello-World.git

collaborators_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}

comments_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/comments{/number}

commits_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/commits{/sha}

compare_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}

contents_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/contents/{+path}

contributors_url

string <uri>

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/contributors

created_at

string <date-time> | null

必需

示例值:

2011-01-26T19:01:12Z

default_branch

string

必需

The default branch of the repository.

示例值:

master

delete_branch_on_merge

boolean

可选

Whether to delete head branches when pull requests are merged

默认值:

false

示例值:

false

deployments_url

string <uri>

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/deployments

description

string | null

必需

示例值:

This your first repo!

disabled

boolean

必需

Returns whether or not this repository disabled.

downloads_url

string <uri>

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/downloads

events_url

string <uri>

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/events

fork

boolean

必需

forks

integer

必需

forks_count

integer

必需

示例值:

forks_url

string <uri>

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/forks

full_name

string

必需

示例值:

octocat/Hello-World

git_commits_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}

git_refs_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}

git_tags_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}

git_url

string

必需

示例值:

git:github.com/octocat/Hello-World.git

has_downloads

boolean

必需

Whether downloads are enabled.

默认值:

true

示例值:

true

has_issues

boolean

必需

Whether issues are enabled.

默认值:

true

示例值:

true

has_pages

boolean

必需

has_projects

boolean

必需

Whether projects are enabled.

默认值:

true

示例值:

true

has_wiki

boolean

必需

Whether the wiki is enabled.

默认值:

true

示例值:

true

homepage

string <uri> | null

必需

示例值:

https://github.com

hooks_url

string <uri>

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/hooks

html_url

string <uri>

必需

示例值:

https://github.com/octocat/Hello-World

integer

必需

Unique identifier of the repository

示例值:

is_template

boolean

可选

Whether this repository acts as a template that can be used to generate new repositories.

默认值:

false

示例值:

true

issue_comment_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}

issue_events_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/issues/events{/number}

issues_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/issues{/number}

keys_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/keys{/key_id}

labels_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/labels{/name}

language

string | null

必需

languages_url

string <uri>

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/languages

license

null | allOf {1}

必需

object (License Simple)

可选

License Simple

master_branch

string

可选

merges_url

string <uri>

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/merges

milestones_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/milestones{/number}

mirror_url

string <uri> | null

必需

示例值:

git:git.example.com/octocat/Hello-World

name

string

必需

The name of the repository.

示例值:

Team Environment

network_count

integer

可选

node_id

string

必需

示例值:

MDEwOlJlcG9zaXRvcnkxMjk2MjY5

notifications_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}

open_issues

integer

必需

open_issues_count

integer

必需

示例值:

organization

null

可选

Simple User

owner

null

必需

Simple User

permissions

object

可选

admin

boolean

必需

maintain

boolean

可选

pull

boolean

必需

push

boolean

必需

triage

boolean

可选

private

boolean

必需

Whether the repository is private or public.

默认值:

false

pulls_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/pulls{/number}

pushed_at

string <date-time> | null

必需

示例值:

2011-01-26T19:06:43Z

releases_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/releases{/id}

size

integer

必需

示例值:

108

ssh_url

string

必需

示例值:

git@github.com:octocat/Hello-World.git

stargazers_count

integer

必需

示例值:

stargazers_url

string <uri>

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/stargazers

starred_at

string

可选

示例值:

"2020-07-09T00:17:42Z"

statuses_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/statuses/{sha}

subscribers_count

integer

可选

subscribers_url

string <uri>

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/subscribers

subscription_url

string <uri>

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/subscription

svn_url

string <uri>

必需

示例值:

https://svn.github.com/octocat/Hello-World

tags_url

string <uri>

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/tags

teams_url

string <uri>

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/teams

temp_clone_token

string

可选

template_repository

object | null

可选

allow_merge_commit

boolean

可选

allow_rebase_merge

boolean

可选

allow_squash_merge

boolean

可选

archive_url

string

可选

archived

boolean

可选

assignees_url

string

可选

blobs_url

string

可选

branches_url

string

可选

clone_url

string

可选

collaborators_url

string

可选

comments_url

string

可选

commits_url

string

可选

compare_url

string

可选

contents_url

string

可选

contributors_url

string

可选

created_at

string

可选

default_branch

string

可选

delete_branch_on_merge

boolean

可选

deployments_url

string

可选

description

string

可选

disabled

boolean

可选

downloads_url

string

可选

events_url

string

可选

fork

boolean

可选

forks_count

integer

可选

forks_url

string

可选

full_name

string

可选

git_commits_url

string

可选

git_refs_url

string

可选

git_tags_url

string

可选

git_url

string

可选

has_downloads

boolean

可选

has_issues

boolean

可选

has_pages

boolean

可选

has_projects

boolean

可选

has_wiki

boolean

可选

homepage

string

可选

hooks_url

string

可选

html_url

string

可选

integer

可选

is_template

boolean

可选

issue_comment_url

string

可选

issue_events_url

string

可选

issues_url

string

可选

keys_url

string

可选

labels_url

string

可选

language

string

可选

languages_url

string

可选

merges_url

string

可选

milestones_url

string

可选

mirror_url

string

可选

name

string

可选

network_count

integer

可选

node_id

string

可选

notifications_url

string

可选

open_issues_count

integer

可选

owner

object

可选

permissions

object

可选

private

boolean

可选

pulls_url

string

可选

pushed_at

string

可选

releases_url

string

可选

size

integer

可选

ssh_url

string

可选

stargazers_count

integer

可选

stargazers_url

string

可选

statuses_url

string

可选

subscribers_count

integer

可选

subscribers_url

string

可选

subscription_url

string

可选

svn_url

string

可选

tags_url

string

可选

teams_url

string

可选

temp_clone_token

string

可选

topics

array[string]

可选

trees_url

string

可选

updated_at

string

可选

url

string

可选

visibility

string

可选

watchers_count

integer

可选

topics

array[string]

可选

trees_url

string

必需

示例值:

http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}

updated_at

string <date-time> | null

必需

示例值:

2011-01-26T19:14:43Z

url

string <uri>

必需

示例值:

https://api.github.com/repos/octocat/Hello-World

visibility

string

可选

The repository visibility: public, private, or internal.

默认值:

public

watchers

integer

必需

watchers_count

integer

必需

示例值:

🟠403403

🟠422422