Create Question

Production

https://api.msaaq.com/v1

POST

/admin/mi-assistant/questions

Last modified:2026-02-08 17:55:15

Create a question. Optionally include answers with skills.

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

{
    "text": {
        "en": "How do you handle challenges?",
        "ar": "كيف تتعامل مع التحديات؟"
    },
    "is_active": true,
    "answers": [
        {
            "text": {
                "en": "I lead the team",
                "ar": "أقود الفريق"
            },
            "skills": [
                {
                    "skill_id": 1,
                    "value": 5
                }
            ]
        },
        {
            "text": {
                "en": "I find creative solutions",
                "ar": "أبحث عن حل إبداعي"
            },
            "skills": [
                {
                    "skill_id": 3,
                    "value": 5
                }
            ]
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.msaaq.com/v1/admin/mi-assistant/questions' \
--header 'Accept: application/json' \
--header 'X-Tenant: academy.msaaq.com' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "text": {
        "en": "How do you handle challenges?",
        "ar": "كيف تتعامل مع التحديات؟"
    },
    "is_active": true,
    "answers": [
        {
            "text": {
                "en": "I lead the team",
                "ar": "أقود الفريق"
            },
            "skills": [
                {
                    "skill_id": 1,
                    "value": 5
                }
            ]
        },
        {
            "text": {
                "en": "I find creative solutions",
                "ar": "أبحث عن حل إبداعي"
            },
            "skills": [
                {
                    "skill_id": 3,
                    "value": 5
                }
            ]
        }
    ]
}'

Responses

🟢201Created

application/json

Question created

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"
    }
}

🟠422Unprocessable Entity

Modified at 2026-02-08 17:55:15

List Questions

Bulk Create Questions