Update Job Position

Permissions

The Identity Management API authorizes access 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_position_all	Read and write permissions for job position management API
all	Read and write permissions for all APIs

Request Description

PUT 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

{
    "org_code": "10000",
    "name": "IDaaS Java Developer",
    "code": "IDaaS_Java_Developer",
    "title_code": "Senior_Engineer"
}

Updates the job position information based on the requested position ID parameter. The organization of a position cannot be updated if the position is associated with users.

Request Parameters

Parameter Name	Chinese Name	Required	Type	Description
position_id	Position ID	Yes	String	The ID of the position to be modified
org_code	Organization Code	Yes	String
name	Position Name	Yes	String	Position Name
code	Position Code	Yes	String	Position Code, unique within the system
title_code	Title Code	No	String	Associated title code, can be empty

Return Example

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

Error Example:
HTTP/1.1 400 Bad Request
{
  "error_msg": "Position does not exist",
  "error_code": "JOB.POSITION.0001"
}

Return Parameters

Parameter Name	Chinese Name	Type	Description
position_id	Position ID	String

Error Codes

Status Code	Error Code	Error Message	Handling Measure
400	ENT.CONFIG.0031	The position management function is not enabled. Please enable this function first.	Please enable position 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.POSITION.0001	Position does not exist.	Please check if the corresponding position exists.
		Position does not exist
400	JOB.POSITION.0009	Position code already exists.	Please modify to a different position code.
		Position code already exists
400	JOB.POSITION.0016	The current position has associated users; the belonging organization cannot be modified.	Please first disassociate the users linked to this position, then modify the position.
		The current position is associated with a user who cannot modify the organization they belong to
400	ORG.0001	Organization does not exist.	Please check if the corresponding organization exists.
		Organization does not exist
400	JOB.TITLE.0001	Job title does not exist.	Please check if the corresponding job title exists.
		Job title does not exist

Please provide the Markdown content you would like me to translate.