---
schema_version: "1"
id: 84fbe08a0f57775794cfbbccbacc6fe6e878ec3663608701344de5ec5187d6f6
title: GET /hub/v1/workflowteams/{objecttype}
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/workflowTeams.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_workflowteams/workflowTeams.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: c48c85a6f6eeffed5751d8d3ab8cbadff8d3b63614914562aff74f5c0a77903d
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# GET /hub/v1/workflowteams/{objecttype}

## Overview

Retrieves a list of active workflow teams. Depending on the query string parameters, the result includes one or both filtered results: role user information for each workflow item or workflow items to which the current user is assigned.

## URL Parameters

| Name       | Type   |          | Description                                                                                        |
| ---------- | ------ | -------- | -------------------------------------------------------------------------------------------------- |
| objecttype | string | Required | Specify the workflow object type to retrieve or use (@all to retrieve all workflow object types.   |
| assignee   | string |          | If assignee=@current, this resource retrieves workflow teams that the current user is assigned to. |
| extra      | string |          | If extra=roleusers, then each item in the response includes role user information as a collection. |

## Responses

| Status  | Name                               | Type   | Description                                                            |
| ------- | ---------------------------------- | ------ | ---------------------------------------------------------------------- |
| **200** |                               |   | **Response contains a list of workflow teams.**                        |
|    | count                              | string | Number of records retrieved                                            |
|    | page                               | string | Current page number                                                    |
|    | pageSize                           | string | Number of records on each page                                         |
|    | objectType                         | string | Workflow type                                                          |
|    | Items                              | array  | List of workflow items                                                 |
|    | Items.id                           | string | Workflow Id                                                            |
|    | Items.objectType                   | string | Workflow object type                                                   |
|    | Items.name                         | string | Workflow name                                                          |
|    | Items.description                  | string | Description of the workflow                                            |
|    | Items.roleUsers                    | array  | List of role users                                                     |
|    | Items.roleUsers.id                 | string | Unique Id for the association between role and users                   |
|    | Items.roleUsers.TeamId             | string | Team Id the role user is associated with                               |
|    | Items.roleUsers.roleDefinitionId   | string | Role definition Id                                                     |
|    | Items.roleUsers.roleDefinitionName | string | Role definition name                                                   |
|    | Items.roleUsers.employeeId         | string | Id of the user assigned to the role                                    |
|    | Items.roleUsers.employeeName       | string | Name of the user assigned to the role                                  |
|    | Items.roleUsers.roleId             | string | Id of the role                                                         |
|    |                               |   |                                                                   |
| **404** |                               |   | **404 Not Found**                                                      |
|    | message                            | string | No workflow teams found for workflow object type: [workflowObjectType] |
|    | errorcode                          | string | Error code for the exception (30003)                                   |