--- title: "Create draft item for user owned project" method: POST path: "/user/{user_id}/projectsV2/{project_number}/drafts" tags: ["projects"] --- # Create draft item for user owned project `POST /user/{user_id}/projectsV2/{project_number}/drafts` Create draft issue item for the specified user owned project. ## Path parameters - `user_id` string, required - `project_number` integer, required ## Request body - object - `title` string, required — The title of the draft issue item to create in the project. - `body` string — The body content of the draft issue item to create in the project. ## Response `201` Response - ProjectsV2ItemSimple — An item belonging to a project - `id` number, required — The unique identifier of the project item. - `node_id` string — The node ID of the project item. - `content` union — The content represented by the item. - Issue — Issues are a great way to keep track of tasks, enhancements, and bugs for your projects. - `id` integer, required - `node_id` string, required - `url` string, uri, required — URL for the issue - `repository_url` string, uri, required - `labels_url` string, required - `comments_url` string, uri, required - `events_url` string, uri, required - `html_url` string, uri, required - `number` integer, required — Number uniquely identifying the issue within its repository - `state` string, required — State of the issue; either 'open' or 'closed' - `state_reason` 'completed' | 'reopened' | 'not_planned' | 'duplicate', nullable — The reason for the current state - `title` string, required — Title of the issue - `body` string, nullable — Contents of the issue - `user` NullableSimpleUser, nullable, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `labels` union[], required — Labels to associate with this issue; pass one or more label names to replace the set of labels on this issue; send an empty array to clear all labels from the issue; note that the labels are silently dropped for users without push access to the repository - union - string - object - `id` integer - `node_id` string - `url` string, uri - `name` string - `description` string, nullable - `color` string, nullable - `default` boolean - `assignee` NullableSimpleUser, nullable, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `assignees` SimpleUser[] - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `milestone` NullableMilestone, nullable, required — A collection of related issues and pull requests. - `url` string, uri, required - `html_url` string, uri, required - `labels_url` string, uri, required - `id` integer, required - `node_id` string, required - `number` integer, required — The number of the milestone. - `state` 'open' | 'closed', required — The state of the milestone. - `title` string, required — The title of the milestone. - `description` string, nullable, required - `creator` NullableSimpleUser, nullable, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `open_issues` integer, required - `closed_issues` integer, required - `created_at` string, date-time, required - `updated_at` string, date-time, required - `closed_at` string, date-time, nullable, required - `due_on` string, date-time, nullable, required - `locked` boolean, required - `active_lock_reason` string, nullable - `comments` integer, required - `pull_request` object - `merged_at` string, date-time, nullable - `diff_url` string, uri, nullable, required - `html_url` string, uri, nullable, required - `patch_url` string, uri, nullable, required - `url` string, uri, nullable, required - `closed_at` string, date-time, nullable, required - `created_at` string, date-time, required - `updated_at` string, date-time, required - `draft` boolean - `closed_by` NullableSimpleUser, nullable — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `body_html` string - `body_text` string - `timeline_url` string, uri - `type` IssueType, nullable — The type assigned to the issue. This is only present for issues in repositories where issue types are supported. - `id` integer, required — The unique identifier of the issue type. - `node_id` string, required — The node identifier of the issue type. - `name` string, required — The name of the issue type. - `description` string, nullable, required — The description of the issue type. - `color` 'gray' | 'blue' | 'green' | 'yellow' | 'orange' | 'red' | 'pink' | 'purple', nullable — The color of the issue type. - `created_at` string, date-time — The time the issue type created. - `updated_at` string, date-time — The time the issue type last updated. - `is_enabled` boolean — The enabled state of the issue type. - `repository` Repository — A repository on GitHub. - `id` integer, required — Unique identifier of the repository - `node_id` string, required - `name` string, required — The name of the repository. - `full_name` string, required - `license` NullableLicenseSimple, nullable, required — License Simple - `key` string, required - `name` string, required - `url` string, uri, nullable, required - `spdx_id` string, nullable, required - `node_id` string, required - `html_url` string, uri - `forks` integer, required - `permissions` object - `admin` boolean, required - `pull` boolean, required - `triage` boolean - `push` boolean, required - `maintain` boolean - `owner` SimpleUser, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `private` boolean, required — Whether the repository is private or public. - `html_url` string, uri, required - `description` string, nullable, required - `fork` boolean, required - `url` string, uri, required - `archive_url` string, required - `assignees_url` string, required - `blobs_url` string, required - `branches_url` string, required - `collaborators_url` string, required - `comments_url` string, required - `commits_url` string, required - `compare_url` string, required - `contents_url` string, required - `contributors_url` string, uri, required - `deployments_url` string, uri, required - `downloads_url` string, uri, required - `events_url` string, uri, required - `forks_url` string, uri, required - `git_commits_url` string, required - `git_refs_url` string, required - `git_tags_url` string, required - `git_url` string, required - `issue_comment_url` string, required - `issue_events_url` string, required - `issues_url` string, required - `keys_url` string, required - `labels_url` string, required - `languages_url` string, uri, required - `merges_url` string, uri, required - `milestones_url` string, required - `notifications_url` string, required - `pulls_url` string, required - `releases_url` string, required - `ssh_url` string, required - `stargazers_url` string, uri, required - `statuses_url` string, required - `subscribers_url` string, uri, required - `subscription_url` string, uri, required - `tags_url` string, uri, required - `teams_url` string, uri, required - `trees_url` string, required - `clone_url` string, required - `mirror_url` string, uri, nullable, required - `hooks_url` string, uri, required - `svn_url` string, uri, required - `homepage` string, uri, nullable, required - `language` string, nullable, required - `forks_count` integer, required - `stargazers_count` integer, required - `watchers_count` integer, required - `size` integer, required — The size of the repository, in kilobytes. Size is calculated hourly. When a repository is initially created, the size is 0. - `default_branch` string, required — The default branch of the repository. - `open_issues_count` integer, required - `is_template` boolean — Whether this repository acts as a template that can be used to generate new repositories. - `topics` string[] - `has_issues` boolean, required — Whether issues are enabled. - `has_projects` boolean, required — Whether projects are enabled. - `has_wiki` boolean, required — Whether the wiki is enabled. - `has_pages` boolean, required - `has_downloads` boolean, required — Whether downloads are enabled. - `has_discussions` boolean — Whether discussions are enabled. - `has_pull_requests` boolean — Whether pull requests are enabled. - `pull_request_creation_policy` 'all' | 'collaborators_only' — The policy controlling who can create pull requests: all or collaborators_only. - `archived` boolean, required — Whether the repository is archived. - `disabled` boolean, required — Returns whether or not this repository disabled. - `visibility` string — The repository visibility: public, private, or internal. - `pushed_at` string, date-time, nullable, required - `created_at` string, date-time, nullable, required - `updated_at` string, date-time, nullable, required - `allow_rebase_merge` boolean — Whether to allow rebase merges for pull requests. - `temp_clone_token` string - `allow_squash_merge` boolean — Whether to allow squash merges for pull requests. - `allow_auto_merge` boolean — Whether to allow Auto-merge to be used on pull requests. - `delete_branch_on_merge` boolean — Whether to delete head branches when pull requests are merged - `allow_update_branch` boolean — Whether or not a pull request head branch that is behind its base branch can always be updated even if it is not required to be up to date before merging. - `use_squash_pr_title_as_default` boolean — Whether a squash merge commit can use the pull request title as default. **This property is closing down. Please use `squash_merge_commit_title` instead. - `squash_merge_commit_title` 'PR_TITLE' | 'COMMIT_OR_PR_TITLE' — The default value for a squash merge commit title: - `PR_TITLE` - default to the pull request's title. - `COMMIT_OR_PR_TITLE` - default to the commit's title (if only one commit) or the pull request's title (when more than one commit). - `squash_merge_commit_message` 'PR_BODY' | 'COMMIT_MESSAGES' | 'BLANK' — The default value for a squash merge commit message: - `PR_BODY` - default to the pull request's body. - `COMMIT_MESSAGES` - default to the branch's commit messages. - `BLANK` - default to a blank commit message. - `merge_commit_title` 'PR_TITLE' | 'MERGE_MESSAGE' — The default value for a merge commit title. - `PR_TITLE` - default to the pull request's title. - `MERGE_MESSAGE` - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name). - `merge_commit_message` 'PR_BODY' | 'PR_TITLE' | 'BLANK' — The default value for a merge commit message. - `PR_TITLE` - default to the pull request's title. - `PR_BODY` - default to the pull request's body. - `BLANK` - default to a blank commit message. - `allow_merge_commit` boolean — Whether to allow merge commits for pull requests. - `allow_forking` boolean — Whether to allow forking this repo - `web_commit_signoff_required` boolean — Whether to require contributors to sign off on web-based commits - `open_issues` integer, required - `watchers` integer, required - `master_branch` string - `starred_at` string - `anonymous_access_enabled` boolean — Whether anonymous git access is enabled for this repository - `code_search_index_status` object — The status of the code search index for this repository - `lexical_search_ok` boolean - `lexical_commit_sha` string - `performed_via_github_app` NullableIntegration, nullable — GitHub apps are a new way to extend GitHub. They can be installed directly on organizations and user accounts and granted access to specific repositories. They come with granular permissions and built-in webhooks. GitHub apps are first class actors within GitHub. - `id` integer, required — Unique identifier of the GitHub app - `slug` string — The slug name of the GitHub app - `node_id` string, required - `client_id` string - `owner` union, required - SimpleUser — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - Enterprise — An enterprise on GitHub. - `description` string, nullable — A short description of the enterprise. - `html_url` string, uri, required - `website_url` string, uri, nullable — The enterprise's website URL. - `id` integer, required — Unique identifier of the enterprise - `node_id` string, required - `name` string, required — The name of the enterprise. - `slug` string, required — The slug url identifier for the enterprise. - `created_at` string, date-time, nullable, required - `updated_at` string, date-time, nullable, required - `avatar_url` string, uri, required - `name` string, required — The name of the GitHub app - `description` string, nullable, required - `external_url` string, uri, required - `html_url` string, uri, required - `created_at` string, date-time, required - `updated_at` string, date-time, required - `permissions` object, required — The set of permissions for the GitHub app - `issues` string - `checks` string - `metadata` string - `contents` string - `deployments` string - `events` string[], required — The list of events for the GitHub app. Note that the `installation_target`, `security_advisory`, and `meta` events are not included because they are global events and not specific to an installation. - `installations_count` integer — The number of installations associated with the GitHub app. Only returned when the integration is requesting details about itself. - `author_association` 'COLLABORATOR' | 'CONTRIBUTOR' | 'FIRST_TIMER' | 'FIRST_TIME_CONTRIBUTOR' | 'MANNEQUIN' | 'MEMBER' | 'NONE' | 'OWNER' — How the author is associated with the repository. - `reactions` ReactionRollup - `url` string, uri, required - `total_count` integer, required - `+1` integer, required - `-1` integer, required - `laugh` integer, required - `confused` integer, required - `heart` integer, required - `hooray` integer, required - `eyes` integer, required - `rocket` integer, required - `sub_issues_summary` SubIssuesSummary - `total` integer, required - `completed` integer, required - `percent_completed` integer, required - `parent_issue_url` string, uri, nullable — URL to get the parent issue of this issue, if it is a sub-issue - `pinned_comment` NullableIssueComment, nullable — Comments provide a way for people to collaborate on an issue. - `id` integer, required — Unique identifier of the issue comment - `node_id` string, required - `url` string, uri, required — URL for the issue comment - `body` string — Contents of the issue comment - `body_text` string - `body_html` string - `html_url` string, uri, required - `user` NullableSimpleUser, nullable, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `created_at` string, date-time, required - `updated_at` string, date-time, required - `issue_url` string, uri, required - `author_association` 'COLLABORATOR' | 'CONTRIBUTOR' | 'FIRST_TIMER' | 'FIRST_TIME_CONTRIBUTOR' | 'MANNEQUIN' | 'MEMBER' | 'NONE' | 'OWNER' — How the author is associated with the repository. - `performed_via_github_app` NullableIntegration, nullable — GitHub apps are a new way to extend GitHub. They can be installed directly on organizations and user accounts and granted access to specific repositories. They come with granular permissions and built-in webhooks. GitHub apps are first class actors within GitHub. - `id` integer, required — Unique identifier of the GitHub app - `slug` string — The slug name of the GitHub app - `node_id` string, required - `client_id` string - `owner` union, required - SimpleUser — A GitHub user. - … - Enterprise — An enterprise on GitHub. - … - `name` string, required — The name of the GitHub app - `description` string, nullable, required - `external_url` string, uri, required - `html_url` string, uri, required - `created_at` string, date-time, required - `updated_at` string, date-time, required - `permissions` object, required — The set of permissions for the GitHub app - `issues` string - `checks` string - `metadata` string - `contents` string - `deployments` string - `events` string[], required — The list of events for the GitHub app. Note that the `installation_target`, `security_advisory`, and `meta` events are not included because they are global events and not specific to an installation. - `installations_count` integer — The number of installations associated with the GitHub app. Only returned when the integration is requesting details about itself. - `reactions` ReactionRollup - `url` string, uri, required - `total_count` integer, required - `+1` integer, required - `-1` integer, required - `laugh` integer, required - `confused` integer, required - `heart` integer, required - `hooray` integer, required - `eyes` integer, required - `rocket` integer, required - `pin` NullablePinnedIssueComment, nullable — Context around who pinned an issue comment and when it was pinned. - `pinned_at` string, date-time, required - `pinned_by` NullableSimpleUser, nullable, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `minimized` NullableIssueCommentMinimized, nullable — Details about why an issue comment was minimized. - `reason` string, nullable, required — The reason the comment was minimized. - `issue_dependencies_summary` IssueDependenciesSummary - `blocked_by` integer, required - `blocking` integer, required - `total_blocked_by` integer, required - `total_blocking` integer, required - `issue_field_values` IssueFieldValue[] - `issue_field_id` integer, required — Unique identifier for the issue field. - `issue_field_name` string — The human-readable name of the issue field. - `node_id` string, required - `data_type` 'text' | 'single_select' | 'multi_select' | 'number' | 'date', required — The data type of the issue field - `value` union, required — The value of the issue field - string - number - integer - `single_select_option` object, nullable — Details about the selected option (only present for single_select fields) - `id` integer, required — Unique identifier for the option. - `name` string, required — The name of the option - `color` string, required — The color of the option - `multi_select_options` object[], nullable — Details about the selected options - `id` integer, required — Unique identifier for the option. - `name` string, required — The name of the option - `color` string, required — The color of the option - PullRequestSimple — Pull Request Simple - `url` string, uri, required - `id` integer, required - `node_id` string, required - `html_url` string, uri, required - `diff_url` string, uri, required - `patch_url` string, uri, required - `issue_url` string, uri, required - `commits_url` string, uri, required - `review_comments_url` string, uri, required - `review_comment_url` string, required - `comments_url` string, uri, required - `statuses_url` string, uri, required - `number` integer, required - `state` string, required - `locked` boolean, required - `title` string, required - `user` NullableSimpleUser, nullable, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `body` string, nullable, required - `labels` object[], required - `id` integer, required - `node_id` string, required - `url` string, required - `name` string, required - `description` string, required - `color` string, required - `default` boolean, required - `milestone` NullableMilestone, nullable, required — A collection of related issues and pull requests. - `url` string, uri, required - `html_url` string, uri, required - `labels_url` string, uri, required - `id` integer, required - `node_id` string, required - `number` integer, required — The number of the milestone. - `state` 'open' | 'closed', required — The state of the milestone. - `title` string, required — The title of the milestone. - `description` string, nullable, required - `creator` NullableSimpleUser, nullable, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `open_issues` integer, required - `closed_issues` integer, required - `created_at` string, date-time, required - `updated_at` string, date-time, required - `closed_at` string, date-time, nullable, required - `due_on` string, date-time, nullable, required - `active_lock_reason` string, nullable - `created_at` string, date-time, required - `updated_at` string, date-time, required - `closed_at` string, date-time, nullable, required - `merged_at` string, date-time, nullable, required - `merge_commit_sha` string, nullable, required - `assignee` NullableSimpleUser, nullable, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `assignees` SimpleUser[] - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `requested_reviewers` SimpleUser[] - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `requested_teams` Team[] - `id` integer, required - `node_id` string, required - `name` string, required - `slug` string, required - `description` string, nullable, required - `privacy` string - `notification_setting` string - `permission` string, required - `permissions` object - `pull` boolean, required - `triage` boolean, required - `push` boolean, required - `maintain` boolean, required - `admin` boolean, required - `url` string, uri, required - `html_url` string, uri, required - `members_url` string, required - `repositories_url` string, uri, required - `type` 'enterprise' | 'organization', required — The ownership type of the team - `access_source` 'direct' | 'organization' | 'enterprise' — How the team's access to the repository was granted. This property is only present when the team is returned in a repository context, such as `GET /repos/{owner}/{repo}/teams`. - `organization_id` integer — Unique identifier of the organization to which this team belongs - `enterprise_id` integer — Unique identifier of the enterprise to which this team belongs - `parent` NullableTeamSimple, nullable, required — Groups of organization members that gives permissions on specified repositories. - `id` integer, required — Unique identifier of the team - `node_id` string, required - `url` string, uri, required — URL for the team - `members_url` string, required - `name` string, required — Name of the team - `description` string, nullable, required — Description of the team - `permission` string, required — Permission that the team will have for its repositories - `privacy` string — The level of privacy this team should have - `notification_setting` string — The notification setting the team has set - `html_url` string, uri, required - `repositories_url` string, uri, required - `slug` string, required - `ldap_dn` string — Distinguished Name (DN) that team maps to within LDAP environment - `type` 'enterprise' | 'organization', required — The ownership type of the team - `organization_id` integer — Unique identifier of the organization to which this team belongs - `enterprise_id` integer — Unique identifier of the enterprise to which this team belongs - `head` object, required - `label` string, required - `ref` string, required - `repo` Repository, required — A repository on GitHub. - `id` integer, required — Unique identifier of the repository - `node_id` string, required - `name` string, required — The name of the repository. - `full_name` string, required - `license` NullableLicenseSimple, nullable, required — License Simple - `key` string, required - `name` string, required - `url` string, uri, nullable, required - `spdx_id` string, nullable, required - `node_id` string, required - `html_url` string, uri - `forks` integer, required - `permissions` object - `admin` boolean, required - `pull` boolean, required - `triage` boolean - `push` boolean, required - `maintain` boolean - `owner` SimpleUser, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `private` boolean, required — Whether the repository is private or public. - `html_url` string, uri, required - `description` string, nullable, required - `fork` boolean, required - `url` string, uri, required - `archive_url` string, required - `assignees_url` string, required - `blobs_url` string, required - `branches_url` string, required - `collaborators_url` string, required - `comments_url` string, required - `commits_url` string, required - `compare_url` string, required - `contents_url` string, required - `contributors_url` string, uri, required - `deployments_url` string, uri, required - `downloads_url` string, uri, required - `events_url` string, uri, required - `forks_url` string, uri, required - `git_commits_url` string, required - `git_refs_url` string, required - `git_tags_url` string, required - `git_url` string, required - `issue_comment_url` string, required - `issue_events_url` string, required - `issues_url` string, required - `keys_url` string, required - `labels_url` string, required - `languages_url` string, uri, required - `merges_url` string, uri, required - `milestones_url` string, required - `notifications_url` string, required - `pulls_url` string, required - `releases_url` string, required - `ssh_url` string, required - `stargazers_url` string, uri, required - `statuses_url` string, required - `subscribers_url` string, uri, required - `subscription_url` string, uri, required - `tags_url` string, uri, required - `teams_url` string, uri, required - `trees_url` string, required - `clone_url` string, required - `mirror_url` string, uri, nullable, required - `hooks_url` string, uri, required - `svn_url` string, uri, required - `homepage` string, uri, nullable, required - `language` string, nullable, required - `forks_count` integer, required - `stargazers_count` integer, required - `watchers_count` integer, required - `size` integer, required — The size of the repository, in kilobytes. Size is calculated hourly. When a repository is initially created, the size is 0. - `default_branch` string, required — The default branch of the repository. - `open_issues_count` integer, required - `is_template` boolean — Whether this repository acts as a template that can be used to generate new repositories. - `topics` string[] - `has_issues` boolean, required — Whether issues are enabled. - `has_projects` boolean, required — Whether projects are enabled. - `has_wiki` boolean, required — Whether the wiki is enabled. - `has_pages` boolean, required - `has_downloads` boolean, required — Whether downloads are enabled. - `has_discussions` boolean — Whether discussions are enabled. - `has_pull_requests` boolean — Whether pull requests are enabled. - `pull_request_creation_policy` 'all' | 'collaborators_only' — The policy controlling who can create pull requests: all or collaborators_only. - `archived` boolean, required — Whether the repository is archived. - `disabled` boolean, required — Returns whether or not this repository disabled. - `visibility` string — The repository visibility: public, private, or internal. - `pushed_at` string, date-time, nullable, required - `created_at` string, date-time, nullable, required - `updated_at` string, date-time, nullable, required - `allow_rebase_merge` boolean — Whether to allow rebase merges for pull requests. - `temp_clone_token` string - `allow_squash_merge` boolean — Whether to allow squash merges for pull requests. - `allow_auto_merge` boolean — Whether to allow Auto-merge to be used on pull requests. - `delete_branch_on_merge` boolean — Whether to delete head branches when pull requests are merged - `allow_update_branch` boolean — Whether or not a pull request head branch that is behind its base branch can always be updated even if it is not required to be up to date before merging. - `use_squash_pr_title_as_default` boolean — Whether a squash merge commit can use the pull request title as default. **This property is closing down. Please use `squash_merge_commit_title` instead. - `squash_merge_commit_title` 'PR_TITLE' | 'COMMIT_OR_PR_TITLE' — The default value for a squash merge commit title: - `PR_TITLE` - default to the pull request's title. - `COMMIT_OR_PR_TITLE` - default to the commit's title (if only one commit) or the pull request's title (when more than one commit). - `squash_merge_commit_message` 'PR_BODY' | 'COMMIT_MESSAGES' | 'BLANK' — The default value for a squash merge commit message: - `PR_BODY` - default to the pull request's body. - `COMMIT_MESSAGES` - default to the branch's commit messages. - `BLANK` - default to a blank commit message. - `merge_commit_title` 'PR_TITLE' | 'MERGE_MESSAGE' — The default value for a merge commit title. - `PR_TITLE` - default to the pull request's title. - `MERGE_MESSAGE` - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name). - `merge_commit_message` 'PR_BODY' | 'PR_TITLE' | 'BLANK' — The default value for a merge commit message. - `PR_TITLE` - default to the pull request's title. - `PR_BODY` - default to the pull request's body. - `BLANK` - default to a blank commit message. - `allow_merge_commit` boolean — Whether to allow merge commits for pull requests. - `allow_forking` boolean — Whether to allow forking this repo - `web_commit_signoff_required` boolean — Whether to require contributors to sign off on web-based commits - `open_issues` integer, required - `watchers` integer, required - `master_branch` string - `starred_at` string - `anonymous_access_enabled` boolean — Whether anonymous git access is enabled for this repository - `code_search_index_status` object — The status of the code search index for this repository - `lexical_search_ok` boolean - `lexical_commit_sha` string - `sha` string, required - `user` NullableSimpleUser, nullable, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `base` object, required - `label` string, required - `ref` string, required - `repo` Repository, required — A repository on GitHub. - `id` integer, required — Unique identifier of the repository - `node_id` string, required - `name` string, required — The name of the repository. - `full_name` string, required - `license` NullableLicenseSimple, nullable, required — License Simple - `key` string, required - `name` string, required - `url` string, uri, nullable, required - `spdx_id` string, nullable, required - `node_id` string, required - `html_url` string, uri - `forks` integer, required - `permissions` object - `admin` boolean, required - `pull` boolean, required - `triage` boolean - `push` boolean, required - `maintain` boolean - `owner` SimpleUser, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `private` boolean, required — Whether the repository is private or public. - `html_url` string, uri, required - `description` string, nullable, required - `fork` boolean, required - `url` string, uri, required - `archive_url` string, required - `assignees_url` string, required - `blobs_url` string, required - `branches_url` string, required - `collaborators_url` string, required - `comments_url` string, required - `commits_url` string, required - `compare_url` string, required - `contents_url` string, required - `contributors_url` string, uri, required - `deployments_url` string, uri, required - `downloads_url` string, uri, required - `events_url` string, uri, required - `forks_url` string, uri, required - `git_commits_url` string, required - `git_refs_url` string, required - `git_tags_url` string, required - `git_url` string, required - `issue_comment_url` string, required - `issue_events_url` string, required - `issues_url` string, required - `keys_url` string, required - `labels_url` string, required - `languages_url` string, uri, required - `merges_url` string, uri, required - `milestones_url` string, required - `notifications_url` string, required - `pulls_url` string, required - `releases_url` string, required - `ssh_url` string, required - `stargazers_url` string, uri, required - `statuses_url` string, required - `subscribers_url` string, uri, required - `subscription_url` string, uri, required - `tags_url` string, uri, required - `teams_url` string, uri, required - `trees_url` string, required - `clone_url` string, required - `mirror_url` string, uri, nullable, required - `hooks_url` string, uri, required - `svn_url` string, uri, required - `homepage` string, uri, nullable, required - `language` string, nullable, required - `forks_count` integer, required - `stargazers_count` integer, required - `watchers_count` integer, required - `size` integer, required — The size of the repository, in kilobytes. Size is calculated hourly. When a repository is initially created, the size is 0. - `default_branch` string, required — The default branch of the repository. - `open_issues_count` integer, required - `is_template` boolean — Whether this repository acts as a template that can be used to generate new repositories. - `topics` string[] - `has_issues` boolean, required — Whether issues are enabled. - `has_projects` boolean, required — Whether projects are enabled. - `has_wiki` boolean, required — Whether the wiki is enabled. - `has_pages` boolean, required - `has_downloads` boolean, required — Whether downloads are enabled. - `has_discussions` boolean — Whether discussions are enabled. - `has_pull_requests` boolean — Whether pull requests are enabled. - `pull_request_creation_policy` 'all' | 'collaborators_only' — The policy controlling who can create pull requests: all or collaborators_only. - `archived` boolean, required — Whether the repository is archived. - `disabled` boolean, required — Returns whether or not this repository disabled. - `visibility` string — The repository visibility: public, private, or internal. - `pushed_at` string, date-time, nullable, required - `created_at` string, date-time, nullable, required - `updated_at` string, date-time, nullable, required - `allow_rebase_merge` boolean — Whether to allow rebase merges for pull requests. - `temp_clone_token` string - `allow_squash_merge` boolean — Whether to allow squash merges for pull requests. - `allow_auto_merge` boolean — Whether to allow Auto-merge to be used on pull requests. - `delete_branch_on_merge` boolean — Whether to delete head branches when pull requests are merged - `allow_update_branch` boolean — Whether or not a pull request head branch that is behind its base branch can always be updated even if it is not required to be up to date before merging. - `use_squash_pr_title_as_default` boolean — Whether a squash merge commit can use the pull request title as default. **This property is closing down. Please use `squash_merge_commit_title` instead. - `squash_merge_commit_title` 'PR_TITLE' | 'COMMIT_OR_PR_TITLE' — The default value for a squash merge commit title: - `PR_TITLE` - default to the pull request's title. - `COMMIT_OR_PR_TITLE` - default to the commit's title (if only one commit) or the pull request's title (when more than one commit). - `squash_merge_commit_message` 'PR_BODY' | 'COMMIT_MESSAGES' | 'BLANK' — The default value for a squash merge commit message: - `PR_BODY` - default to the pull request's body. - `COMMIT_MESSAGES` - default to the branch's commit messages. - `BLANK` - default to a blank commit message. - `merge_commit_title` 'PR_TITLE' | 'MERGE_MESSAGE' — The default value for a merge commit title. - `PR_TITLE` - default to the pull request's title. - `MERGE_MESSAGE` - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name). - `merge_commit_message` 'PR_BODY' | 'PR_TITLE' | 'BLANK' — The default value for a merge commit message. - `PR_TITLE` - default to the pull request's title. - `PR_BODY` - default to the pull request's body. - `BLANK` - default to a blank commit message. - `allow_merge_commit` boolean — Whether to allow merge commits for pull requests. - `allow_forking` boolean — Whether to allow forking this repo - `web_commit_signoff_required` boolean — Whether to require contributors to sign off on web-based commits - `open_issues` integer, required - `watchers` integer, required - `master_branch` string - `starred_at` string - `anonymous_access_enabled` boolean — Whether anonymous git access is enabled for this repository - `code_search_index_status` object — The status of the code search index for this repository - `lexical_search_ok` boolean - `lexical_commit_sha` string - `sha` string, required - `user` NullableSimpleUser, nullable, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `_links` object, required - `comments` Link, required — Hypermedia Link - `href` string, required - `commits` Link, required — Hypermedia Link - `href` string, required - `statuses` Link, required — Hypermedia Link - `href` string, required - `html` Link, required — Hypermedia Link - `href` string, required - `issue` Link, required — Hypermedia Link - `href` string, required - `review_comments` Link, required — Hypermedia Link - `href` string, required - `review_comment` Link, required — Hypermedia Link - `href` string, required - `self` Link, required — Hypermedia Link - `href` string, required - `author_association` 'COLLABORATOR' | 'CONTRIBUTOR' | 'FIRST_TIMER' | 'FIRST_TIME_CONTRIBUTOR' | 'MANNEQUIN' | 'MEMBER' | 'NONE' | 'OWNER', required — How the author is associated with the repository. - `auto_merge` AutoMerge, nullable, required — The status of auto merging a pull request. - `enabled_by` SimpleUser, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `merge_method` 'merge' | 'squash' | 'rebase', required — The merge method to use. - `commit_title` string, required — Title for the merge commit message. - `commit_message` string, required — Commit message for the merge commit. - `stack` PullRequestStack, nullable — The stack information associated with a pull request. - `base` object, required - `ref` string, required — The base ref of the stack this pull request belongs to. - `sha` string, required — The base SHA of the stack this pull request belongs to. - `size` integer — The total number of pull requests in the stack. - `position` integer — The one-based position of this pull request within the stack, where 1 is the bottom of the stack. - `id` integer — The ID of the stack that this pull request belongs to. - `number` integer — The number of the stack that this pull request belongs to. - `draft` boolean — Indicates whether or not the pull request is a draft. - ProjectsV2DraftIssue — A draft issue in a project - `id` number, required — The ID of the draft issue - `node_id` string, required — The node ID of the draft issue - `title` string, required — The title of the draft issue - `body` string, nullable — The body content of the draft issue - `user` NullableSimpleUser, nullable, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `created_at` string, date-time, required — The time the draft issue was created - `updated_at` string, date-time, required — The time the draft issue was last updated - `content_type` 'Issue' | 'PullRequest' | 'DraftIssue', required — The type of content tracked in a project item - `creator` SimpleUser — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `created_at` string, date-time, required — The time when the item was created. - `updated_at` string, date-time, required — The time when the item was last updated. - `archived_at` string, date-time, nullable, required — The time when the item was archived. - `project_url` string, uri — The URL of the project this item belongs to. - `item_url` string, uri — The URL of the item in the project. ## Other responses - `304` — Not modified - `401` — Requires authentication - `403` — Forbidden --- [API](https://skmtc.net/github/apis/github-v3-rest-api-2.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api-2/versions/8ae6d0c8716e/schema)