REST API endpoints for draft Project items

Use the REST API to manage draft items in Projects.

Note

Most endpoints use Authorization: Bearer <YOUR-TOKEN> and Accept: application/vnd.github+json headers, plus X-GitHub-Api-Version: 2026-03-10. Curl examples below omit these standard headers for brevity.

Create draft item for organization owned project

POST /orgs/{org}/projectsV2/{project_number}/drafts

Create draft issue item for the specified organization owned project.

Parameters

Headers

accept (string)
Setting to application/vnd.github+json is recommended.

Path and query parameters

org (string) (required)
The organization name. The name is not case sensitive.
project_number (integer) (required)
The project's number.

Body parameters

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.

HTTP response status codes

201 - Created
304 - Not modified
401 - Requires authentication
403 - Forbidden

Code examples

Example with Sample Draft Issue Title

Request:

curl -L \
  -X POST \
  https://api.github.com/orgs/ORG/projectsV2/PROJECT_NUMBER/drafts \
  -d '{
  "title": "Sample Draft Issue Title"
}'

Response schema (Status: 201):

id: required, number
node_id: string
content: one of:
- Issue
  - id: required, integer, format: int64
  - node_id: required, string
  - url: required, string, format: uri
  - repository_url: required, string, format: uri
  - labels_url: required, string
  - comments_url: required, string, format: uri
  - events_url: required, string, format: uri
  - html_url: required, string, format: uri
  - number: required, integer
  - state: required, string
  - state_reason: string or null, enum: completed, reopened, not_planned, duplicate, null
  - title: required, string
  - body: string or null
  - user: required, any of:
    - null
    - Simple User
      - name: string or null
      - email: string or null
      - login: required, string
      - id: required, integer, format: int64
      - node_id: required, string
      - avatar_url: required, string, format: uri
      - gravatar_id: required, string or null
      - url: required, string, format: uri
      - html_url: required, string, format: uri
      - followers_url: required, string, format: uri
      - following_url: required, string
      - gists_url: required, string
      - starred_url: required, string
      - subscriptions_url: required, string, format: uri
      - organizations_url: required, string, format: uri
      - repos_url: required, string, format: uri
      - events_url: required, string
      - received_events_url: required, string, format: uri
      - type: required, string
      - site_admin: required, boolean
      - starred_at: string
      - user_view_type: string
  - labels: required, array of items:
    - one of:
      - string
      - object
        
        id: integer, format: int64
        
        node_id: string
        
        url: string, format: uri
        
        name: string
        
        description: string or null
        
        color: string or null
        
        default: boolean
        
        archived_by: all of:
        
        Simple User (see above)
  - assignees: array of Simple User (see above)
  - milestone: required, any of:
    - null
    - Milestone
      - url: required, string, format: uri
      - html_url: required, string, format: uri
      - labels_url: required, string, format: uri
      - id: required, integer
      - node_id: required, string
      - number: required, integer
      - state: required, string, enum: open, closed, default: "open"
      - title: required, string
      - description: required, string or null
      - creator: required, any of:
        
        null
        
        Simple User (see above)
      - open_issues: required, integer
      - closed_issues: required, integer
      - created_at: required, string, format: date-time
      - updated_at: required, string, format: date-time
      - closed_at: required, string or null, format: date-time
      - due_on: required, string or null, format: date-time
  - locked: required, boolean
  - active_lock_reason: string or null
  - comments: required, integer
  - pull_request: object:
    - merged_at: string or null, format: date-time
    - diff_url: required, string or null, format: uri
    - html_url: required, string or null, format: uri
    - patch_url: required, string or null, format: uri
    - url: required, string or null, format: uri
  - closed_at: required, string or null, format: date-time
  - created_at: required, string, format: date-time
  - updated_at: required, string, format: date-time
  - draft: boolean
  - closed_by: any of:
    - null
    - Simple User (see above)
  - body_html: string
  - body_text: string
  - timeline_url: string, format: uri
  - type: Issue Type:
    - id: required, integer
    - node_id: required, string
    - name: required, string
    - description: required, string or null
    - color: string or null, enum: gray, blue, green, yellow, orange, red, pink, purple, null
    - created_at: string, format: date-time
    - updated_at: string, format: date-time
    - is_enabled: boolean
  - repository: Repository:
    - id: required, integer, format: int64
    - node_id: required, string
    - name: required, string
    - full_name: required, string
    - license: required, any of:
      - null
      - License Simple
        
        key: required, string
        
        name: required, string
        
        url: required, string or null, format: uri
        
        spdx_id: required, string or null
        
        node_id: required, string
        
        html_url: string, format: uri
    - forks: required, integer
    - permissions: object:
      - admin: required, boolean
      - pull: required, boolean
      - triage: boolean
      - push: required, boolean
      - maintain: boolean
    - owner: required, Simple User (see above)
    - private: required, boolean, default: false
    - html_url: required, string, format: uri
    - description: required, string or null
    - fork: required, boolean
    - url: required, string, format: uri
    - archive_url: required, string
    - assignees_url: required, string
    - blobs_url: required, string
    - branches_url: required, string
    - collaborators_url: required, string
    - comments_url: required, string
    - commits_url: required, string
    - compare_url: required, string
    - contents_url: required, string
    - contributors_url: required, string, format: uri
    - deployments_url: required, string, format: uri
    - downloads_url: required, string, format: uri
    - events_url: required, string, format: uri
    - forks_url: required, string, format: uri
    - git_commits_url: required, string
    - git_refs_url: required, string
    - git_tags_url: required, string
    - git_url: required, string
    - issue_comment_url: required, string
    - issue_events_url: required, string
    - issues_url: required, string
    - keys_url: required, string
    - labels_url: required, string
    - languages_url: required, string, format: uri
    - merges_url: required, string, format: uri
    - milestones_url: required, string
    - notifications_url: required, string
    - pulls_url: required, string
    - releases_url: required, string
    - ssh_url: required, string
    - stargazers_url: required, string, format: uri
    - statuses_url: required, string
    - subscribers_url: required, string, format: uri
    - subscription_url: required, string, format: uri
    - tags_url: required, string, format: uri
    - teams_url: required, string, format: uri
    - trees_url: required, string
    - clone_url: required, string
    - mirror_url: required, string or null, format: uri
    - hooks_url: required, string, format: uri
    - svn_url: required, string, format: uri
    - homepage: required, string or null, format: uri
    - language: required, string or null
    - forks_count: required, integer
    - stargazers_count: required, integer
    - watchers_count: required, integer
    - size: required, integer
    - default_branch: required, string
    - open_issues_count: required, integer
    - is_template: boolean, default: false
    - topics: array of string
    - has_issues: required, boolean, default: true
    - has_projects: required, boolean, default: true
    - has_wiki: required, boolean, default: true
    - has_pages: required, boolean
    - has_discussions: boolean, default: false
    - has_pull_requests: boolean, default: true
    - pull_request_creation_policy: string, enum: all, collaborators_only
    - archived: required, boolean, default: false
    - disabled: required, boolean
    - visibility: string, default: "public"
    - pushed_at: required, string or null, format: date-time
    - created_at: required, string or null, format: date-time
    - updated_at: required, string or null, format: date-time
    - allow_rebase_merge: boolean, default: true
    - temp_clone_token: string
    - allow_squash_merge: boolean, default: true
    - allow_auto_merge: boolean, default: false
    - delete_branch_on_merge: boolean, default: false
    - allow_update_branch: boolean, default: false
    - squash_merge_commit_title: string, enum: PR_TITLE, COMMIT_OR_PR_TITLE
    - squash_merge_commit_message: string, enum: PR_BODY, COMMIT_MESSAGES, BLANK
    - merge_commit_title: string, enum: PR_TITLE, MERGE_MESSAGE
    - merge_commit_message: string, enum: PR_BODY, PR_TITLE, BLANK
    - allow_merge_commit: boolean, default: true
    - allow_forking: boolean
    - web_commit_signoff_required: boolean, default: false
    - open_issues: required, integer
    - watchers: required, integer
    - starred_at: string
    - anonymous_access_enabled: boolean
    - code_search_index_status: object:
      - lexical_search_ok: boolean
      - lexical_commit_sha: string
  - performed_via_github_app: any of:
    - null
    - GitHub app
      - id: required, integer
      - slug: string
      - node_id: required, string
      - client_id: string
      - owner: required, one of:
        
        Simple User (see above)
        
        Enterprise
        
        description: string or null
        
        html_url: required, string, format: uri
        
        website_url: string or null, format: uri
        
        id: required, integer
        
        node_id: required, string
        
        name: required, string
        
        slug: required, string
        
        created_at: required, string or null, format: date-time
        
        updated_at: required, string or null, format: date-time
        
        avatar_url: required, string, format: uri
      - name: required, string
      - description: required, string or null
      - external_url: required, string, format: uri
      - html_url: required, string, format: uri
      - created_at: required, string, format: date-time
      - updated_at: required, string, format: date-time
      - permissions: required, object, additional properties: string:
        
        issues: string
        
        checks: string
        
        metadata: string
        
        contents: string
        
        deployments: string
      - events: required, array of string
      - installations_count: integer
  - author_association: string, enum: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNER
  - reactions: Reaction Rollup:
    - url: required, string, format: uri
    - total_count: required, integer
    - +1: required, integer
    - -1: required, integer
    - laugh: required, integer
    - confused: required, integer
    - heart: required, integer
    - hooray: required, integer
    - eyes: required, integer
    - rocket: required, integer
  - sub_issues_summary: Sub-issues Summary:
    - total: required, integer
    - completed: required, integer
    - percent_completed: required, integer
  - parent_issue_url: string or null, format: uri
  - pinned_comment: any of:
    - null
    - Issue Comment
      - id: required, integer, format: int64
      - node_id: required, string
      - url: required, string, format: uri
      - body: string
      - body_text: string
      - body_html: string
      - html_url: required, string, format: uri
      - user: required, any of:
        
        null
        
        Simple User (see above)
      - created_at: required, string, format: date-time
      - updated_at: required, string, format: date-time
      - issue_url: required, string, format: uri
      - author_association: string, enum: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNER
      - performed_via_github_app: any of:
        
        null
        
        GitHub app (see above)
      - reactions: Reaction Rollup (see above)
      - pin: any of:
        
        null
        
        Pinned Issue Comment
        
        pinned_at: required, string, format: date-time
        
        pinned_by: required, any of:
        
        null
        
        Simple User (see above)
      - minimized: any of:
        
        null
        
        Minimized Issue Comment
        
        reason: required, string or null
  - issue_dependencies_summary: Issue Dependencies Summary:
    - blocked_by: required, integer
    - blocking: required, integer
    - total_blocked_by: required, integer
    - total_blocking: required, integer
  - issue_field_values: array of Issue Field Value:
    - issue_field_id: required, integer, format: int64
    - issue_field_name: string
    - node_id: required, string
    - data_type: required, string, enum: text, single_select, multi_select, number, date
    - value: required, any of:
      - string
      - number
      - integer
    - single_select_option: object or null:
      - id: required, integer, format: int64
      - name: required, string
      - color: required, string
    - multi_select_options: array of objects or null:
      - id: required, integer, format: int64
      - name: required, string
      - color: required, string
- Pull Request Simple
  - url: required, string, format: uri
  - id: required, integer, format: int64
  - node_id: required, string
  - html_url: required, string, format: uri
  - diff_url: required, string, format: uri
  - patch_url: required, string, format: uri
  - issue_url: required, string, format: uri
  - commits_url: required, string, format: uri
  - review_comments_url: required, string, format: uri
  - review_comment_url: required, string
  - comments_url: required, string, format: uri
  - statuses_url: required, string, format: uri
  - number: required, integer
  - state: required, string
  - locked: required, boolean
  - title: required, string
  - user: required, any of:
    - null
    - Simple User (see above)
  - body: required, string or null
  - labels: required, array of objects:
    - id: required, integer, format: int64
    - node_id: required, string
    - url: required, string
    - name: required, string
    - description: required, string
    - color: required, string
    - default: required, boolean
    - archived_by: required, all of:
      - Simple User (see above)
  - milestone: required, any of:
    - null
    - Milestone (see above)
  - active_lock_reason: string or null
  - created_at: required, string, format: date-time
  - updated_at: required, string, format: date-time
  - closed_at: required, string or null, format: date-time
  - merged_at: required, string or null, format: date-time
  - assignees: array of Simple User (see above)
  - requested_reviewers: array of Simple User (see above)
  - requested_teams: array of Team:
    - id: required, integer
    - node_id: required, string
    - name: required, string
    - slug: required, string
    - description: required, string or null
    - privacy: string
    - notification_setting: string
    - permission: required, string
    - permissions: object:
      - pull: required, boolean
      - triage: required, boolean
      - push: required, boolean
      - maintain: required, boolean
      - admin: required, boolean
    - url: required, string, format: uri
    - html_url: required, string, format: uri
    - members_url: required, string
    - repositories_url: required, string, format: uri
    - type: required, string, enum: enterprise, organization
    - access_source: string, enum: direct, organization, enterprise
    - organization_id: integer
    - enterprise_id: integer
    - parent: required, any of:
      - null
      - Team Simple
        
        id: required, integer
        
        node_id: required, string
        
        url: required, string, format: uri
        
        members_url: required, string
        
        name: required, string
        
        description: required, string or null
        
        permission: required, string
        
        privacy: string
        
        notification_setting: string
        
        html_url: required, string, format: uri
        
        repositories_url: required, string, format: uri
        
        slug: required, string
        
        ldap_dn: string
        
        type: required, string, enum: enterprise, organization
        
        organization_id: integer
        
        enterprise_id: integer
  - head: required, object:
    - label: required, string
    - ref: required, string
    - repo: required, Repository (see above)
    - sha: required, string
    - user: required, any of:
      - null
      - Simple User (see above)
  - base: required, object:
    - label: required, string
    - ref: required, string
    - repo: required, Repository (see above)
    - sha: required, string
    - user: required, any of:
      - null
      - Simple User (see above)
  - _links: required, object:
    - comments: required, Link:
      - href: required, string
    - commits: required, Link (see above)
    - statuses: required, Link (see above)
    - html: required, Link (see above)
    - issue: required, Link (see above)
    - review_comments: required, Link (see above)
    - review_comment: required, Link (see above)
    - self: required, Link (see above)
  - author_association: required, string, enum: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNER
  - auto_merge: required, Auto merge:
    - enabled_by: required, Simple User (see above)
    - merge_method: required, string, enum: merge, squash, rebase
    - commit_title: required, string
    - commit_message: required, string
  - stack: Pull Request Stack:
    - base: required, object:
      - ref: required, string
      - sha: required, string
    - size: integer
    - position: integer
    - id: integer
    - number: integer
  - draft: boolean
- Draft Issue
  - id: required, number
  - node_id: required, string
  - title: required, string
  - body: string or null
  - user: required, any of:
    - null
    - Simple User (see above)
  - created_at: required, string, format: date-time
  - updated_at: required, string, format: date-time
content_type: required, string, enum: Issue, PullRequest, DraftIssue
creator: Simple User (see above)
created_at: required, string, format: date-time
updated_at: required, string, format: date-time
archived_at: required, string or null, format: date-time
project_url: string, format: uri
item_url: string, format: uri

Example with Sample Draft Issue Title and Body

Request:

curl -L \
  -X POST \
  https://api.github.com/orgs/ORG/projectsV2/PROJECT_NUMBER/drafts \
  -d '{
  "title": "Sample Draft Issue Title",
  "body": "This is the body content of the draft issue."
}'

Response schema (Status: 201):

id: required, number
node_id: string
content: one of:
- Issue
  - id: required, integer, format: int64
  - node_id: required, string
  - url: required, string, format: uri
  - repository_url: required, string, format: uri
  - labels_url: required, string
  - comments_url: required, string, format: uri
  - events_url: required, string, format: uri
  - html_url: required, string, format: uri
  - number: required, integer
  - state: required, string
  - state_reason: string or null, enum: completed, reopened, not_planned, duplicate, null
  - title: required, string
  - body: string or null
  - user: required, any of:
    - null
    - Simple User
      - name: string or null
      - email: string or null
      - login: required, string
      - id: required, integer, format: int64
      - node_id: required, string
      - avatar_url: required, string, format: uri
      - gravatar_id: required, string or null
      - url: required, string, format: uri
      - html_url: required, string, format: uri
      - followers_url: required, string, format: uri
      - following_url: required, string
      - gists_url: required, string
      - starred_url: required, string
      - subscriptions_url: required, string, format: uri
      - organizations_url: required, string, format: uri
      - repos_url: required, string, format: uri
      - events_url: required, string
      - received_events_url: required, string, format: uri
      - type: required, string
      - site_admin: required, boolean
      - starred_at: string
      - user_view_type: string
  - labels: required, array of items:
    - one of:
      - string
      - object
        
        id: integer, format: int64
        
        node_id: string
        
        url: string, format: uri
        
        name: string
        
        description: string or null
        
        color: string or null
        
        default: boolean
        
        archived_by: all of:
        
        Simple User (see above)
  - assignees: array of Simple User (see above)
  - milestone: required, any of:
    - null
    - Milestone
      - url: required, string, format: uri
      - html_url: required, string, format: uri
      - labels_url: required, string, format: uri
      - id: required, integer
      - node_id: required, string
      - number: required, integer
      - state: required, string, enum: open, closed, default: "open"
      - title: required, string
      - description: required, string or null
      - creator: required, any of:
        
        null
        
        Simple User (see above)
      - open_issues: required, integer
      - closed_issues: required, integer
      - created_at: required, string, format: date-time
      - updated_at: required, string, format: date-time
      - closed_at: required, string or null, format: date-time
      - due_on: required, string or null, format: date-time
  - locked: required, boolean
  - active_lock_reason: string or null
  - comments: required, integer
  - pull_request: object:
    - merged_at: string or null, format: date-time
    - diff_url: required, string or null, format: uri
    - html_url: required, string or null, format: uri
    - patch_url: required, string or null, format: uri
    - url: required, string or null, format: uri
  - closed_at: required, string or null, format: date-time
  - created_at: required, string, format: date-time
  - updated_at: required, string, format: date-time
  - draft: boolean
  - closed_by: any of:
    - null
    - Simple User (see above)
  - body_html: string
  - body_text: string
  - timeline_url: string, format: uri
  - type: Issue Type:
    - id: required, integer
    - node_id: required, string
    - name: required, string
    - description: required, string or null
    - color: string or null, enum: gray, blue, green, yellow, orange, red, pink, purple, null
    - created_at: string, format: date-time
    - updated_at: string, format: date-time
    - is_enabled: boolean
  - repository: Repository:
    - id: required, integer, format: int64
    - node_id: required, string
    - name: required, string
    - full_name: required, string
    - license: required, any of:
      - null
      - License Simple
        
        key: required, string
        
        name: required, string
        
        url: required, string or null, format: uri
        
        spdx_id: required, string or null
        
        node_id: required, string
        
        html_url: string, format: uri
    - forks: required, integer
    - permissions: object:
      - admin: required, boolean
      - pull: required, boolean
      - triage: boolean
      - push: required, boolean
      - maintain: boolean
    - owner: required, Simple User (see above)
    - private: required, boolean, default: false
    - html_url: required, string, format: uri
    - description: required, string or null
    - fork: required, boolean
    - url: required, string, format: uri
    - archive_url: required, string
    - assignees_url: required, string
    - blobs_url: required, string
    - branches_url: required, string
    - collaborators_url: required, string
    - comments_url: required, string
    - commits_url: required, string
    - compare_url: required, string
    - contents_url: required, string
    - contributors_url: required, string, format: uri
    - deployments_url: required, string, format: uri
    - downloads_url: required, string, format: uri
    - events_url: required, string, format: uri
    - forks_url: required, string, format: uri
    - git_commits_url: required, string
    - git_refs_url: required, string
    - git_tags_url: required, string
    - git_url: required, string
    - issue_comment_url: required, string
    - issue_events_url: required, string
    - issues_url: required, string
    - keys_url: required, string
    - labels_url: required, string
    - languages_url: required, string, format: uri
    - merges_url: required, string, format: uri
    - milestones_url: required, string
    - notifications_url: required, string
    - pulls_url: required, string
    - releases_url: required, string
    - ssh_url: required, string
    - stargazers_url: required, string, format: uri
    - statuses_url: required, string
    - subscribers_url: required, string, format: uri
    - subscription_url: required, string, format: uri
    - tags_url: required, string, format: uri
    - teams_url: required, string, format: uri
    - trees_url: required, string
    - clone_url: required, string
    - mirror_url: required, string or null, format: uri
    - hooks_url: required, string, format: uri
    - svn_url: required, string, format: uri
    - homepage: required, string or null, format: uri
    - language: required, string or null
    - forks_count: required, integer
    - stargazers_count: required, integer
    - watchers_count: required, integer
    - size: required, integer
    - default_branch: required, string
    - open_issues_count: required, integer
    - is_template: boolean, default: false
    - topics: array of string
    - has_issues: required, boolean, default: true
    - has_projects: required, boolean, default: true
    - has_wiki: required, boolean, default: true
    - has_pages: required, boolean
    - has_discussions: boolean, default: false
    - has_pull_requests: boolean, default: true
    - pull_request_creation_policy: string, enum: all, collaborators_only
    - archived: required, boolean, default: false
    - disabled: required, boolean
    - visibility: string, default: "public"
    - pushed_at: required, string or null, format: date-time
    - created_at: required, string or null, format: date-time
    - updated_at: required, string or null, format: date-time
    - allow_rebase_merge: boolean, default: true
    - temp_clone_token: string
    - allow_squash_merge: boolean, default: true
    - allow_auto_merge: boolean, default: false
    - delete_branch_on_merge: boolean, default: false
    - allow_update_branch: boolean, default: false
    - squash_merge_commit_title: string, enum: PR_TITLE, COMMIT_OR_PR_TITLE
    - squash_merge_commit_message: string, enum: PR_BODY, COMMIT_MESSAGES, BLANK
    - merge_commit_title: string, enum: PR_TITLE, MERGE_MESSAGE
    - merge_commit_message: string, enum: PR_BODY, PR_TITLE, BLANK
    - allow_merge_commit: boolean, default: true
    - allow_forking: boolean
    - web_commit_signoff_required: boolean, default: false
    - open_issues: required, integer
    - watchers: required, integer
    - starred_at: string
    - anonymous_access_enabled: boolean
    - code_search_index_status: object:
      - lexical_search_ok: boolean
      - lexical_commit_sha: string
  - performed_via_github_app: any of:
    - null
    - GitHub app
      - id: required, integer
      - slug: string
      - node_id: required, string
      - client_id: string
      - owner: required, one of:
        
        Simple User (see above)
        
        Enterprise
        
        description: string or null
        
        html_url: required, string, format: uri
        
        website_url: string or null, format: uri
        
        id: required, integer
        
        node_id: required, string
        
        name: required, string
        
        slug: required, string
        
        created_at: required, string or null, format: date-time
        
        updated_at: required, string or null, format: date-time
        
        avatar_url: required, string, format: uri
      - name: required, string
      - description: required, string or null
      - external_url: required, string, format: uri
      - html_url: required, string, format: uri
      - created_at: required, string, format: date-time
      - updated_at: required, string, format: date-time
      - permissions: required, object, additional properties: string:
        
        issues: string
        
        checks: string
        
        metadata: string
        
        contents: string
        
        deployments: string
      - events: required, array of string
      - installations_count: integer
  - author_association: string, enum: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNER
  - reactions: Reaction Rollup:
    - url: required, string, format: uri
    - total_count: required, integer
    - +1: required, integer
    - -1: required, integer
    - laugh: required, integer
    - confused: required, integer
    - heart: required, integer
    - hooray: required, integer
    - eyes: required, integer
    - rocket: required, integer
  - sub_issues_summary: Sub-issues Summary:
    - total: required, integer
    - completed: required, integer
    - percent_completed: required, integer
  - parent_issue_url: string or null, format: uri
  - pinned_comment: any of:
    - null
    - Issue Comment
      - id: required, integer, format: int64
      - node_id: required, string
      - url: required, string, format: uri
      - body: string
      - body_text: string
      - body_html: string
      - html_url: required, string, format: uri
      - user: required, any of:
        
        null
        
        Simple User (see above)
      - created_at: required, string, format: date-time
      - updated_at: required, string, format: date-time
      - issue_url: required, string, format: uri
      - author_association: string, enum: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNER
      - performed_via_github_app: any of:
        
        null
        
        GitHub app (see above)
      - reactions: Reaction Rollup (see above)
      - pin: any of:
        
        null
        
        Pinned Issue Comment
        
        pinned_at: required, string, format: date-time
        
        pinned_by: required, any of:
        
        null
        
        Simple User (see above)
      - minimized: any of:
        
        null
        
        Minimized Issue Comment
        
        reason: required, string or null
  - issue_dependencies_summary: Issue Dependencies Summary:
    - blocked_by: required, integer
    - blocking: required, integer
    - total_blocked_by: required, integer
    - total_blocking: required, integer
  - issue_field_values: array of Issue Field Value:
    - issue_field_id: required, integer, format: int64
    - issue_field_name: string
    - node_id: required, string
    - data_type: required, string, enum: text, single_select, multi_select, number, date
    - value: required, any of:
      - string
      - number
      - integer
    - single_select_option: object or null:
      - id: required, integer, format: int64
      - name: required, string
      - color: required, string
    - multi_select_options: array of objects or null:
      - id: required, integer, format: int64
      - name: required, string
      - color: required, string
- Pull Request Simple
  - url: required, string, format: uri
  - id: required, integer, format: int64
  - node_id: required, string
  - html_url: required, string, format: uri
  - diff_url: required, string, format: uri
  - patch_url: required, string, format: uri
  - issue_url: required, string, format: uri
  - commits_url: required, string, format: uri
  - review_comments_url: required, string, format: uri
  - review_comment_url: required, string
  - comments_url: required, string, format: uri
  - statuses_url: required, string, format: uri
  - number: required, integer
  - state: required, string
  - locked: required, boolean
  - title: required, string
  - user: required, any of:
    - null
    - Simple User (see above)
  - body: required, string or null
  - labels: required, array of objects:
    - id: required, integer, format: int64
    - node_id: required, string
    - url: required, string
    - name: required, string
    - description: required, string
    - color: required, string
    - default: required, boolean
    - archived_by: required, all of:
      - Simple User (see above)
  - milestone: required, any of:
    - null
    - Milestone (see above)
  - active_lock_reason: string or null
  - created_at: required, string, format: date-time
  - updated_at: required, string, format: date-time
  - closed_at: required, string or null, format: date-time
  - merged_at: required, string or null, format: date-time
  - assignees: array of Simple User (see above)
  - requested_reviewers: array of Simple User (see above)
  - requested_teams: array of Team:
    - id: required, integer
    - node_id: required, string
    - name: required, string
    - slug: required, string
    - description: required, string or null
    - privacy: string
    - notification_setting: string
    - permission: required, string
    - permissions: object:
      - pull: required, boolean
      - triage: required, boolean
      - push: required, boolean
      - maintain: required, boolean
      - admin: required, boolean
    - url: required, string, format: uri
    - html_url: required, string, format: uri
    - members_url: required, string
    - repositories_url: required, string, format: uri
    - type: required, string, enum: enterprise, organization
    - access_source: string, enum: direct, organization, enterprise
    - organization_id: integer
    - enterprise_id: integer
    - parent: required, any of:
      - null
      - Team Simple
        
        id: required, integer
        
        node_id: required, string
        
        url: required, string, format: uri
        
        members_url: required, string
        
        name: required, string
        
        description: required, string or null
        
        permission: required, string
        
        privacy: string
        
        notification_setting: string
        
        html_url: required, string, format: uri
        
        repositories_url: required, string, format: uri
        
        slug: required, string
        
        ldap_dn: string
        
        type: required, string, enum: enterprise, organization
        
        organization_id: integer
        
        enterprise_id: integer
  - head: required, object:
    - label: required, string
    - ref: required, string
    - repo: required, Repository (see above)
    - sha: required, string
    - user: required, any of:
      - null
      - Simple User (see above)
  - base: required, object:
    - label: required, string
    - ref: required, string
    - repo: required, Repository (see above)
    - sha: required, string
    - user: required, any of:
      - null
      - Simple User (see above)
  - _links: required, object:
    - comments: required, Link:
      - href: required, string
    - commits: required, Link (see above)
    - statuses: required, Link (see above)
    - html: required, Link (see above)
    - issue: required, Link (see above)
    - review_comments: required, Link (see above)
    - review_comment: required, Link (see above)
    - self: required, Link (see above)
  - author_association: required, string, enum: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNER
  - auto_merge: required, Auto merge:
    - enabled_by: required, Simple User (see above)
    - merge_method: required, string, enum: merge, squash, rebase
    - commit_title: required, string
    - commit_message: required, string
  - stack: Pull Request Stack:
    - base: required, object:
      - ref: required, string
      - sha: required, string
    - size: integer
    - position: integer
    - id: integer
    - number: integer
  - draft: boolean
- Draft Issue
  - id: required, number
  - node_id: required, string
  - title: required, string
  - body: string or null
  - user: required, any of:
    - null
    - Simple User (see above)
  - created_at: required, string, format: date-time
  - updated_at: required, string, format: date-time
content_type: required, string, enum: Issue, PullRequest, DraftIssue
creator: Simple User (see above)
created_at: required, string, format: date-time
updated_at: required, string, format: date-time
archived_at: required, string or null, format: date-time
project_url: string, format: uri
item_url: string, format: uri

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.

Parameters

Headers

accept (string)
Setting to application/vnd.github+json is recommended.

Path and query parameters

user_id (string) (required)
The unique identifier of the user.
project_number (integer) (required)
The project's number.

Body parameters

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.

HTTP response status codes

201 - Created
304 - Not modified
401 - Requires authentication
403 - Forbidden

Code examples

Example with Sample Draft Issue Title

Request:

curl -L \
  -X POST \
  https://api.github.com/user/USER_ID/projectsV2/PROJECT_NUMBER/drafts \
  -d '{
  "title": "Sample Draft Issue Title"
}'

Response schema (Status: 201):

Same response schema as Create draft item for organization owned project.

Example with Sample Draft Issue Title and Body

Request:

curl -L \
  -X POST \
  https://api.github.com/user/USER_ID/projectsV2/PROJECT_NUMBER/drafts \
  -d '{
  "title": "Sample Draft Issue Title",
  "body": "This is the body content of the draft issue."
}'

Response schema (Status: 201):

Same response schema as Create draft item for organization owned project.