Godot 4 · GDScript · Groups & clans

list_group_requests

Lists join requests, incoming (to review) or outgoing (your own).

Asynchronous (result via signal)

Signature

list_group_requests(direction: String = "incoming", status: String = "pending", limit: int = 50) -> void

What it does

POSTs /groups/requests/list. requests = Array of { id, direction, group_id, group_name, player, status, message, created_at, ... }. Returns [] when there is no active session.

Parameters

Name	Type	Default	Description
direction	String	"incoming"	"incoming" (requests to your group; needs can_review_requests) or "outgoing" (your own requests).
status	String	"pending"	Filter: pending / accepted / declined / cancelled / expired. Any other value is rejected with a 400.
limit	int	50	Max results, clamped to 1-100.

How to call it

Connect group_requests_listed first, then call list_group_requests(). The "incoming" direction needs the can_review_requests permission. Use the returned id with respond_group_request() or cancel_group_request().

Result signal: group_requests_listed(requests: Array)

Example

Gamdato.group_requests_listed.connect(_on_reqs)
Gamdato.list_group_requests("incoming")   # -> group_requests_listed

func _on_reqs(requests: Array) -> void:
    for r in requests:
        print("%s wants to join" % r.player.player_name)

Use cases

Show leaders the pending applications to review.
Let a player track the status of requests they sent.

Справочник функций