Project API returns incorrect color values on PUT and GET

I’m seeing inconsistent behavior with the Asana PUT and GET Project APIs when updating the color field.

When I send the following request:

PUT https://app.asana.com/api/1.0/projects/<project guid> HTTP/1.1
Host: app.asana.com
User-Agent: SomeAgent/1.0
Accept-Encoding: gzip, deflate
accept: application/json
Connection: keep-alive
content-type: application/json
Authorization: Bearer <token>

{
    "data": {
        "name": "Test Update Project",
        "color": "dark-blue"
    }
}

The PUT response does not return the color I sent. Instead, the response shows light-blue.

If I then perform a GET request on the same project, the returned color changes again—this time to blue.

I’ve tested multiple valid color values and consistently get mismatched results between what I send, what the PUT response returns, and what the GET request returns.

Is there a known issue with how the Projects API handles the color field? Or is there updated documentation on the accepted color values and their mappings?

Bump.

Hi @Marin_Takanov you may want to check this out:

Perhaps @Mikhail_Melikhov or @John_Vu can assist you?

2 Likes

Hi @Marin_Takanov , thanks for flagging this and for the clear repro steps.

You’re running into a known discrepancy: after the new color palette was introduced in the Asana web UI, the Projects API color field behaves inconsistently between read (GET) and write (POST/PUT). Unfortunately, due to some legacy dependencies, we’re still working through the remaining changes needed to make read and write fully align.

In the meantime, please use the following mapping between the “write” (old) color values and the “read“ (new) colors:

Current API Colors (OLD)        | Current Web Colors (NEW)
--------------------------------|-----------------------
None                            | None
Dark Red                        | Red
Dark Orange                     | Orange
Light Orange                    | Yellow-Orange
Dark Brown, Light Yellow        | Yellow
Light Green                     | Yellow-Green
Dark Green                      | Green
Light Teal                      | Blue-Green
Dark Teal                       | Aqua
Dark Blue, Light Blue           | Blue
Dark Purple                     | Indigo
Light Purple                    | Purple
Light Pink                      | Magenta
Dark Pink                       | Hot Pink
Light Red                       | Pink
Dark Warm Gray, Light Warm Gray | Cool Gray
2 Likes