Member
Questi contenuti non sono ancora disponibili nella tua lingua.
Manage members, which represent relationships between users, groups, and entities.
You can create, update, delete, and search for members with advanced filtering and pagination.
- Version
- 2.0.0
- OpenAPI version
- 3.0.0
Operations
Sezione intitolata “Operations” POST /v2/member/index
Returns a paginated and filterable list of members.
Use POST to allow complex filters via JSON payload.
Request Body
Sezione intitolata “Request Body ”Parameters for searching members
object
object
The unique identifier of the member.
The unique identifier of the parent entity.
The unique identifier of the child entity.
The username of the member.
The timestamp when the user was created.
The email address of the member.
The status of the user (active, inactive, etc.).
The name of the group the member belongs to.
A description of the group, if available.
The status of the group (active, inactive, etc.).
The timestamp when the group was created.
The field of the model to sort the list for, use a minus to revert the sort. Es -name is to require the sort in reverse order
The field establishes whether to also include historized elements that are no longer active in the results. If you leave this parameter empty the response returns only actual entries.
Example
{ "filter": { "username": "john.doe" }, "per-page": 10, "page": 1, "sort": "username"}Responses
Sezione intitolata “ Responses ”List of members
object
The unique identifier of the member.
The unique identifier of the parent entity.
The unique identifier of the child entity.
The username of the member.
The timestamp when the user was created.
The email address of the member.
The status of the user (active, inactive, etc.).
The name of the group the member belongs to.
A description of the group, if available.
The status of the group (active, inactive, etc.).
The timestamp when the group was created.
Example
{ "member_id": "mem-1", "parent_id": "grp-1", "child_id": "usr-1", "username": "john.doe", "email": "john.doe@example.com", "group_name": "Admins", "user_status": "active", "group_status": "active", "user_created_at": 1700000000, "group_created_at": 1700000000}Headers
Sezione intitolata “Headers ”Current page
Total number of pages
Number of items per page
Total number of items
POST /v2/member/create
Create a new member by providing the required details.
Request Body required
Sezione intitolata “Request Body required ”Member object to be created
object
Example
{ "parent_id": "grp-2", "child_id": "usr-2"}Responses
Sezione intitolata “ Responses ”Member created successfully
object
Example
{ "member_id": "mem-2", "parent_id": "grp-2", "child_id": "usr-2"} GET /v2/member/view/{id}
Retrieve a member by its unique ID.
Path Parameters
Sezione intitolata “Path Parameters ”ID of the member to retrieve
Responses
Sezione intitolata “ Responses ”Member found
object
The unique identifier of the member.
The unique identifier of the parent entity.
The unique identifier of the child entity.
The username of the member.
The timestamp when the user was created.
The email address of the member.
The status of the user (active, inactive, etc.).
The name of the group the member belongs to.
A description of the group, if available.
The status of the group (active, inactive, etc.).
The timestamp when the group was created.
Example
{ "member_id": "mem-1", "parent_id": "grp-1", "child_id": "usr-1", "username": "john.doe", "email": "john.doe@example.com", "group_name": "Admins", "user_status": "active", "group_status": "active", "user_created_at": 1700000000, "group_created_at": 1700000000}Member not found
DELETE /v2/member/delete/{id}
Delete a member by its unique ID.
If force=true, all related entities will also be deleted.
Path Parameters
Sezione intitolata “Path Parameters ”ID of the member to delete
Query Parameters
Sezione intitolata “Query Parameters ”Force the deletion of the entity and all related entities
Responses
Sezione intitolata “ Responses ”Member deleted successfully
If force=false, the operation is interrupted and the list of connected entities that will be deleted in case of confirmation (force=true) is returned
PUT /v2/member/update/{id}
Update an existing member by its unique ID.
Path Parameters
Sezione intitolata “Path Parameters ”ID of the member to update
Request Body required
Sezione intitolata “Request Body required ”Member object with updated data
object
Example
{ "group_name": "Updated Group", "user_status": "inactive"}Responses
Sezione intitolata “ Responses ”Member updated successfully
object
Example
{ "member_id": "mem-1", "group_name": "Updated Group", "user_status": "inactive"}Member not found