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.

TagCompact

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.

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. Values can be: `dark-pink`, `dark-green`, `dark-blue`, `dark-red`, `dark-teal`, `dark-brown`, `dark-orange`, `dark-purple`, `dark-warm-gray`, `light-pink`, `light-green`, `light-blue`, `light-red`, `light-teal`, `light-brown`, `light-orange`, `light-purple`, `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]	Array of users following this tag.
`followers[]`	object	A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
`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"
}