---
title: "Add pull requests to a pull request stack"
method: POST
path: "/repos/{owner}/{repo}/stacks/{stack_number}/add"
tags: ["pulls"]
---

# Add pull requests to a pull request stack

`POST /repos/{owner}/{repo}/stacks/{stack_number}/add`

Appends an ordered list of pull request numbers onto the top of an existing
stack. Provide only the pull requests you want to add, from the current top of
the stack upward. The first new pull request's base ref must match the current
top pull request's head ref.

## Path parameters

- `owner` string, required
- `repo` string, required
- `stack_number` integer, required

## Request body

- object
  - `pull_requests` integer[], required — An ordered list of pull request numbers to append to the stack, from the current top upward.

## Response `200`

Response

- object
  - `id` integer, required
  - `number` integer, required
  - `node_id` string, required
  - `url` string, uri, required
  - `base` object, required
    - `ref` string, required
  - `open` boolean, required — Whether the stack has any open pull request. False when all pull requests are merged or closed.
  - `created_at` string, date-time, required
  - `pull_requests` PullRequestStackPullRequest[], required
    - `id` integer, required
    - `number` integer, required
    - `url` string, required
    - `head` object, required
      - `ref` string, required
      - `sha` string, required
      - `repo` object, required
        - `id` integer, required
        - `url` string, required
        - `name` string, required
    - `base` object, required
      - `ref` string, required
      - `sha` string, required
      - `repo` object, required
        - `id` integer, required
        - `url` string, required
        - `name` string, required
    - `node_id` string, required
    - `title` string, required
    - `state` 'open' | 'closed', required
    - `merged_at` string, date-time, nullable, required
    - `draft` boolean, required
    - `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

## Other responses

- `404` — Resource not found
- `409` — Conflict. Returned when the stack is being modified by another request.
- `422` — Validation failed. Returned when the request references pull requests that don't exist in the repository, or when the pull requests can't be appended to the stack.

---

[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)