Create a project

POST

/projects

Create a new project in a workspace or team.

Every project is required to be created in a specific workspace or
organization, and this cannot be changed once set. Note that you can use
the workspace parameter regardless of whether or not it is an
organization.

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 Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://app.asana.com/api/1.0/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"
        }
    }
}

Request

Body Params application/json

Examples

Responses

🟢201Successfully retrieved projects.

application/json

Body

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500

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

Get multiple projects

Delete a project