> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usequeue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Column



## OpenAPI

````yaml POST /projects/{project_id}/columns
openapi: 3.0.0
info:
  title: Queue REST API
  description: >-
    # 🚀 Get started here


    This template guides you through CRUD operations (GET, POST, PUT, DELETE),
    variables, and tests.


    ## 🔖 **How to use this template**


    #### **Step 1: Send requests**


    RESTful APIs allow you to perform CRUD operations using the POST, GET, PUT,
    and DELETE HTTP methods.


    This collection contains each of these
    [request](https://learning.postman.com/docs/sending-requests/requests/)
    types. Open each request and click "Send" to see what happens.


    #### **Step 2: View responses**


    Observe the response tab for status code (200 OK), response time, and size.


    #### **Step 3: Send new Body data**


    Update or add new data in "Body" in the POST request. Typically, Body data
    is also used in PUT request.


    ```

    {
        "name": "Add your name in the body"
    }

     ```

    #### **Step 4: Update the variable**


    Variables enable you to store and reuse values in Postman. We have created a
    [variable](https://learning.postman.com/docs/sending-requests/variables/)
    called `base_url` with the sample request
    [https://postman-api-learner.glitch.me](https://postman-api-learner.glitch.me).
    Replace it with your API endpoint to customize this collection.


    #### **Step 5: Add tests in the "Scripts" tab**


    Adding tests to your requests can help you confirm that your API is working
    as expected. You can write test scripts in JavaScript and view the output in
    the "Test Results" tab.


    <img
    src="https://content.pstmn.io/fa30ea0a-373d-4545-a668-e7b283cca343/aW1hZ2UucG5n"
    alt="" height="1530" width="2162">


    ## 💪 Pro tips


    - Use folders to group related requests and organize the collection.
        
    - Add more
    [scripts](https://learning.postman.com/docs/writing-scripts/intro-to-scripts/)
    to verify if the API works as expected and execute workflows.
        

    ## 💡Related templates


    [API testing
    basics](https://go.postman.co/redirect/workspace?type=personal&collectionTemplateId=e9a37a28-055b-49cd-8c7e-97494a21eb54&sourceTemplateId=ddb19591-3097-41cf-82af-c84273e56719)  

    [API
    documentation](https://go.postman.co/redirect/workspace?type=personal&collectionTemplateId=e9c28f47-1253-44af-a2f3-20dce4da1f18&sourceTemplateId=ddb19591-3097-41cf-82af-c84273e56719)  

    [Authorization
    methods](https://go.postman.co/redirect/workspace?type=personal&collectionTemplateId=31a9a6ed-4cdf-4ced-984c-d12c9aec1c27&sourceTemplateId=ddb19591-3097-41cf-82af-c84273e56719)
  version: 1.0.0
servers:
  - url: https://app.usequeue.com/api/v1
security: []
tags:
  - name: Projects
  - name: Tasks
  - name: Columns
  - name: Task Comments
  - name: Invoices
  - name: Task Credits
paths:
  /projects/{project_id}/columns:
    post:
      tags:
        - Tasks
      summary: Create task
      parameters:
        - $ref: '#/components/parameters/Column.Title'
        - $ref: '#/components/parameters/Column.Position'
        - $ref: '#/components/parameters/Column.Stage'
        - $ref: '#/components/parameters/Column.Finished'
        - $ref: '#/components/parameters/Column.StartTimer'
      requestBody:
        content: {}
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  column:
                    $ref: '#/components/schemas/Column'
                    type: object
      security:
        - bearerAuth: []
components:
  parameters:
    Column.Title:
      name: title
      in: query
      description: The title of the column
      required: false
      schema:
        type: string
      example: Backlog
    Column.Position:
      name: position
      in: query
      description: The column's position (0-indexed) within the project
      required: false
      schema:
        type: integer
      example: 1
    Column.Stage:
      name: stage
      in: query
      description: >-
        The internal stage type of the column. Can be 'in_queue', 'in_progress',
        or 'done'
      required: false
      schema:
        type: string
        enum:
          - in_queue
          - in_progress
          - done
      example: in_queue
    Column.Finished:
      name: finished
      in: query
      description: Whether tasks in this column are marked as finished
      required: false
      schema:
        type: boolean
      example: false
    Column.StartTimer:
      name: start_timer
      in: query
      description: Whether tasks in this column should start the timer automatically
      required: false
      schema:
        type: boolean
      example: true
  schemas:
    Column:
      type: object
      properties:
        id:
          type: string
          example: a1b2c3d4
        title:
          type: string
          example: In Progress
        position:
          type: integer
          example: 2
        stage:
          type: string
          example: in_queue
        finished:
          type: boolean
          example: false
        start_timer:
          type: boolean
          example: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````