v6 documentation is incomplete, want to contribute?

VRChat.community

API documentation, SDKs, and more
API Reference
Discord

Get Group Audit Logs

Returns a list of audit logs for a Group.

Requests made through this page are proxied through an intermediary server due to Cross-Origin Resource Sharing restrictions.

GET
/groups/{groupId}/auditLogs

Authorization

auth<token>

Auth Token via Cookie

In: cookie

Path Parameters

groupIdstring

Must be a valid group ID.

Query Parameters

n?integer

The number of objects to return.

Default60
Range1 <= value <= 100
offset?integer

A zero-based offset from the default object sorting from where search results start.

Range0 <= value
startDate?string

The start date of the search range.

Formatdate-time
endDate?string

The end date of the search range.

Formatdate-time
actorIds?string

The comma-separated actor ids to search for.

eventTypes?string

The comma-separated event types to search for.

targetIds?string

The comma-separated target ids to search for.

Response Body

application/json

application/json

application/json

curl -X GET "https://api.vrchat.cloud/api/1/groups/grp_00000000-0000-0000-0000-000000000000/auditLogs?n=60&offset=0&startDate=2019-08-24T14%3A15%3A22Z&endDate=2019-08-24T14%3A15%3A22Z&actorIds=usr_00000000-0000-0000-0000-000000000000%2Cusr_11111111-1111-1111-1111-111111111111&eventTypes=group.member.remove%2Cgroup.instance.kick&targetIds=usr_00000000-0000-0000-0000-000000000000%2Cusr_11111111-1111-1111-1111-111111111111"
{
  "results": [
    {
      "id": "gaud_71a7ff59-112c-4e78-a990-c7cc650776e5",
      "created_at": "2019-08-24T14:15:22Z",
      "groupId": "grp_71a7ff59-112c-4e78-a990-c7cc650776e5",
      "actorId": "usr_c1644b5b-3ca4-45b4-97c6-a2a0de70d469",
      "actorDisplayName": "string",
      "targetId": "string",
      "eventType": "group.role.update",
      "description": "Group role updated",
      "data": {
        "description": {
          "old": "My exciting new group.  It's pretty nifty!",
          "new": "My exciting new group. It's pretty nifty!"
        },
        "joinState": {
          "old": "closed",
          "new": "request"
        }
      }
    }
  ],
  "totalCount": 0,
  "hasNext": true
}

{
  "error": {
    "message": "\"Missing Credentials\"",
    "status_code": 401
  }
}

{
  "error": {
    "message": "Can't find groupǃ",
    "status_code": 404
  }
}