Bulk Update Questions (Full Sync)

Full sync of all questions: items with id are updated, items without id are created, existing items not in the request are soft-deleted. Also handles reordering via the sort field.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Example

{
    "questions": [
        {
            "id": 1,
            "text": {
                "en": "Updated question?",
                "ar": "سؤال محدث؟"
            },
            "sort": 0,
            "is_active": true,
            "answers": [
                {
                    "id": 10,
                    "text": {
                        "en": "Updated answer",
                        "ar": "إجابة محدثة"
                    },
                    "sort": 0,
                    "skills": [
                        {
                            "skill_id": 1,
                            "value": 5
                        }
                    ]
                },
                {
                    "text": {
                        "en": "New answer",
                        "ar": "إجابة جديدة"
                    },
                    "sort": 1,
                    "skills": [
                        {
                            "skill_id": 2,
                            "value": 3
                        }
                    ]
                }
            ]
        },
        {
            "text": {
                "en": "Brand new question?",
                "ar": "سؤال جديد؟"
            },
            "sort": 1,
            "answers": [
                {
                    "text": {
                        "en": "Option A",
                        "ar": "خيار أ"
                    },
                    "sort": 0,
                    "skills": []
                },
                {
                    "text": {
                        "en": "Option B",
                        "ar": "خيار ب"
                    },
                    "sort": 1,
                    "skills": []
                }
            ]
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.msaaq.com/v1/admin/mi-assistant/questions/bulk' \
--header 'Accept: application/json' \
--header 'X-Tenant: academy.msaaq.com' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "questions": [
        {
            "id": 1,
            "text": {
                "en": "Updated question?",
                "ar": "سؤال محدث؟"
            },
            "sort": 0,
            "is_active": true,
            "answers": [
                {
                    "id": 10,
                    "text": {
                        "en": "Updated answer",
                        "ar": "إجابة محدثة"
                    },
                    "sort": 0,
                    "skills": [
                        {
                            "skill_id": 1,
                            "value": 5
                        }
                    ]
                },
                {
                    "text": {
                        "en": "New answer",
                        "ar": "إجابة جديدة"
                    },
                    "sort": 1,
                    "skills": [
                        {
                            "skill_id": 2,
                            "value": 3
                        }
                    ]
                }
            ]
        },
        {
            "text": {
                "en": "Brand new question?",
                "ar": "سؤال جديد؟"
            },
            "sort": 1,
            "answers": [
                {
                    "text": {
                        "en": "Option A",
                        "ar": "خيار أ"
                    },
                    "sort": 0,
                    "skills": []
                },
                {
                    "text": {
                        "en": "Option B",
                        "ar": "خيار ب"
                    },
                    "sort": 1,
                    "skills": []
                }
            ]
        }
    ]
}'

Responses

🟢200OK

application/json

Questions synced successfully

Body

Example

{
    "data": [
        {
            "id": 0,
            "text": "string",
            "sort": 0,
            "is_active": true,
            "answers": [
                {
                    "id": 0,
                    "text": "string",
                    "sort": 0,
                    "skills": [
                        {
                            "id": 0,
                            "name": "string",
                            "value": 1
                        }
                    ],
                    "created_at": "2019-08-24T14:15:22.123Z",
                    "updated_at": "2019-08-24T14:15:22.123Z"
                }
            ],
            "answers_count": 0,
            "created_at": "2019-08-24T14:15:22.123Z",
            "updated_at": "2019-08-24T14:15:22.123Z"
        }
    ],
    "message": "Successfully saved your changes"
}

🟠422Unprocessable Entity