WP_REST_Application_Passwords_Controller::create_item( WP_REST_Request $request ): WP_REST_Response|WP_Error

In this article

Creates an application password.

Parameters

$requestWP_REST_Requestrequired
Full details about the request.

Return

WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.

Source

public function create_item( $request ) {
	$user = $this->get_user( $request );

	if ( is_wp_error( $user ) ) {
		return $user;
	}

	$prepared = $this->prepare_item_for_database( $request );

	if ( is_wp_error( $prepared ) ) {
		return $prepared;
	}

	$created = WP_Application_Passwords::create_new_application_password( $user->ID, wp_slash( (array) $prepared ) );

	if ( is_wp_error( $created ) ) {
		return $created;
	}

	$password = $created[0];
	$item     = WP_Application_Passwords::get_user_application_password( $user->ID, $created[1]['uuid'] );

	$item['new_password'] = WP_Application_Passwords::chunk_password( $password );
	$fields_update        = $this->update_additional_fields_for_object( $item, $request );

	if ( is_wp_error( $fields_update ) ) {
		return $fields_update;
	}

	/**
	 * Fires after a single application password is completely created or updated via the REST API.
	 *
	 * @since 5.6.0
	 *
	 * @param array           $item     Inserted or updated password item.
	 * @param WP_REST_Request $request  Request object.
	 * @param bool            $creating True when creating an application password, false when updating.
	 */
	do_action( 'rest_after_insert_application_password', $item, $request, true );

	$request->set_param( 'context', 'edit' );
	$response = $this->prepare_item_for_response( $item, $request );

	$response->set_status( 201 );
	$response->header( 'Location', $response->get_links()['self'][0]['href'] );

	return $response;
}

Hooks

do_action( ‘rest_after_insert_application_password’, array $item, WP_REST_Request $request, bool $creating )

Fires after a single application password is completely created or updated via the REST API.

Changelog

VersionDescription
5.6.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.