Update a Person.

//native

type Personio = {

	clientId: string

	clientSecret: string

}

/**

 * Update a Person.

 * - This endpoint enables the update of a Person resource.

- The endpoint requires the personio:persons:write scope.

 */

export async function main(

	auth: Personio,

	person_id: string,

	body: {

		email?: string

		first_name?: string

		preferred_name?: string

		last_name?: string

		gender?: 'MALE' | 'FEMALE' | 'DIVERSE' | 'UNKNOWN' | 'UNDEFINED'

		language_code?: 'en' | 'de' | 'es' | 'fr' | 'nl' | 'it' | 'sv' | 'fi'

		custom_attributes?: { id?: string; value?: string | string[] }[]

	}

) {

	const url = new URL(`https://api.personio.de/v2/persons/${person_id}`)

	const response = await fetch(url, {

		method: 'PATCH',

		headers: {

			'Content-Type': 'application/json',

			Authorization: 'Bearer ' + (await getOAuthToken(auth, 'https://api.personio.de/oauth2/token'))

		},

		body: JSON.stringify(body)

	})

	if (!response.ok) {

		const text = await response.text()

		throw new Error(`${response.status} ${text}`)

	}

	return await response.text()

}

async function getOAuthToken(auth: Personio, tokenUrl: string): Promise<string> {

	const params = new URLSearchParams({

		grant_type: 'client_credentials',

		client_id: auth.clientId,

		client_secret: auth.clientSecret

	})

	const response = await fetch(tokenUrl, {

		method: 'POST',

		headers: {

			Authorization: 'Basic ' + btoa(`${auth.clientId}:${auth.clientSecret}`),

			'Content-Type': 'application/x-www-form-urlencoded'

		},

		body: params.toString()

	})

	if (!response.ok) {

		const text = await response.text()

		throw new Error(`OAuth token request failed: ${response.status} ${text}`)

	}

	const data = await response.json()

	return data.access_token

}

}