IDaaS Open Platform
Employee Identity (EIAM)

Delete Job Title

API

# Permissions {/examples/}

The Identity Management API is authorized at the application dimension. Before calling the interface, you need to set interface permissions for different applications. For details, please refer to API Permissions.

Permission Code Description
job_title_all Read and write permissions for the job title management interface
all Read and write permissions for all interfaces

# Request Description {/examples/}

DELETE https://{your_domain}/api/v2/tenant/job-titles/{title_id}

# Request Headers {/examples/}

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 {/examples/}

None

Deletes a job title based on the requested job title ID. Deletion is not allowed when the job title is in use by users.

# Request Parameters {/examples/}

Parameter Name Chinese Name Required Type Description
title_id Job Title ID Yes String The ID of the job title to be deleted

# Response Example

Success Example:
HTTP/1.1 204 No Content

Error Example:
HTTP/1.1 400 Bad Request
{
  "error_msg": "Job title does not exist",
  "error_code": "JOB.TITLE.0001"
}
1
2
3
4
5
6
7
8
9

# Response Parameters

None

# Error Codes

Status Code Error Code Error Message Handling Measures
400 ENT.CONFIG.0031 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.TITLE.0001 Job title does not exist. Please check if the corresponding job title exists.
Job title does not exist
400 JOB.TITLE.0015 The current job title has associated positions and cannot be deleted. Please disassociate the positions linked to this job title before deleting it.
The current job title has an associated position and cannot be deleted
400 JOB.TITLE.0016 The current job title has associated users and cannot be deleted. Please disassociate the users linked to this job title before deleting it.
The current job title has an associated user and cannot be deleted

I understand. Please provide the Markdown content you need translated.

Get Job Title Details by ID