---
title: "Workflow Users and Groups API"
url: "https://earlyaccess.developers.bynder.com/apis/workflow-users-and-groups-api-1/versions/95f38e13-7691-49d0-80f0-875f3802be91"
---

# Workflow Users and Groups API

OpenAPI specification document.

```json
{"components":{"securitySchemes":{"OAuth2":{"flows":{"authorizationCode":{"authorizationUrl":"https://{your-auth-url}","scopes":{"GROUPOVERVIEW":"","USERMANAGEMENT":"","WORKFLOWADMIN":""},"tokenUrl":"https://{your-bynder-domain}/v6/authentication/oauth2/token"},"clientCredentials":{"scopes":{"GROUPOVERVIEW":"","USERMANAGEMENT":"","WORKFLOWADMIN":""},"tokenUrl":"https://{your-bynder-domain}/v6/authentication/oauth2/token"}},"type":"oauth2"},"permanentToken":{"in":"header","name":"Authorization","type":"apiKey"}}},"info":{"title":"Workflow Users and Groups API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/workflow/groups/":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"ID":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"accountID":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"createdByID":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"dateCreated":{"example":"2017-10-27T16:32:16+00:00","type":"string"},"name":{"example":"Content Reviewers","type":"string"},"users":{"items":{"properties":{"ID":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"bynderUser":{"properties":{"email":{"example":"test@bynder.com","type":"string"},"firstName":{"example":"FirstName","type":"string"},"id":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"infix":{"example":null,"type":"string"},"lastName":{"example":"LastName","type":"string"}},"type":"object"},"fullName":{"example":"FirstName LastName","type":"string"}},"type":"object"},"type":"array"}},"type":"object"}}},"description":"A list of workflow groups"}},"security":[{"permanentToken":["GROUPOVERVIEW","WORKFLOWADMIN"]},{"OAuth2":["GROUPOVERVIEW","WORKFLOWADMIN"]}],"summary":"Retrieve groups","tags":["Groups"]},"post":{"requestBody":{"content":{"application/json":{"schema":{"properties":{"name":{"example":"new name","type":"string"},"user_ids":{"items":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"type":"array"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Group created"}},"security":[{"permanentToken":["GROUPOVERVIEW","WORKFLOWADMIN"]},{"OAuth2":["GROUPOVERVIEW","WORKFLOWADMIN"]}],"summary":"Create group","tags":["Groups"]}},"/api/workflow/groups/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000-000000000000","type":"string"}}],"responses":{"204":{"description":"Group deleted"}},"security":[{"permanentToken":["GROUPOVERVIEW","WORKFLOWADMIN"]},{"OAuth2":["GROUPOVERVIEW","WORKFLOWADMIN"]}],"summary":"Delete group","tags":["Groups"]},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000-000000000000","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"ID":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"accountID":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"createdByID":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"dateCreated":{"example":"2017-10-27T16:32:16+00:00","type":"string"},"name":{"example":"Content Reviewers","type":"string"},"users":{"items":{"properties":{"ID":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"bynderUser":{"properties":{"email":{"example":"test@bynder.com","type":"string"},"firstName":{"example":"FirstName","type":"string"},"id":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"infix":{"example":null,"type":"string"},"lastName":{"example":"LastName","type":"string"}},"type":"object"},"fullName":{"example":"FirstName LastName","type":"string"}},"type":"object"},"type":"array"}},"type":"object"}}},"description":"A specific workflow group"}},"security":[{"permanentToken":["GROUPOVERVIEW","WORKFLOWADMIN"]},{"OAuth2":["GROUPOVERVIEW","WORKFLOWADMIN"]}],"summary":"Retrieve specific group","tags":["Groups"]},"put":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000-000000000000","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"name":{"example":"new name","type":"string"},"user_ids":{"items":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"type":"array"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Group modified"}},"security":[{"permanentToken":["GROUPOVERVIEW","WORKFLOWADMIN"]},{"OAuth2":["GROUPOVERVIEW","WORKFLOWADMIN"]}],"summary":"Modify group","tags":["Groups"]}},"/api/workflow/users/":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"items":{"properties":{"BynderUser":{"properties":{"email":{"example":"example@example.com","type":"string"},"firstName":{"example":"Firstname","type":"string"},"id":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"infix":{"example":"Van","type":"string"},"lastName":{"example":"Lastname","type":"string"}},"type":"object"},"ID":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"fullname":{"example":"Firstname Lastname","type":"string"}},"type":"object"},"type":"array"}}},"description":"A list of workflow users"}},"security":[{"permanentToken":["USERMANAGEMENT"]},{"OAuth2":["USERMANAGEMENT"]}],"summary":"Retrieve users","tags":["Users"]}},"/api/workflow/users/{id}":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"example":"00000000-0000-0000-0000-000000000000","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"BynderUser":{"properties":{"email":{"example":"example@example.com","type":"string"},"firstName":{"example":"Firstname","type":"string"},"id":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"infix":{"example":"Van","type":"string"},"lastName":{"example":"Lastname","type":"string"}},"type":"object"},"ID":{"example":"00000000-0000-0000-0000-000000000000","type":"string"},"fullname":{"example":"Firstname Lastname","type":"string"}},"type":"object"}}},"description":"A specific workflow user"}},"security":[{"permanentToken":["USERMANAGEMENT"]},{"OAuth2":["USERMANAGEMENT"]}],"summary":"Retrieve specific user","tags":["Users"]}}},"servers":[{"url":"https://{your-bynder-domain}"}],"tags":[{"description":"","name":"Users"},{"description":"","name":"Groups"}]}
```