Skip to contents

Update waiting list entry status

Source: R/waitlist.R
update_waitlist_status.Rd

Move an artist application through the review workflow. Status transitions track the application lifecycle from initial submission to account creation. Call this function as you progress applications through the admin review process. The typical flow: pending → reviewing → invited → converted.

Usage

update_waitlist_status(waitlist_id, status, invited_at = NULL, cn = NULL)

Arguments

waitlist_id

Character string. UUID of the waiting list entry (format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Obtained from create_waitlist_entry() or get_pending_waitlist().

status

Character string. New status value. Must be one of:

  • "pending": Initial state, awaiting review

  • "reviewing": Under active consideration by admins

  • "invited": Approved, invitation sent to artist

  • "converted": Full user account created

  • "rejected": Application declined

invited_at

POSIXct or NULL. Timestamp when invitation was sent. Auto-set to Sys.time() when status = "invited". Manually set only for backdating corrections.

cn

DBI connection object or NULL. Database connection from artcore::dbc("artsite"). If NULL (default), creates and closes connection automatically. Pass existing connection for batch status updates.

Value

Logical. TRUE if update succeeded (1+ rows affected), FALSE if entry not found (0 rows affected). Check return value in batch operations to detect missing entries.

See also

Other waitlist: convert_waitlist_to_user(), create_waitlist_entry(), get_pending_waitlist(), get_waitlist_entry(), waitlist

Examples

if (FALSE) { # \dontrun{
# Move an application to review
update_waitlist_status(waitlist_id, status = "reviewing")

# Approve and invite the artist
update_waitlist_status(waitlist_id, status = "invited")

# Or decline the application
update_waitlist_status(waitlist_id, status = "rejected")
} # }