{"openapi":"3.1.0","info":{"title":"Groups","version":"1.0.0"},"servers":[{"url":"https://{your-bynder-domain}/"}],"tags":[{"name":"Groups","description":"Manage and retrieve groups within your Bynder account. Requires the **GROUPMANAGEMENT** security role.\n"}],"paths":{"/api/groups/list/":{"get":{"summary":"Retrieve groups","description":"Requires the **GROUPMANAGEMENT** security role.","tags":["Groups"],"parameters":[{"name":"search_term","in":"query","required":false,"schema":{"type":"string"},"description":"Search on matching group names."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1},"description":"What page of results to return."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Maximum results to return. If limit is not provided the first 20 results will be returned."},{"name":"sort_order","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]},"description":"Order of the returned list of groups."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}}}}}}},"security":[{"permanentToken":["GROUPMANAGEMENT"]},{"OAuth2":["GROUPMANAGEMENT"]}]}}},"components":{"securitySchemes":{"permanentToken":{"type":"apiKey","in":"header","name":"Authorization"},"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://{your-bynder-domain}/v6/authentication/oauth2/token","scopes":{"GROUPMANAGEMENT":"Grants permission to manage groups"}},"authorizationCode":{"authorizationUrl":"https://{your-auth-url}","tokenUrl":"https://{your-bynder-domain}/v6/authentication/oauth2/token","scopes":{"GROUPMANAGEMENT":"Grants permission to manage groups"}}}}}}}