Employee Identity (EIAM)
Delete Job Position
API
# Permissions
The Identity Management API is authorized at the application level. Before calling the interface, you need to set API permissions for different applications. For details, please refer to API Permissions.
| Permission Code | Description |
|---|---|
| job_position_all | Read and write permission for the job position management interface |
| all | Read and write permission for all interfaces |
# Request Specification
DELETE https://{your_domain}/api/v2/tenant/job-positions/{position_id}
# Request Headers
| Parameter Name | Chinese Name | Required | Type | Description |
|---|---|---|---|---|
| Authorization | Authorization | Yes | String | Format: Bearer {access_token} |
| Content-Type | Content Type | Yes | String | Fixed value: application/json; charset=utf-8 |
# Request Example
None
Deletes a job position based on the requested position ID. Deletion is not allowed if the position is in use by users.
# Request Parameters
| Parameter Name | Chinese Name | Required | Type | Description |
|---|---|---|---|---|
| position_id | Position ID | Yes | String | Job Position ID |
# Return Example
Success Example:
HTTP/1.1 204 No Content
Error Example:
HTTP/1.1 400 Bad Request
{
"error_msg": "Position does not exist",
"error_code": "JOB.POSITION.0001"
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
# Return Parameters
None
# Error Codes
| Status Code | Error Code | Error Message | Handling Measure |
|---|---|---|---|
| 400 | ENT.CONFIG.0031 | The job management function is not enabled, please enable this function first | Please enable job management in the Enterprise Center first |
| The job management function is not enabled, please enable this function first | |||
| 400 | JOB.POSITION.0001 | Position does not exist | Please check if the corresponding position exists |
| Position does not exist | |||
| 400 | JOB.POSITION.0017 | The current position has associated users and cannot be deleted | Please disassociate users linked to this position before deleting it |
| The current position has associated users and cannot be deleted |
Please provide the Markdown content you would like me to translate.