Project columns

The Projects API is currently available for developers to preview. During the preview period, the API may change without advance notice. Please see the blog post for full details.

To access the API during the preview period, you must provide a custom media type in the Accept header:

  application/vnd.github.inertia-preview+json

List project columns

GET /projects/:project_id/columns

Response

Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"
[
  {
    "id": 367,
    "name": "To Do",
    "project_url": "https://api.github.com/projects/120",
    "created_at": "2016-09-05T14:18:44Z",
    "updated_at": "2016-09-05T14:22:28Z"
  }
]

Get a project column

GET /projects/columns/:id
Status: 200 OK
{
  "id": 367,
  "name": "To Do",
  "project_url": "https://api.github.com/projects/120",
  "created_at": "2016-09-05T14:18:44Z",
  "updated_at": "2016-09-05T14:22:28Z"
}

Create a project column

POST /projects/:project_id/columns

Parameters

Name Type Description
name string Required. The name of the column.
Status: 200 OK
{
  "id": 367,
  "name": "To Do",
  "project_url": "https://api.github.com/projects/120",
  "created_at": "2016-09-05T14:18:44Z",
  "updated_at": "2016-09-05T14:22:28Z"
}

Update a project column

PATCH /projects/columns/:id

Parameters

Name Type Description
name string Required. The new name of the column.
Status: 200 OK
{
  "id": 367,
  "name": "To Do",
  "project_url": "https://api.github.com/projects/120",
  "created_at": "2016-09-05T14:18:44Z",
  "updated_at": "2016-09-05T14:22:28Z"
}

Delete a project column

DELETE /projects/columns/:id

Response

Status: 204 No Content

Move a project column

POST /projects/columns/:id/moves

Parameters

Name Type Description
position string Required. Can be one of first, last, or after:<column-id>, where <column-id> is the id value of a column in the same project.

Example

{
  "position": "after:3"
}

Response

Status: 201 Created