Tags

A tag is a label that can be attached to any task in Asana. It exists in a single workspace or organization.

Tags have some metadata associated with them, but it is possible that we will simplify them in the future so it is not encouraged to rely too heavily on it. Unlike projects, tags do not provide any ordering on the tasks they are associated with.


{/ START_AUTOMATED_SECTION /}

TagCompact

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
namestringName of the tag. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.

Example JSON for TagCompact:

{
  "gid": "12345",
  "resource_type": "tag",
  "name": "Stuff to buy"
}

Tag

Property Type Description
`gid` string Globally unique identifier of the resource, as a string.
`resource_type` string The base type of this resource.
`name` string Name of the tag. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
`color` string Color of the tag.
Click to show all enum values
  • dark-blue
  • dark-brown
  • dark-green
  • dark-orange
  • dark-pink
  • dark-purple
  • dark-red
  • dark-teal
  • dark-warm-gray
  • light-blue
  • light-brown
  • light-green
  • light-orange
  • light-pink
  • light-purple
  • light-red
  • light-teal
  • light-warm-gray
  • null
`notes` string Free-form textual information associated with the tag (i.e. its description).
`created_at` string (date-time) The time at which this resource was created.
`followers[]` [object]

Full object requires scope: users:read

Array of users following this tag.
`followers[].gid` string Globally unique identifier of the resource, as a string.
`followers[].resource_type` string The base type of this resource.
`followers[].name` string *Read-only except when same user as requester* The user's name.
`workspace` object A *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.
`workspace.gid` string Globally unique identifier of the resource, as a string.
`workspace.resource_type` string The base type of this resource.
`workspace.name` string The name of the workspace.
`permalink_url` string A url that points directly to the object within Asana.

Example JSON for Tag:

{
  "gid": "12345",
  "resource_type": "tag",
  "name": "Stuff to buy",
  "color": "light-green",
  "notes": "Mittens really likes the stuff from Humboldt.",
  "created_at": "2012-02-22T02:06:58.147Z",
  "followers": [
    {
      "gid": "12345",
      "resource_type": "user",
      "name": "Greg Sanchez"
    }
  ],
  "workspace": {
    "gid": "12345",
    "resource_type": "workspace",
    "name": "My Company Workspace"
  },
  "permalink_url": "https://app.asana.com/0/resource/123456789/list"
}
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.