Skip to content
Hexel StudioDocs

Audit logs

Read the history of changes to a group's members.

On this page

Hexel Studio keeps a history of membership changes for each group in your organization. Use it to see who was added to or removed from a group, and when.

Read a group's history

Bash
curl https://api.hexelstudio.com/v1/groups/<group-id>/audit-logs \
  -H "Authorization: Bearer $ACCESS_TOKEN"

The caller needs an access token for the organization the group belongs to. A group of another organization answers 404, like one that doesn't exist.

The response is an array of entries, newest first. There is no paging: the response holds the group's whole history.

JSON
[
  {
    "id": "<entry-id>",
    "group_id": "<group-id>",
    "action": "MEMBER_REMOVED",
    "target_user_id": "<user-id>",
    "created_at": "2026-10-20T10:15:00Z"
  },
  {
    "id": "<entry-id>",
    "group_id": "<group-id>",
    "action": "MEMBER_ADDED",
    "actor_user_id": "<admin-user-id>",
    "target_user_id": "<user-id>",
    "created_at": "2026-10-18T08:02:00Z"
  }
]
idstring

The entry's ID.

group_idstring

The group the change was made to.

actionstring

MEMBER_ADDED or MEMBER_REMOVED.

actor_user_idstring

Who added the member. Present on MEMBER_ADDED entries.

target_user_idstring

The user who was added or removed.

created_atstring

When the change was made (RFC 3339).

What is recorded

ChangeEntry
A member is added to one of your groups with POST /v1/groups/{group_id}/membersMEMBER_ADDED, with the caller as actor_user_id
A member is removed with DELETE /v1/groups/{group_id}/members/{user_id}MEMBER_REMOVED
Someone joins the organization by being added directlyMEMBER_ADDED on the organization's Default Team group

Changes to member roles are not recorded here. Member roles are backed by groups that Hexel Studio manages, and those groups have no history entries. See Members.

For managing groups and their members, see Groups.