What can we help you with?

e.g. Getting Started, Build Dashboards

Top

Group Managment

Follow

Groups

This endpoint is for updating/modifying the user details of a given user id
Query

GET /api/1.0/groups

No parameters
Response
HTTP Status Response
200 OK Output example: 
{
   "list":[
      {
         "id":889,
         "groupName":"Default"
      },
      {
         "id":890,
         "groupName":"group1"
      },
      {
         "id":891,
         "groupName":"group2"
      }
   ]
}
400 BAD_REQUEST 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Missing Authorization header
  • Invalid count of Authorization headers
  • Bearer token missing
401 UNAUTHORIZED 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Bearer token is not found or expired
  • Authorization issue or user does not exist

Example

curl -i -H "Authorization: Bearer HERE_IS_YOUR_BEARER" https://www.knowi.com/api/1.0/groups/

User Groups

This endpoint returns a listing the groups of a specific user of a given user id
Query

GET /api/1.0/users/<user_id>/groups

Parameter Comments
user_id User id of User to get Groups
Response
HTTP Status Response
200 OK Output example: 
{
   "list":[
      {
         "id":889,
         "groupName":"Default"
      },
      {
         "id":890,
         "groupName":"group1"
      },
      {
         "id":891,
         "groupName":"group2"
      }
   ]
}
400 BAD_REQUEST 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Missing Authorization header
  • Invalid count of Authorization headers
  • Bearer token missing
401 UNAUTHORIZED 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Bearer token is not found or expired
  • Authorization issue or user does not exist
403 FORBIDDEN 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Error details:
  • Current user is not allowed to see specified user info

Example

curl -i -H "Authorization: Bearer HERE_IS_YOUR_BEARER" https://www.knowi.com/api/1.0/users/10001/groups/

 

Group Details

This endpoint returns all the groups of a given group id
Query

GET /api/1.0/groups/<group_id>

Parameter Comments
group_id Group id of Group to get
withSharing Optional query parameter, value (boolean) true/false. The default value is false. If true, then output will contain list of assets shared into group, and also autoShareUsers field with list of Users which autoShared into this group
Response
HTTP Status Response
200 OK Output example: 
{
  "id":890,
  "groupName":"group1",
  "dashboards":[],
  "charts":[{"accessLevel":1,"name":"An Chart","objectId":26563}],
  "queries":[],
  "datasources":[],
  "autoShareUsers":[{"ssoUser":false,"name":"an user name","externalAuthId":0,"id":10093,"userName":"someEmail1@someHost.com"}]
}
400 BAD_REQUEST 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Missing Authorization header
  • Invalid count of Authorization headers
  • Bearer token missing
401 UNAUTHORIZED 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Bearer token is not found or expired
  • Authorization issue or user does not exist
403 FORBIDDEN 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Error details:
  • Current user is not allowed to see specified group

Example

curl -i -H "Authorization: Bearer HERE_IS_YOUR_BEARER" https://www.knowi.com/1.0/groups/10001?withSharing=true

User Groups

This endpoint returns listing of all the groups which are assigned to a specific user
Query

GET /api/1.0/users/<user_id>/groups/<group_id>

Parameter Comments
user_id User id of User to get specified Group in it
group_id Group id of Group to get info about inside specified User
withSharing Optional query parameter, value (boolean) true/false. The default value is false. If true, then output will contain list of assets shared into group, and also autoShareUsers field with list of Users which autoShared into this group
Response
HTTP Status Response
200 OK Output example: 
{
  "id":890,
  "groupName":"group1",
  "dashboards":[],
  "charts":[{"accessLevel":1,"name":"An Chart","objectId":26563}],
  "queries":[],
  "datasources":[],
  "autoShareUsers":[{"ssoUser":false,"name":"an user name","externalAuthId":0,"id":10093,"userName":"someEmail1@someHost.com"}]
}
400 BAD_REQUEST 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Missing Authorization header
  • Invalid count of Authorization headers
  • Bearer token missing
401 UNAUTHORIZED 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Bearer token is not found or expired
  • Authorization issue or user does not exist
403 FORBIDDEN 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Error details:
  • Current user is not allowed to see specified group

Example

curl -i -H "Authorization: Bearer HERE_IS_YOUR_BEARER" https://www.knowi.com/api/1.0/users/10001/groups/90002?withSharing=true

 

Creating Group

This endpoint is for creating a new group
Query

POST /api/1.0/groups/

Parameter Comments
groupName Group name of new group
Response
HTTP Status Response
200 OK Return created group json info (same as "Get group" command). Output example: 
{
  "id":890,
  "groupName":"group1"
}
400 BAD_REQUEST 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Missing Authorization header
  • Invalid count of Authorization headers
  • Bearer token missing
  • Error details:
  • Missed groupName field
  • Common error creating user group - more details at server log
401 UNAUTHORIZED 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Bearer token is not found or expired
  • Authorization issue or user does not exist

Example

curl -i -H "Authorization: Bearer HERE_IS_YOUR_BEARER" -d "groupname=newGroupName1" https://www.knowi.com/api/1.0/groups

 

Create a Group with User

This endpoint is for creating a group with a user of a given user id
Query

POST /api/1.0/users/<user_id>/groups/

Parameter Comments
user_id The user id of User to create Group in it
groupName Group name of new group
Response
HTTP Status Response
200 OK Return created group json info (same as "Get group" command). Output example: 
{
  "id":890,
  "groupName":"group1"
}
400 BAD_REQUEST 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Missing Authorization header
  • Invalid count of Authorization headers
  • Bearer token missing
  • Error details:
  • Missed groupName field
  • Common error creating user group - more details at server log
401 UNAUTHORIZED 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Bearer token is not found or expired
  • Authorization issue or user does not exist
403 FORBIDDEN 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Error details:
  • Current user is not allowed to edit specified user info

Example

curl -i -H "Authorization: Bearer HERE_IS_YOUR_BEARER" -d "groupname=newGroupName1" https://www.knowi.com/api/1.0/users/10001/groups

 

Deleting Group

This endpoint is for deleting a specific group of a given group id
Query

DELETE /api/1.0/groups/<group_id>

Parameter Comments
group_id Group id of Group to delete
Response
HTTP Status Response
200 OK No response body
400 BAD_REQUEST 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Missing Authorization header
  • Invalid count of Authorization headers
  • Bearer token missing
  • Error details:
  • Failed to remove group - more details at server log
401 UNAUTHORIZED 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Bearer token is not found or expired
  • Authorization issue or user does not exist
403 FORBIDDEN 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Error details:
  • Current user is not allowed to delete specified group

Example

curl -i -H "Authorization: Bearer HERE_IS_YOUR_BEARER" -X DELETE https://www.knowi.com/api/1.0/groups/895

 

Delete Group of specified User

This endpoint is for deleting a group that is assigned to a user
Query

DELETE /api/1.0/users/<user_id>/groups/<group_id>

Parameter Comments
user_id The user id of User to delete Group in it
group_id Group id of Group to delete
Response
HTTP Status Response
200 OK No response body
400 BAD_REQUEST 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Missing Authorization header
  • Invalid count of Authorization headers
  • Bearer token missing
  • Error details:
  • Failed to remove group - more details at server log
401 UNAUTHORIZED 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Bearer token is not found or expired
  • Authorization issue or user does not exist
403 FORBIDDEN 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Error details:
  • Current user is not allowed to delete specified group

Example

curl -i -H "Authorization: Bearer HERE_IS_YOUR_BEARER" -X DELETE https://www.knowi.com/api/1.0/users/10001/groups/895

 

Edit Group

This endpoint is for deleting a group of a given group id
Query

PUT /api/1.0/groups/<group_id>

Parameter Comments
group_id Group id of Group to edit
groupName New group name of Group
Response
HTTP Status Response
200 OK Return updated group json info (same as "Get group" command). Output example: 
{
  "id":890,
  "groupName":"group1"
}
400 BAD_REQUEST 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Missing Authorization header
  • Invalid count of Authorization headers
  • Bearer token missing
  • Error details:
  • Missed groupName field
  • Failed to edit group - details saved at server log
401 UNAUTHORIZED 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Bearer token is not found or expired
  • Authorization issue or user does not exist
403 FORBIDDEN 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Error details:
  • Current user is not allowed to edit specified group

Example

curl -i -H "Authorization: Bearer HERE_IS_YOUR_BEARER" -X PUT -d "groupName=updatedGroupName1" https://www.knowi.com/api/1.0/groups/897

 

Edit Group of selected User

This endpoint is for upading/modifying a group of the selected user of a given group id
Query

PUT /api/1.0/users/<user_id>/groups/<group_id>

Parameter Comments
user_id User id where edit the Group
group_id Group id of Group to edit
groupName New group name of Group
Response
HTTP Status Response
200 OK Return updated group json info (same as "Get group" command). Output example: 
{
  "id":890,
  "groupName":"group1"
}
400 BAD_REQUEST 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Missing Authorization header
  • Invalid count of Authorization headers
  • Bearer token missing
  • Error details:
  • Missed groupName field
  • Failed to edit group - details saved at server log
401 UNAUTHORIZED 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Common error details:
  • Bearer token is not found or expired
  • Authorization issue or user does not exist
403 FORBIDDEN 
{ "message": <Error details>, "documentation_url": <Documentation link> }

Error details:
  • Current user is not allowed to edit specified group

Example

curl -i -H "Authorization: Bearer HERE_IS_YOUR_BEARER" -X PUT -d "groupName=updatedGroupName1" https://www.knowi.com/api/1.0/users/10001/groups/897
Was this article helpful?
0 out of 0 found this helpful
Return to top

Related articles