Search latest survey history (drafts + published, or archived)

POST

/surveys/history/search

Surveys

Search, filter, and sort the workspace's survey history at version=0 (the LATEST snapshot pointer). Unlike /surveys/search — which only matches PUBLISHED surveys — this endpoint includes DRAFT entries, so in-progress surveys are discoverable. By default archived surveys are excluded (matching /surveys/history); set archived: true in the body to list/search ONLY archived surveys (stage = ARCHIVED) instead.

Request

Body Params application/json

Examples

Responses

🟢200OK

application/json

Survey history matching search criteria

Bodyapplication/json

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

{
    "items": [
        {
            "version": 0,
            "stage": "DRAFT",
            "actorId": "string",
            "actorType": "user",
            "surveyId": "string",
            "title": "string",
            "defaultLang": "en",
            "langs": [
                "en"
            ],
            "origin": "CATALOG",
            "background": "string",
            "textColor": "string",
            "boxColor": "string",
            "backgroundImage": "http://example.com",
            "backgroundSize": "cover",
            "backgroundPosition": "center",
            "fontFamily": "string",
            "contentJustify": "start",
            "parentId": "string",
            "parentType": "learningPath",
            "definition": {
                "property1": "string",
                "property2": "string"
            },
            "accountId": "stringstri",
            "workspaceId": "stringstri",
            "sourceRegion": "us-east-1",
            "createdAt": "2019-08-24T14:15:22.123Z",
            "updatedAt": "2019-08-24T14:15:22.123Z",
            "latestVersion": 1,
            "tags": [
                {
                    "tagId": "string",
                    "priority": 0,
                    "createdAt": "2019-08-24T14:15:22.123Z",
                    "updatedAt": "2019-08-24T14:15:22.123Z"
                }
            ]
        }
    ],
    "nextToken": "eyJwayI6IndvcmtzcGFjZUlkI3pPR0JndVctQWoiLCJxdWl6SWQiOiItRktBdDZfbXM4M3RvSUZaLWVjeFQifQ=="
}

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

Get survey log

List audit logs