# Create external interview assessment

Create external interview assessment.

## Request

Facts |  
---|---
HTTP URL | https://open.feishu.cn/open-apis/hire/v1/external_interview_assessments
HTTP Method | POST
Rate Limit | [20 per second](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
Supported app types | Custom App
Required scopes<br>**To use this API, you must have at least 1 of the listed scopes.** | Update external application information(hire:external_application)

### Request header

Parameter | Type | Required | Description
---|---|---|---
Authorization | string | Yes | `tenant_access_token`<br>**Value format**: "Bearer `access_token`"<br>**Example value**: "Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[How to choose and get access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | Yes | **Fixed value**: "application/json; charset=utf-8"

### Request body

Parameter | Type | Required | Description
---|---|---|---
external_id | string | No | External system surface evaluation primary key (idempotent only)<br>**Example value**: "123"
username | string | No | Interviewer name<br>**Example value**: "shaojiale"
conclusion | int | No | Interview results<br>**Example value**: 1<br>**Optional values are**:<br>- 1：No pass<br>- 2：Pass<br>- 3：To be determined
assessment_dimension_list | external_interview_assessment_dimension\[\] | No | List of evaluation dimensions
score | int | No | Scoring question score (used when the question type is "scoring question")<br>**Example value**: 99
option | string | No | Radio option (used when the topic type is "single choice")<br>**Example value**: "opt"
options | string\[\] | No | Multiple choice option (used when the question type is "multiple choice question")<br>**Example value**: ["opt"]
content | string | No | Description content (used when the topic type is "description topic")<br>**Example value**: "content"
assessment_type | int | No | Topic Type<br>**Example value**: 1<br>**Optional values are**:<br>- 1：Scoring questions<br>- 2：Single Topic<br>- 3：Description<br>- 4：Multiple choice questions
title | string | No | Title Title<br>**Example value**: "title"
description | string | No | Title Description<br>**Example value**: "desc"
content | string | No | Comprehensive record<br>**Example value**: "hello world"
external_interview_id | string | Yes | External Interview ID<br>**Example value**: "6986199832494934316"

### Request body example
```json
{
    "external_id": "123",
    "username": "shaojiale",
    "conclusion": 1,
    "assessment_dimension_list": [
        {
            "score": 99,
            "option": "opt",
            "options": [
                "opt"
            ],
            "content": "content",
            "assessment_type": 1,
            "title": "title",
            "description": "desc"
        }
    ],
    "content": "hello world",
    "external_interview_id": "6986199832494934316"
}
```

## Response

### Response body

Parameter | Type | Description
---|---|---
code | int | Error codes, fail if not zero
msg | string | Error descriptions
data | \- | \-
external_interview_assessment | external_interview_assessment | External review information
id | string | External Interview ID
username | string | Interviewer name
conclusion | int | Interview results<br>**Optional values are**:<br>- 1：No pass<br>- 2：Pass<br>- 3：To be determined
assessment_dimension_list | external_interview_assessment_dimension\[\] | List of evaluation dimensions
score | int | Scoring question score (used when the question type is "scoring question")
option | string | Radio option (used when the topic type is "single choice")
options | string\[\] | Multiple choice option (used when the question type is "multiple choice question")
content | string | Description content (used when the topic type is "description topic")
assessment_type | int | Topic Type<br>**Optional values are**:<br>- 1：Scoring questions<br>- 2：Single Topic<br>- 3：Description<br>- 4：Multiple choice questions
title | string | Title Title
description | string | Title Description
content | string | Comprehensive record
external_interview_id | string | External Interview ID

### Response body example
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "external_interview_assessment": {
            "id": "6989181065243969836",
            "username": "shaojiale",
            "conclusion": 1,
            "assessment_dimension_list": [
                {
                    "score": 99,
                    "option": "opt",
                    "options": [
                        "opt"
                    ],
                    "content": "content",
                    "assessment_type": 1,
                    "title": "title",
                    "description": "desc"
                }
            ],
            "content": "hello world",
            "external_interview_id": "6986199832494934316"
        }
    }
}
```

### Error code

HTTP status code | Error code | Description | Troubleshooting suggestions
---|---|---|---
500 | 1002001 | System error | Check if the imported parameters are valid
400 | 1002002 | Parameter illegal | Check that the imported parameter format is correct