Wrike

Wrike is a project management and collaboration tool offering customizable workflows, Gantt charts, reporting, and resource management to boost team productivity

List Folder Blueprints

Lists account-level folder blueprints tree in wrike.

Create new group with json payload

Creates a new group within the wrike collaborative work management platform. this endpoint allows you to set up a group with a specified title, members, parent group, avatar, and custom metadata. use this when you need to organize team members into a new group, create sub-groups within an existing structure, or add a new project team. the created group can be used for task assignments, access control, and organization within wrike. note that while creating an empty group is possible, it’s generally more useful to include members during creation. the endpoint does not provide group deletion or updating functionality, which would require separate api calls.

List Space Task Blueprints

Lists space-level task blueprints in wrike.

Create subfolder within a folder

Creates a new subfolder within an existing folder in wrike. this endpoint allows for detailed customization of the new subfolder, including its title, description, sharing settings, custom fields, and project-specific attributes. it’s particularly useful for organizing work, creating new projects, or setting up collaborative spaces within an existing folder structure. the endpoint offers flexibility in defining user access roles and custom metadata, making it suitable for complex project setups or when integrating with other systems. however, it’s important to note that while many customization options are available, only the ‘title’ parameter is required for creating a basic subfolder.

List Space Folder Blueprints

Lists space-level folder blueprints tree in wrike.

Create invitation

Creates and sends an invitation to join a wrike workspace. this endpoint allows you to invite new users to your wrike account by specifying their email address and optional details such as name, role, and user type. it’s particularly useful for onboarding new team members or external collaborators. the invitation process can be customized with personalized subject lines and messages, though these features are not available for free accounts. when using this endpoint, be mindful of the mutually exclusive parameters (role, external, and usertypeid) to ensure proper user configuration.

Retrieve invitation list

Retrieves a list of all active invitations in the wrike system. this endpoint allows users to view pending invitations sent to collaborators, team members, or external partners. it’s useful for tracking outstanding invitations and managing user onboarding processes. the response likely includes details such as the invitee’s email, the date the invitation was sent, and its current status. this tool should be used when you need to audit or manage the invitation process within your wrike workspace. note that this endpoint only provides information about active invitations and does not allow for creating, modifying, or canceling invitations.

Retrieve list of groups

Retrieves a list of groups within the wrike workspace. this endpoint allows users to fetch information about existing groups, which are essential for team management and organization in wrike. it supports pagination and optional field selection for more detailed group information. use this endpoint when you need to display a list of groups, manage team structures, or gather group-related data for reporting purposes. the endpoint returns basic group information by default, with options to include additional details as needed. it does not create, modify, or delete groups; separate endpoints should be used for those operations.

Fetch all workflows

Retrieves a list of workflows from the wrike platform. this endpoint allows you to fetch information about existing workflows, including their structure, stages, and associated metadata. use this endpoint when you need to view or analyze the current workflows set up in your wrike account. it’s particularly useful for auditing workflow configurations, integrating workflow information into external systems, or building custom reporting tools. the endpoint supports pagination and filtering by status, allowing for efficient retrieval of large sets of workflow data. note that this endpoint only provides read access to workflow information and cannot be used to modify existing workflows or create new ones.

Retrieve custom field by id

Retrieves detailed information about a specific custom field in wrike by its unique identifier. this endpoint allows developers to access the properties, configuration, and metadata of a custom field, which can be crucial for understanding the structure of tasks, projects, or other entities in wrike that use this custom field. use this endpoint when you need to inspect or validate the settings of a particular custom field, such as its type, possible values (for dropdown fields), or any other associated attributes. it’s particularly useful when building integrations that need to work with wrike’s custom data structures or when creating reports that involve custom field data.

List subfolders by folder id

Retrieves a list of subfolders within a specified parent folder in the wrike workspace. this endpoint is used to navigate the folder hierarchy and obtain information about the immediate child folders of a given folder. it’s particularly useful for building folder tree structures, implementing folder navigation in user interfaces, or when you need to process or analyze the contents of a specific folder. the endpoint returns only the direct subfolders and does not recursively fetch nested folder structures. use this when you need to explore or manage the organization of projects, tasks, or other items within the wrike folder system. note that this endpoint does not provide information about the contents of the subfolders (such as tasks or files) - it only returns folder metadata.

List Task Blueprints

Lists account-level task blueprints in wrike.

Get group by id

Retrieves detailed information about a specific group in wrike. this endpoint allows you to fetch comprehensive data about a group, including its name, members, permissions, and other relevant attributes. use this when you need to access or display information about a particular group within your wrike workspace. the endpoint is particularly useful for applications that manage team structures, permissions, or need to show group details in user interfaces. note that this endpoint only provides read access to group data and cannot be used to modify group information. ensure you have the necessary read permissions for the group you’re querying.

Get contacts

Retrieves a list of contacts from the wrike platform. this endpoint allows users to access contact information for individuals associated with their wrike account, such as team members, clients, or external collaborators. it’s particularly useful for applications that need to display or manage user information within wrike projects or tasks. the endpoint returns contact details in json format, likely including fields such as name, email, and role. while it provides a comprehensive list of contacts, it may not include detailed information about each contact’s specific task assignments or project involvement. use this endpoint when you need to retrieve contact information for user management, team organization, or integration with other systems.

Get custom fields

Retrieves a list of custom fields defined in the wrike workspace. this endpoint allows you to fetch all custom fields or a subset based on optional filtering parameters. it’s useful for obtaining an overview of the available custom fields, their types, and configurations. the response typically includes details such as field ids, names, types (e.g., text, dropdown, numeric), and any associated metadata. use this endpoint when you need to populate a list of available custom fields in your application or when you need to retrieve the ids of specific custom fields for use in other api calls. note that the endpoint may not return the actual values of custom fields for specific tasks or projects; it focuses on the field definitions themselves.

Get folders

Retrieves a list of folders from the user’s wrike account. this endpoint allows users to fetch information about their folders, which are fundamental organizational units in wrike used for managing projects, tasks, and other work items. it can be used to obtain an overview of the folder structure, gather details about specific folders, or as part of a folder navigation feature. the endpoint supports optional filtering, field selection, and pagination to customize the response based on the user’s needs. it’s particularly useful for applications that need to display or manipulate the folder hierarchy within a wrike account, such as project management dashboards or folder tree visualizations.

Retrieve contact by id

Retrieves detailed information about a specific contact in wrike using their unique identifier. this endpoint allows you to fetch comprehensive data about a single contact, including their personal information, role, and any custom fields associated with them. use this when you need to access or display the full profile of a particular contact within your wrike account. the endpoint is particularly useful for integrations that require up-to-date contact information or for populating user interfaces with detailed contact data. note that this endpoint only provides information for one contact at a time; for bulk retrieval of contacts, a separate endpoint would be necessary.

Update custom field by id

Updates an existing custom field in wrike. this endpoint allows users to modify the properties of a custom field, such as its name, type, or other attributes. it should be used when changes to a custom field’s configuration are needed, such as updating its name, changing its type, or modifying its applicability to tasks, folders, or projects. the endpoint requires the default or wsreadwrite scope for authorization. note that while you can update various properties, you cannot change a custom field’s id or convert it between space-level and account-level fields using this endpoint. be cautious when modifying custom fields, as changes may affect existing data and integrations relying on the field.

Create task in folder

Creates a new task within a specified folder in wrike. this endpoint allows for detailed task creation with numerous customizable fields, supporting wrike’s comprehensive project and task management capabilities. it can be used to programmatically add tasks to projects, set task properties, assign responsibilities, and integrate with custom workflows. the endpoint is particularly useful for bulk task creation, automating project setups, or integrating wrike task creation into external systems or workflows.

Modify pending invitation parameters

Updates the properties of a pending invitation in wrike. this endpoint allows you to modify various aspects of an invitation that has not yet been accepted, such as resending the invitation, changing the user’s role, or updating their user type. it’s particularly useful for correcting mistakes in the original invitation or adjusting user permissions before the invitee joins the wrike account. the endpoint should only be used for pending invitations; attempting to modify accepted or expired invitations will likely result in an error. note that some parameters are deprecated, and using the ‘usertypeid’ parameter is recommended for setting user roles and permissions.

Update account metadata

This endpoint allows you to update or add metadata to a wrike account. it’s used for storing custom key-value pairs of information associated with the account, which can be useful for integrations with external systems or maintaining application-specific data. the metadata is isolated on a per-client (application) basis, ensuring that different integrations don’t interfere with each other’s data. you can add new metadata entries, update existing ones, or remove entries by setting their value to null. this endpoint is particularly useful for maintaining mappings between wrike account data and external system identifiers or configurations.

Retrieve user information

Retrieves detailed information about a specific user in the wrike platform. this endpoint allows you to fetch user data such as profile information, account settings, and role within the organization. it’s particularly useful when you need to access or verify details of a single user account. the endpoint should be used when specific user information is required, such as during user management tasks, permission checks, or when displaying user profiles. note that this endpoint only provides information for one user at a time and does not return sensitive data like passwords.

Modify folder attributes

The updatefolder endpoint modifies existing folders in wrike. it can rename folders, update descriptions, manage folder hierarchy, control sharing, update custom fields, and convert between folders and projects. use it for workspace organization, project management, and access control. exercise caution with operations that significantly alter folder properties or accessibility.

Retrieve task by id

Retrieves detailed information about a specific task in the wrike platform. this endpoint allows developers to fetch comprehensive data about a task, including its title, description, status, assignees, due dates, custom fields, and other relevant metadata. it’s particularly useful when you need to access or display the full details of a task within your application or integration. the endpoint should be used when you have a specific task id and require its complete information. note that this endpoint only retrieves data and does not modify the task; for updates, you would need to use a separate endpoint.

Delete customfield by id

This endpoint permanently deletes a specific custom field from the wrike system. it should be used when you need to remove a custom field that is no longer required or relevant to your project management workflow. the deletion is irreversible, so use this endpoint with caution. only account administrators or users with appropriate permissions can perform this operation. after deletion, the custom field will no longer be available for tasks, folders, projects, or spaces where it was previously used. this endpoint does not return the deleted field’s data; it typically returns a success status upon completion. be aware that deleting a custom field may affect existing reports or integrations that rely on that field’s data.

Update contact details by id

The updatecontactdetails endpoint allows you to modify various aspects of a contact’s information in wrike. this put request to /contacts/{contactid} enables updating metadata, bill rates, cost rates, job roles, and custom fields for a specific contact. use this endpoint when you need to change or add details to a contact’s profile, such as updating their job role, modifying billing information, or managing custom fields. the endpoint provides granular control over which fields to update and allows for the inclusion of specific fields in the response. note that while users have full read/write access to their own metadata, they may have limited access to other contacts’ information. additionally, custom fields can be removed by setting their values to null, providing flexibility in managing contact data.

Delete folder by id

Deletes a specified folder from the wrike workspace. this endpoint permanently removes the folder and all its contents, including tasks, documents, and subfolders. use this endpoint when you need to eliminate a project or organizational structure that is no longer needed. exercise caution when calling this endpoint, as the deletion is irreversible and may affect team members’ access to information. the operation may fail if the folder contains active tasks or if the user doesn’t have sufficient permissions to delete the folder. it’s recommended to review the folder contents and inform team members before deletion.

Delete group by id

Deletes a specific group from the wrike workspace. this endpoint should be used when you need to remove a group that is no longer required, such as for organizational restructuring or cleaning up obsolete team structures. it permanently removes the group and its associations, but does not affect the users who were members of the group. use with caution as this action cannot be undone. the endpoint does not return the deleted group’s data; it typically returns a success status code upon completion.

Launch Folder Blueprint Async

Launches a folder blueprint asynchronously in wrike.

Launch Task Blueprint Async

Launches a task blueprint asynchronously in wrike.

Update user profile by account id

Updates a user’s profile information in the wrike system. this endpoint allows for modifying specific attributes of a user’s profile, including their associated account, role, and external status. it’s particularly useful for user management tasks such as changing a user’s role or updating their account association. the endpoint should be used when there’s a need to modify existing user information, but it cannot be used to create new users or delete existing ones. note that partial updates are supported, meaning you can update one or more fields without affecting the others.

Delete invitation by id

This endpoint deletes a specific invitation in the wrike platform using its unique identifier. it should be used when you need to cancel or remove an existing invitation, perhaps due to a mistake or change in circumstances. the deletion is permanent and cannot be undone, so use this endpoint with caution. it’s particularly useful for managing user access and maintaining the accuracy of pending invitations in your wrike workspace. note that this endpoint only handles deletion and does not provide any information about the invitation being removed.

Fetch all tasks

Retrieves a list of tasks from the wrike platform based on specified criteria. this endpoint allows you to fetch task information, including details such as task title, description, status, due dates, and assignees. it’s useful for applications that need to display or process task data from wrike, such as project management dashboards or reporting tools. the endpoint supports pagination and filtering to manage large sets of tasks efficiently. while it provides comprehensive task data, it does not modify any task information - use separate endpoints for creating, updating, or deleting tasks. note that the response may not include all task fields by default, so specify required fields using the ‘fields’ parameter for complete information.

Delete task by id

Deletes a specific task from the wrike system using its unique identifier. this endpoint should be used when you need to permanently remove a task from a project or workspace. the operation is irreversible, so it should be used with caution. once a task is deleted, all associated data, including comments, attachments, and custom fields, will be permanently removed. this endpoint is particularly useful for cleaning up completed or obsolete tasks, or when restructuring projects. it requires the ‘wsreadwrite’ scope and should only be accessed by users with appropriate permissions to delete tasks.

Get account details

Retrieves detailed information about the authenticated user’s wrike account. this endpoint provides essential account-level data, which may include account name, id, subscription details, and other relevant metadata. it should be used when you need to access or display general account information within your application. the endpoint does not modify any data and is suitable for read-only operations. note that the specific fields returned may vary based on the user’s permissions and the account’s subscription level.

Update group information

Updates an existing group in wrike with new properties and settings. this endpoint allows you to modify various aspects of a group, including its title, membership, invitations, parent group, avatar, and metadata. it’s particularly useful for managing group structures, adjusting team compositions, and maintaining up-to-date group information. the endpoint requires the group id and accepts multiple optional parameters for granular control over group properties. it’s important to note that this operation can affect user access and group hierarchy, so it should be used carefully, especially when modifying members or changing the parent group.

Bulk update group members

The update group members bulk endpoint allows for bulk updating of group memberships in wrike. it enables adding and removing members from multiple groups in a single api call, improving efficiency in group management operations. this endpoint is particularly useful for large-scale group membership changes or when synchronizing group data with external systems. the operation is limited to 20 group updates per request, ensuring optimal performance and preventing misuse. use this endpoint when you need to modify memberships for multiple groups simultaneously, rather than making individual api calls for each group update.

Update task properties

Updates an existing task in wrike with the provided information. this endpoint allows for comprehensive modifications to a task, including its basic properties, relationships with other tasks and folders, assignees, custom fields, and more. it’s particularly useful for keeping task information up-to-date as project requirements change or progress is made. the endpoint can handle multiple types of updates in a single call, making it efficient for batch updates or complex task modifications. however, users should be cautious when using this endpoint, as it can significantly alter task details and relationships. it’s recommended to review the changes carefully before submitting the update request.

Get Started

Documentation

Changelog

Legal