&format=json&action=delete&keyword=


function yourls_api_action_delete() {
    $keyword = isset( $_REQUEST['keyword'] )
        ? yourls_sanitize_keyword( $_REQUEST['keyword'] )
        : '';

    if ( ! $keyword ) {
        return array(
            'status'    => 'fail',
            'message'   => 'Missing required parameter: keyword',
            'errorCode' => '400',
            'simple'    => 'Missing keyword',
        );
    }

    if ( ! yourls_keyword_exists( $keyword ) ) {
        return array(
            'status'    => 'fail',
            'message'   => "Short URL not found: {$keyword}",
            'errorCode' => '404',
            'simple'    => 'Not found',
        );
    }

    $deleted = yourls_delete_link_by_keyword( $keyword );

    if ( $deleted ) {
        return yourls_apply_filter( 'api_result_delete', array(
            'status'     => 'success',
            'message'    => "Short URL deleted: {$keyword}",
            'statusCode' => '200',
            'simple'     => 'deleted',
        ) );
    }

    return array(
        'status'    => 'fail',
        'message'   => "Could not delete: {$keyword}",
        'errorCode' => '500',
        'simple'    => 'delete failed',
    );
}


// ── UPDATE ────────────────────────────────────────────────────────────────────
// Usage:  POST /yourls-api.php
//   signature=&format=json&action=update&keyword=
//   [&url=] [&newkeyword=] [&title=]
//
// Any combination of url / newkeyword / title may be supplied; omitted fields
// keep their current values.

function yourls_api_action_update() {
    $keyword = isset( $_REQUEST['keyword'] )
        ? yourls_sanitize_keyword( $_REQUEST['keyword'] )
        : '';

    if ( ! $keyword ) {
        return array(
            'status'    => 'fail',
            'message'   => 'Missing required parameter: keyword',
            'errorCode' => '400',
            'simple'    => 'Missing keyword',
        );
    }

    // Resolve current values for any fields not supplied
    $current_url   = yourls_get_keyword_longurl( $keyword );
    $current_title = yourls_get_keyword_title( $keyword );

    if ( ! $current_url ) {
        return array(
            'status'    => 'fail',
            'message'   => "Short URL not found: {$keyword}",
            'errorCode' => '404',
            'simple'    => 'Not found',
        );
    }

    $new_url     = isset( $_REQUEST['url'] )
        ? yourls_sanitize_url( $_REQUEST['url'] )
        : $current_url;

    $new_keyword = isset( $_REQUEST['newkeyword'] )
        ? yourls_sanitize_keyword( $_REQUEST['newkeyword'] )
        : $keyword;

    $new_title   = isset( $_REQUEST['title'] )
        ? yourls_sanitize_title( $_REQUEST['title'] )
        : $current_title;

    $result = yourls_edit_link( $new_url, $keyword, $new_keyword, $new_title );

    if ( isset( $result['status'] ) && $result['status'] === 'success' ) {
        return yourls_apply_filter( 'api_result_update', array(
            'status'     => 'success',
            'message'    => 'Short URL updated',
            'statusCode' => '200',
            'shorturl'   => yourls_link( $new_keyword ),
            'simple'     => yourls_link( $new_keyword ),
        ) );
    }

    return array(
        'status'    => 'fail',
        'message'   => isset( $result['message'] ) ? $result['message'] : 'Update failed',
        'errorCode' => '400',
        'simple'    => 'update failed',
    );
}