Update Project Icon via API

English Forum Developers & API
1

Seems wild we can change the color behind the icon, but not the icon itself, equally when setting a template you can’t define the icon either, so neither our template nor our duplicating templates to set-up projects via the API automation can set the icon.

When I GET a project over API there’s not mention of the icon, when I do a PUT it actually lists the icon in the return json, but if I try and manually mention icon: graph (for instance) as a custom field it errors when trying to update.

Would be really cool if we were able to set the icon for particular project types (either via templates, but ideally via the API).

2

Yes! This needs to be two-fold:

  • Let us set the icon and the color at the Project Template level, or even via a Bundle.
  • Let us set the icon via the API, since we can already set the color via API PUT
3

@dbrdak @Mikhail_Melikhov

4

Hi @FreshyJon , thanks for raising this!

You can set a project’s icon via the API today. It’s a writable field on the project object:

PUT https://app.asana.com/api/1.0/projects/{project_gid}
{
   "data": {
      "icon": "star"
   }
}

The list of available icon property values is documented here.

If you’re not seeing the icon property on GET /projects/{project_gid}, please make sure to include it in opt_fields param, by default it’s omitted.

Color is adjustable with the same approach, and following a recent (and somewhat debated) update, it’s now managed at the workspace level.

Setting the icon at the project template level isn’t available right now.

I agree it would be great to define both color and icon at the template so new projects inherit them automatically. I’ve checked customer feedback entries and there are a few requests for this already, so the feedback is on the radar. No timelines I can share as I don’t see it prioritized at the moment, but it’s indeed a sensible enhancement.