Skip to main content

Organization Widget

Method & Permission​

APIGETPOSTPUTPATCHDELETE
Organization Widget ListAdmin, MemberAdmin---
Organization Widget DetailAdmin, Member--Admin *Admin

*Can only change is_archivedfield.

GET Organization Widget List​

Endpoint: /organizations/organizationwidget/list/{level}/{sid}/{serializer}/

Parameter: level (path, string)​

organization

Parameter: sid (path, string)​

organization sid

Parameter: serializer (path, string)​

Parameter: token (header, string)​

Response: 200​

# serializer = name
{
"page_size": 10,
"page_number": 1,
"page_count": 9,
"count": 81,
"next": "xxx",
"previous": null,
"add_permission": true,
"results": [
{
"sid": "ehkn0a40x1glqvAFKP",
"name": "Plain Text"
},
...
]
}

# serializer = list
{
"page_size": 10,
"page_number": 1,
"page_count": 9,
"count": 81,
"next": "xxx",
"previous": null,
"add_permission": true,
"results": [
{
"sid": "xxx",
"is_archived": false,
"change_permission": true
},
...
]
}

# serializer = detail
{
"page_size": 10,
"page_number": 1,
"page_count": 9,
"count": 81,
"next": "xxx",
"previous": null,
"add_permission": true,
"results": [
{
"sid": "xx",
"is_archived": false,
"updated_by": "xxx",
"date_updated": "2020-02-10T03:02:28.525127Z",
"date_created": "2020-02-10T03:02:28.523525Z",
"change_permission": true
},
...
]
}

POST Organization Widget List​

Endpoint: /organizations/organizationwidget/list/{level}/{sid}/{serializer}/

Parameter: level (path, string)​

organization

Parameter: sid (path, string)​

organization sid

Parameter: serializer (path, string)​

Parameter: token (header, string)​

Parameter: widget (body, object)​

Response: 201​

{
"sid": "xx",
"is_archived": false,
"updated_by": "xxx",
"date_updated": "2020-02-10T03:02:28.525127Z",
"date_created": "2020-02-10T03:02:28.523525Z",
"change_permission": true
}

Response: 406​

- Error: Invaid widget sid!
- Error: the widget is not available for your organization!

GET Organization Widget Detail​

Endpoint: /organizations/organizationwidget/detail/{sid}/

Parameter: sid (path, string)​

Parameter: token (header, string)​

Response: 200​

{
"sid": "xx",
"is_archived": false,
"updated_by": "xxx",
"date_updated": "2020-02-10T03:02:28.525127Z",
"date_created": "2020-02-10T03:02:28.523525Z",
"change_permission": true
}

DELETE Organization Widget Detail​

Endpoint: /organizations/organizationwidget/detail/{sid}/

Parameter: sid (path, string)​

Parameter: token (header, string)​

Response: 204​

{}