Create a tag

POST

/tags

Creates a new tag in a workspace or organization.

Every tag 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.

Returns the full record of the newly created tag.

Request

Body Params application/json

Examples

Responses

🟢201Successfully created the newly specified tag.

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/tags' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "name": "Stuff to buy",
        "color": "light-green",
        "followers": [
            "12345",
            "42563"
        ],
        "workspace": "12345"
    }
}'

Response Example

201 - Example 1

{
    "data": {
        "gid": "12345",
        "resource_type": "task",
        "name": "Stuff to buy",
        "color": "light-green",
        "followers": [
            {
                "gid": "12345",
                "resource_type": "task",
                "name": "Greg Sanchez"
            }
        ],
        "permalink_url": "https://app.asana.com/0/resource/123456789/list",
        "workspace": {
            "gid": "12345",
            "resource_type": "task",
            "name": "My Company Workspace"
        }
    }
}

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

Get multiple tags

Delete a tag