IDaaS Open Platform
Employee Identity (EIAM)

Add 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 permissions for the job title management API
all Read and write permissions for all APIs

# Request Specification

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

# 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

When adding job title information, the Code must be globally unique.

# Request Parameters

Parameter Chinese Name Required Type Description
name Job Title Name Yes String Job Title Name
code Job Title Code Yes String Job Title Code, must be unique within the system

# Return Example

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

Error Example: 
HTTP/1.1 400 Bad Request 
{ 
    "error_code": "JOB.TITLE.0009", 
    "error_msg": "Job title code already exists" 
}
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 Automatically generated by the system

# Error Codes

Status Code Error Code Error Message Handling 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
The job management function is not enabled, please enable this function first
400 COM.0601 Parameter error, missing parameter or incorrect parameter type Please check if the input parameters comply with the validation rules
Parameter missing or incorrect parameter type
400 JOB.TITLE.0009 Job title code already exists Please modify to another job title code
Job title code already exists

Update Job Title