# Returns all relevant Aspects for a given task.

This endpoint returns all relevant Aspects for a given task.

: This endpoint is in the alpha stage and its structure may change.


Endpoint: POST /tasks/aspects/compute
Version: 0.9.0
Security: BearerAuthentication

## Request fields (application/json):

  - `tenantId` (string, required)
    The identifier of the tenant where the target task, specified in the taskDefinition, will be stored or searched for. If not provided the domain's default tenant will be used. Ensure that the API user has the necessary permissions on the target tenant to create or update a task. If not, an [error-response](http://localhost:60000/documentation#tag/error_response_model) of type  will be returned.
    Example: "product_123"

  - `taskDefinition` (object, required)

  - `taskDefinition.id` (string, required)
    The task ID. This field should contain the task identifier used in the client's system.
    Example: "your_id_as_string"

  - `taskDefinition.problemStatement` (string, required)
    The problem statement of the task.
    Example: "When was the Battle of Waterloo?"

  - `taskDefinition.type` (string, required)
    Defines the type of the task. Can be used by deserialization tools to instantiate the correct sub-type.
    Enum: "FREEFORM_TEXT", "IN_TEXT_FILL_IN_BLANKS", "IN_TEXT_CHOICES", "MULTIPLE_CHOICE", "MULTIPLE_RESPONSES"

  - `taskDefinition.title` (string)
    The task title. If left blank, the  will be used as the title during implicit task creation or update.
    Example: "my_task_title"

  - `taskDefinition.language` (string)
    The task language.
    Enum: "DE_CH", "DE_DE", "EN_US", "EN_UK", "FR_FR", "IT_IT", "ES_ES"

## Response 200 fields (application/json):

  - `name` (string, required)
    The Aspect name.
    Example: "Present 3rd person singular of regular verbs."

  - `description` (string, required)
    The Aspect description.
    Example: "A learner can correctly form the present 3rd person singular of regular verbs."

  - `type` (string, required)
    Indicates whether an Aspect represents a misconception (wrong aspect) or a concept (correct aspect).
    Enum: "CONCEPT", "MISCONCEPTION"

  - `aspectGroup` (object)
    The group to which the Aspect belongs.

  - `aspectGroup.name` (string, required)
    The name of the Aspect group.
    Example: "Grammar"

  - `aspectGroup.description` (string)
    The description of the Aspect group.
    Example: "Grammatical concepts, such as conjugation, tenses, and conditionals."

## Response 400 fields (application/json):

  - `message` (string, required)
    Contains more detailed information about the root cause of the problem.
    Example: "The user associated with the provided bearer token is not authorized."

  - `type` (string, required)
    Possible errors the API may return. For more details, refer to the [error table](#section/Error-Types).
    Enum: "REQUEST_SCHEMA_MALFORMED", "INVALID_TOKEN", "MISSING_PERMISSIONS", "INVALID_PARAMETER", "WRONG_TASK_TYPE_FOR_UPSERT", "INTERNAL"

## Response 500 fields (application/json):

  - `message` (string, required)
    Contains more detailed information about the root cause of the problem.
    Example: "An error occurred while processing your request. It has been logged with the ID 2b6b2818cc22fc4b."

  - `type` (string, required)
    Possible errors the API may return. For more details, refer to the [error table](#section/Error-Types).
    Enum: "REQUEST_SCHEMA_MALFORMED", "INVALID_TOKEN", "MISSING_PERMISSIONS", "INVALID_PARAMETER", "WRONG_TASK_TYPE_FOR_UPSERT", "INTERNAL"