Bynder

Bynder Workflow Users and Groups API

Users and groups as seen by the Asset Workflow service, separate from the asset-bank user administration API.

GitHub OpenAPI

Documentation

📖
Documentation
https://api.bynder.com/docs/getting-started
📖
APIReference
https://api.bynder.com/reference
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/bynder/refs/heads/main/authentication/bynder-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/bynder/refs/heads/main/openapi/bynder-wf-users-groups-v4-openapi.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/bynder/refs/heads/main/overlays/bynder-wf-users-groups-v4-overlay.yaml

OpenAPI Specification

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