IDaaS Open Platform
Employee Identity (EIAM)

Update Job Title

API

# Permissions

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

Permission Code Description
job_title_all Read and write permission for the job title management API
all Read and write permission for all APIs

# Request Specification

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

# Request Headers

Parameter 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

{
    "name": "Senior Engineer",
    "code": "Senior_Engineer"
}
1
2
3
4

Updates the job title information based on the requested job title ID parameter.

# Request Parameters

Parameter Chinese Name Required Type Description
title_id Job Title ID Yes String The ID of the job title to be modified
name Job Title Name Yes String Job title name
code Job Title Code Yes String Job title code, unique within the system

# Return Example

Success Example:
HTTP/1.1 200 OK
Content-Type: application/json
{
  "title_id": "20201028102749564-9082-DC8CD2722"
}

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
10
11
12
13

# Return Parameters

Parameter Name Chinese Name Type Description
title_id Job Title ID String

# Error Codes

Status Code Error Code Error Message Action
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
400 COM.0601 Parameter error, missing parameter or incorrect parameter type Please check if the input parameters comply with the validation rules
400 JOB.TITLE.0001 Job title does not exist Please check if the corresponding job title exists
400 JOB.TITLE.0009 Job title code already exists Please modify to a different job title code

I am ready to receive the Markdown content for translation. Please paste it.

Delete Job Title