Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

Table of Contents
Panel
panelIconIdatlassian-info
titlepanelIcon:info:
bgColor#EAE6FF

API Authentication

All URL endpoints should be utilized as part of a cURL authentication command. For more information, please review CommCare's API Authentication Documentationhttps://dimagi.atlassian.net/wiki/x/LwXKfw.

List Groups

URL: https://www.commcarehq.org/a/[domain]/api/[version]/group/

Input parameters:

Name

Description

Example

Format

Return data format (optional)
Supported: json (default), xml

format=xml

Sample output:

Code Block
languagejavascriptjs
{
  "meta": {
 	"limit": 20, 
	 "next": null, 
	 "offset": 0, 
	 "previous": null, 
	 "total_count": 3
 }, 
 "objects": [
 	{
    	 "case_sharing": false, 
		 "domain": "cloudcaredemo", 
		 "id": "1eb59d6938fc7e510254d8c2f63d944f", 
		 "metadata": {}, 
		 "name": "Wozzle", 
		 "path": [], 
		 "reporting": true, 
		 "users": ["91da6b1c78699adfb8679b741caf9f00", "8a642f722c9e617eeed29290e409fcd5"]
	 }, 
	 ...
   ]
}


Bulk API

URLhttps://www.commcarehq.org/a/[domain]/api/[version]/group/

Supported Methods:

Method

Description

POST

Create group

PATCH

Create multiple groups


Input Parameters:

Name 

Name 

Description 

Description 

Example 

Example 

name*

Group name

Wozzle 

Wozzle 

case_sharing

Whether users within this group will share cases with other members of this group

true/false (default=false)

reporting

Whether this group's name will appear in the group filter list for reports

true/false (default=true)

users

List of all users ids belonging to the group 

(see examples)

This is optional to specify.

metadata 

Any additional custom data associated with the group 

(see examples) 

This is optional to specify.

Output Parameters:

Name 

Name 

Description 

Description 

Example 

Example 

id

Group UUID

3c5a623af057e23a32ae4000cf291339 

3c5a623af057e23a32ae4000cf291339 

Sample input:

Single Group:

JSON Input

Code Block
languagejavascriptjs
titleJSON Input
{
 "case_sharing": false,
 "metadata": {
  "localization": "Ghana"
 },
 "name": "Wozzle",
 "reporting": true,
 "users": [
  "91da6b1c78699adfb8679b741caf9f00",
  "8a642f722c9e617eeed29290e409fcd5"
 ]
}


Multiple Groups (can include all other information from single group creation):

JSON Input

Code Block
languagejavascriptjs
titleJSON Input
{
 "objects": [
  {
   "case_sharing": false, 
   "name": "Test 1", 
   "reporting": true
  },
  {
   "case_sharing": true, 
   "name": "Test 2", 
   "reporting": true
  }
 ]
}

Individual API

URL: https://www.commcarehq.org/a/[domain]/api/[version]/group/[group id]

Supported Methods:

Method

Description

GET

Get group

PUT

Edit group

DELETE

Delete group

Input Parameters: 

Name 

Name 

Description 

Description 

Example 

Example 

name

Group name

Wozzle 

Wozzle 

case_sharing

Whether users within this group will share cases with other members of this group

true/false

reporting

Whether this group's name will appear in the group filter list for reports

true/

false  

false  

users

List of all users ids belonging to the group 

(see examples)

This will replace any existing users for the group.

metadata 

Any additional custom data associated with the group 

(see examples) 
This will replace any existing custom data for the group.

 Sample input:

JSON Input

Code Block
languagejavascript
titleJSON Input
js
{
 "case_sharing": false,
 "metadata": {
  "localization": "Ghana"
 },
 "name": "Wozzle",
 "reporting": true,
 "users": [
  "91da6b1c78699adfb8679b741caf9f00",
  "8a642f722c9e617eeed29290e409fcd5"
 ]
}

...