Create a project in a workspace

POST

/workspaces/{workspace_gid}/projects

Returns the compact project records for all projects in the workspace.

If the workspace for your project is an organization, you must also
supply a team to share the project with.

Returns the full record of the newly created project.

Request

Path Params

Body Params application/json

Examples

Responses

🟢201Successfully created a new project in the specified workspace.

application/json

Body

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://app.asana.com/api/1.0/workspaces//projects' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "name": "Stuff to buy",
        "archived": false,
        "color": "light-green",
        "current_status": {
            "title": "Status Update - Jun 15",
            "color": "green",
            "html_text": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
            "text": "The project is moving forward according to plan...",
            "author": {
                "name": "Greg Sanchez"
            },
            "created_by": {
                "name": "Greg Sanchez"
            }
        },
        "default_view": "calendar",
        "due_date": "2019-09-15",
        "due_on": "2019-09-15",
        "html_notes": "<body>These are things we need to purchase.</body>",
        "is_template": false,
        "notes": "These are things we need to purchase.",
        "public": false,
        "start_on": "2019-09-14",
        "custom_fields": {
            "4578152156": "Not Started",
            "5678904321": "On Hold"
        },
        "followers": "12345,23456",
        "owner": "12345",
        "team": "12345"
    }
}'

Response Example

201 - Example 1

{
    "data": {
        "gid": "12345",
        "resource_type": "task",
        "name": "Stuff to buy",
        "archived": false,
        "color": "light-green",
        "created_at": "2012-02-22T02:06:58.147Z",
        "current_status": {
            "gid": "12345",
            "resource_type": "task",
            "title": "Status Update - Jun 15",
            "color": "green",
            "html_text": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
            "text": "The project is moving forward according to plan...",
            "author": {
                "gid": "12345",
                "resource_type": "task",
                "name": "Greg Sanchez"
            },
            "created_at": "2012-02-22T02:06:58.147Z",
            "created_by": {
                "gid": "12345",
                "resource_type": "task",
                "name": "Greg Sanchez"
            },
            "modified_at": "2012-02-22T02:06:58.147Z"
        },
        "custom_field_settings": [
            {
                "gid": "12345",
                "resource_type": "task"
            }
        ],
        "default_view": "calendar",
        "due_date": "2019-09-15",
        "due_on": "2019-09-15",
        "html_notes": "<body>These are things we need to purchase.</body>",
        "is_template": false,
        "members": [
            {
                "gid": "12345",
                "resource_type": "task",
                "name": "Greg Sanchez"
            }
        ],
        "modified_at": "2012-02-22T02:06:58.147Z",
        "notes": "These are things we need to purchase.",
        "public": false,
        "start_on": "2019-09-14",
        "workspace": {
            "gid": "12345",
            "resource_type": "task",
            "name": "My Company Workspace"
        },
        "custom_fields": [
            {
                "gid": "12345",
                "resource_type": "task",
                "display_value": "blue",
                "enabled": true,
                "enum_options": [
                    {
                        "gid": "12345",
                        "resource_type": "task",
                        "color": "blue",
                        "enabled": true,
                        "name": "Low"
                    }
                ],
                "name": "Status",
                "number_value": 5.2,
                "resource_subtype": "text",
                "text_value": "Some Value",
                "type": "text"
            }
        ],
        "followers": [
            {
                "gid": "12345",
                "resource_type": "task",
                "name": "Greg Sanchez"
            }
        ],
        "icon": "chat_bubbles",
        "owner": {
            "gid": "12345",
            "resource_type": "task",
            "name": "Greg Sanchez"
        },
        "permalink_url": "https://app.asana.com/0/resource/123456789/list",
        "team": {
            "gid": "12345",
            "resource_type": "task",
            "name": "Marketing"
        }
    }
}

Modified at 2022-09-13 02:00:31

Get all projects in a workspace

Get sections in a project