Skip to content

GitLab

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in
P Portal-api
  • Project overview
    • Project overview
    • Details
    • Activity
  • Issues 0
    • Issues 0
    • List
    • Boards
    • Labels
    • Service Desk
    • Milestones
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Members
    • Members
  • Activity
  • Create a new issue
  • Issue Boards
Collapse sidebar
  • doc
  • Portal-api
  • Wiki
  • Group API

Group API · Changes

Page history
Added response chapter authored Apr 22, 2022 by Jurjen Brouwer's avatar Jurjen Brouwer
Hide whitespace changes
Inline Side-by-side
Showing with 47 additions and 11 deletions
+47 -11
  • Group-API.md Group-API.md +47 -11
  • No files found.
Group-API.md
View page @ 857746df
## Actions
### Create
Create a new group for the user that has authenticated itself.
```
......@@ -5,7 +7,7 @@ https://portal.robotsindeklas.nl/API/v1/group/create
```
Parameter:
- **name**, *string*: the new name of the group.
- **name** - *string*: the new name of the group.
### Info
......@@ -15,7 +17,7 @@ https://portal.robotsindeklas.nl/API/v1/group/info
```
Parameter:
- **group**, *string*: the object id of the group you want the info of.
- **group** - *string*: the object id of the group you want the info of.
### Copy
......@@ -25,8 +27,8 @@ https://portal.robotsindeklas.nl/API/v1/group/copy
```
Parameters:
- **group**, *string*: the object id of the group you want to copy
- **name**, *string*, (optional, default: name of the original group): the new name of the copied group
- **group** - *string*: the object id of the group you want to copy
- **name** - *string* - (optional, default: name of the original group): the new name of the copied group
### Lock
Lock a group. If a group is locked, users with play or edit share rights will no longer have access to the group.
......@@ -35,8 +37,8 @@ https://portal.robotsindeklas.nl/API/v1/group/lock
```
Parameters:
- **group**, *string*: the object id of the group you want to lock;
- **lock**, *boolean*, (optional, default: false): lock (true) or unlock (false) this group.
- **group** - *string*: the object id of the group you want to lock;
- **lock** - *boolean* - (optional, default: false): lock (true) or unlock (false) this group.
### Share
......@@ -52,9 +54,9 @@ https://portal.robotsindeklas.nl/API/v1/group/share
```
Parameters:
- **group**, *string*: the object id of the group you want to share;
- **level**, *int*: the share level we want to assign to the user or group with this request;
- **oid**, *string*: the object id of the user or group we want the share this group with.
- **group** - *string*: the object id of the group you want to share;
- **level** - *int*: the share level we want to assign to the user or group with this request;
- **oid** - *string*: the object id of the user or group we want the share this group with.
### Trash
......@@ -64,5 +66,39 @@ https://portal.robotsindeklas.nl/API/v1/group/trash
```
Parameters:
- **group**, *string*: the object id of the group we want to trash
- **del**, *boolean*: delete (true) or restore (false) deleted item.
\ No newline at end of file
- **group** - *string*: the object id of the group we want to trash
- **del** - *boolean*: delete (true) or restore (false) deleted item.
## Response
If the request was successful, you will receive the following response:
Model:
```
{
'_id': ObjectId - The id of the group
'name': String - The name of the group, visible in the portal
'type': String - The type of the group (currently not used)
'tags': Array - An array of tags describing this user (currently not used)
'owner': ObjectId - The user id of the user who owns this group
'access': Integer - The access level you have over this group
}
```
Example:
```
{
'_id': {
'$oid': '60d676f4dbcbca6e332153f5'
},
'name': 'Beheerders',
'type': '',
'tags': [],
'owner': {
'$oid': '60f9d71cd6e5e131a0571b1c'
},
'access': 2
}
```
\ No newline at end of file
Clone repository
  • App API
  • Folder API
  • Group API
  • Robot API
  • User API
  • Home