GitHub Column API
The Column API from GitHub — 1 operation(s) for column.
The Column API from GitHub — 1 operation(s) for column.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/github:github-column-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
version: 1.1.4
title: GitHub Projects Column API
description: The GitHub Projects API enables developers to programmatically create and manage GitHub Projects, which are flexible tools for planning and tracking work using customizable boards, tables, and roadmaps. Through these REST API endpoints, you can create projects at the repository, organization, or user level, add and organize items like issues and pull requests, manage project fields and views, update item statuses and metadata, and automate project workflows. This API is particularly useful for integrating project management functionality into custom applications, automating project updates based on repository events, building dashboards and reporting tools, or synchronizing GitHub project data with external project management systems.
license:
name: MIT
url: https://spdx.org/licenses/MIT
termsOfService: https://docs.github.com/articles/github-terms-of-service
contact:
name: Support
url: https://support.github.com/contact?tags=dotcom-rest-api
x-github-plan: ghes
x-github-release: 3.9
servers:
- url: '{protocol}://{hostname}/api/v3'
variables:
hostname:
description: Self-hosted Enterprise Server hostname
default: HOSTNAME
protocol:
description: Self-hosted Enterprise Server protocol
default: http
tags:
- name: Column
paths:
/projects/columns/{column_id}:
get:
summary: GitHub Get Project Column
description: The Get Project Column endpoint retrieves detailed information about a specific project column in GitHub Projects by providing its unique column identifier. This GET operation at /projects/columns/{column_id} returns metadata about the column including its name, position within the project board, creation and update timestamps, and other configuration details. It requires the column_id path parameter to identify which column to fetch and is useful for applications that need to display or work with individual column data from a GitHub project board. The endpoint requires appropriate authentication and permissions to access the project column information.
tags:
- Column
operationId: getProjectColumn
externalDocs:
description: API method documentation
url: https://docs.github.com/enterprise-server@3.9/rest/projects/columns#get-a-project-column
parameters:
- $ref: '#/components/parameters/column-id'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/project-column'
examples:
default:
$ref: '#/components/examples/project-column'
'304':
$ref: '#/components/responses/not_modified'
'401':
$ref: '#/components/responses/requires_authentication'
'403':
$ref: '#/components/responses/forbidden'
'404':
$ref: '#/components/responses/not_found'
x-github:
githubCloudOnly: false
enabledForGitHubApps: true
category: projects
subcategory: columns
security:
- bearerHttpAuthentication: []
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
patch:
summary: GitHub Update an Existing Project Column
description: The PATCH operation on the /projects/columns/{column_id} endpoint allows developers to modify the properties of an existing project column within GitHub Projects. By sending a PATCH request with the column's unique identifier, users can update attributes such as the column's name. This endpoint is particularly useful for reorganizing project boards, renaming workflow stages, or adjusting column configurations without needing to delete and recreate columns. The operation requires appropriate authentication and permissions to modify the project column, and it returns the updated column object upon successful execution, maintaining the column's position and associated cards while applying the requested changes.
tags:
- Column
operationId: updateAnExistingProjectColumn
externalDocs:
description: API method documentation
url: https://docs.github.com/enterprise-server@3.9/rest/projects/columns#update-an-existing-project-column
parameters:
- $ref: '#/components/parameters/column-id'
requestBody:
required: true
content:
application/json:
schema:
properties:
name:
description: Name of the project column
example: Remaining tasks
type: string
required:
- name
type: object
examples:
default:
summary: Rename the project column
value:
name: To Do
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/project-column'
examples:
default:
$ref: '#/components/examples/project-column'
'304':
$ref: '#/components/responses/not_modified'
'401':
$ref: '#/components/responses/requires_authentication'
'403':
$ref: '#/components/responses/forbidden'
x-github:
githubCloudOnly: false
enabledForGitHubApps: true
category: projects
subcategory: columns
security:
- bearerHttpAuthentication: []
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
delete:
summary: GitHub Delete Project Column
description: The Delete Project Column operation removes a specific column from a GitHub project board by making a DELETE request to the /projects/columns/{column_id} endpoint. This API call permanently deletes the specified column identified by its unique column_id parameter, along with all the cards contained within that column. The operation requires appropriate authentication and permissions to modify the project, typically needing write access to the repository or organization that owns the project. Once executed successfully, the column and its contents are irreversibly removed from the project board, so users should exercise caution when performing this operation to avoid accidental data loss.
tags:
- Column
operationId: deleteProjectColumn
externalDocs:
description: API method documentation
url: https://docs.github.com/enterprise-server@3.9/rest/projects/columns#delete-a-project-column
parameters:
- $ref: '#/components/parameters/column-id'
responses:
'204':
description: Response
'304':
$ref: '#/components/responses/not_modified'
'401':
$ref: '#/components/responses/requires_authentication'
'403':
$ref: '#/components/responses/forbidden'
x-github:
githubCloudOnly: false
enabledForGitHubApps: true
category: projects
subcategory: columns
security:
- bearerHttpAuthentication: []
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
components:
schemas:
project-column:
title: Project Column
description: Project columns contain cards of work.
type: object
properties:
url:
type: string
format: uri
example: https://api.github.com/projects/columns/367
project_url:
type: string
format: uri
example: https://api.github.com/projects/120
cards_url:
type: string
format: uri
example: https://api.github.com/projects/columns/367/cards
id:
description: The unique identifier of the project column
example: 42
type: integer
node_id:
type: string
example: MDEzOlByb2plY3RDb2x1bW4zNjc=
name:
description: Name of the project column
example: Remaining tasks
type: string
created_at:
type: string
format: date-time
example: '2016-09-05T14:18:44Z'
updated_at:
type: string
format: date-time
example: '2016-09-05T14:22:28Z'
required:
- id
- node_id
- url
- project_url
- cards_url
- name
- created_at
- updated_at
basic-error:
title: Basic Error
description: Basic Error
type: object
properties:
message:
type: string
example: Example body text
documentation_url:
type: string
example: https://api.github.com/repos/octocat/Hello-World
url:
type: string
example: https://api.github.com/repos/octocat/Hello-World
status:
type: string
example: open
responses:
not_modified:
description: Not modified
requires_authentication:
description: Requires authentication
content:
application/json:
schema:
$ref: '#/components/schemas/basic-error'
not_found:
description: Resource not found
content:
application/json:
schema:
$ref: '#/components/schemas/basic-error'
forbidden:
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/basic-error'
parameters:
column-id:
name: column_id
description: The unique identifier of the column.
in: path
required: true
schema:
type: integer
examples:
project-column:
value:
url: https://api.github.com/projects/columns/367
project_url: https://api.github.com/projects/120
cards_url: https://api.github.com/projects/columns/367/cards
id: 367
node_id: MDEzOlByb2plY3RDb2x1bW4zNjc=
name: To Do
created_at: '2016-09-05T14:18:44Z'
updated_at: '2016-09-05T14:22:28Z'
securitySchemes:
bearerHttpAuthentication:
description: Bearer Token
type: http
scheme: Bearer
externalDocs:
description: GitHub Enterprise Developer Docs
url: https://docs.github.com/enterprise-server@3.9/rest/