Search leaderboard instance history (active, or archived)

POST

/runtime-leaderboards/history/search

RuntimeLeaderboards

Search, filter, and sort the workspace's leaderboard instance history at version=0 (the LATEST snapshot pointer). Unlike GET /runtime-leaderboards — which reads the main table and therefore only ever sees live instances — this reads runtime_leaderboard_history, so with archived: true it surfaces ARCHIVED instances, which no longer exist on the main table at all. That makes it the only workspace-wide way to list archived instances and offer a restore action; for a single board, GET /runtime-leaderboard-configurations/{id}/instances/archived answers the same question straight off DynamoDB. Note: free-text match is not available here (instances carry no text column of their own — titles live on the configuration) — use structured filters (state, periodId, configuration id, timeframe) and sort.

Request

Body Params application/json

Examples

Responses

🟢200OK

application/json

Leaderboard instance history matching search criteria

Bodyapplication/json

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.aworld.cloud/dashboard/v1/runtime-leaderboards/history/search' \
--header 'Content-Type: application/json' \
--data '{
    "filter": {
        "==": [
            {
                "var": "fieldName"
            },
            "value"
        ]
    },
    "sort": {
        "field": "createdAt",
        "order": "asc"
    },
    "limit": 20,
    "nextToken": "string",
    "archived": true
}'

Response Example

{
    "items": [
        {
            "version": 0,
            "stage": "DRAFT",
            "actorId": "string",
            "actorType": "user",
            "runtimeLeaderboardId": "string",
            "runtimeLeaderboardConfigurationId": "string",
            "periodId": "string",
            "timeframeType": "PERMANENT",
            "timeframeTimezoneType": "FIXED",
            "timeframeTimezone": "UTC",
            "timeframeStartsAt": "2019-08-24T14:15:22.123Z",
            "timeframeEndsAt": "2019-08-24T14:15:22.123Z",
            "state": "PENDING",
            "recurrence": "DAILY",
            "accountId": "stringstri",
            "workspaceId": "stringstri",
            "sourceRegion": "us-east-1",
            "createdAt": "2019-08-24T14:15:22.123Z",
            "updatedAt": "2019-08-24T14:15:22.123Z",
            "latestVersion": 1
        }
    ],
    "nextToken": "eyJwayI6IndvcmtzcGFjZUlkI3pPR0JndVctQWoiLCJxdWl6SWQiOiItRktBdDZfbXM4M3RvSUZaLWVjeFQifQ=="
}

Modified at 2026-10-09 12:43:10

Search badge logs

List assignment rules