[Improved] Variables assignees in project templates

English Forum Developers & API Changelog
, , ,
1

Original announcement

Summary

We are thrilled to announce a significant enhancement to our API that will empower you to take your workflow management to the next level: variable assignee support, otherwise known as requested_roles, has been added to the API. This update brings extensibility to how you handle assignees in your projects.

Usage

Note: If you do not specify requested_roles, or if some of the requested roles are unset, the behavior will remain as it previously had, and tasks will remain unassigned.

The following endpoints have been updated to support variable assignees, using the “requested_roles” field:

"requested_roles": [
    {
        "gid": "1199698813650303",
        "name": "Tech Lead",
    },
    {
        "gid": "1199698813652351",
        "name": "Designer",
    }
]

When requesting project templates, a new requested_roles field will be returned, containing a list of roles.

"requested_roles": [
    {
        "gid": "1199698813652351",
        "value": "1201974226015987" // User ID for the Designer role
    },
    {
        "gid": "1199698813650303",
        "value": "1201974226011942" // User ID for the Tech Lead role
    }
]

When instantiating a project from a template, you can now specify the requested_roles field, allowing you to pass in an array of roles mapped to specific users. The value field indicates which user should be assigned to the corresponding role.

For more information on requested_roles, check out the schemas for project templates.

Questions & feedback

This update opens up new possibilities for your applications, enabling you to dynamically assign roles and streamline your project management processes.

We can’t wait to see how you leverage this new feature in your applications! If you have any questions, suggestions, or need further guidance, feel free to share your thoughts with the community. Your feedback is essential, and we’re here to support your development efforts.

Best,
Andrew

2 Likes