Try out our new RRULE tool for creating RRULE compatible strings.

3.2.12. Participation Status

Parameter Name

PARTSTAT

Purpose

To specify the participation status for the calendar user specified by the property.

Format Definition

This property parameter is defined by the following notation:

 partstatparam    = "PARTSTAT" "="
                   (partstat-event
                  / partstat-todo
                  / partstat-jour)

 partstat-event   = ("NEEDS-ACTION"    ; Event needs action
                  / "ACCEPTED"         ; Event accepted
                  / "DECLINED"         ; Event declined
                  / "TENTATIVE"        ; Event tentatively
                                       ; accepted
                  / "DELEGATED"        ; Event delegated
                  / x-name             ; Experimental status
                  / iana-token)        ; Other IANA-registered
                                       ; status
 ; These are the participation statuses for a "VEVENT".
 ; Default is NEEDS-ACTION.

 partstat-todo    = ("NEEDS-ACTION"    ; To-do needs action
                  / "ACCEPTED"         ; To-do accepted
                  / "DECLINED"         ; To-do declined
                  / "TENTATIVE"        ; To-do tentatively
                                       ; accepted
                  / "DELEGATED"        ; To-do delegated
                  / "COMPLETED"        ; To-do completed
                                       ; COMPLETED property has
                                       ; DATE-TIME completed
                  / "IN-PROCESS"       ; To-do in process of
                                       ; being completed
                  / x-name             ; Experimental status
                  / iana-token)        ; Other IANA-registered
                                       ; status
 ; These are the participation statuses for a "VTODO".
 ; Default is NEEDS-ACTION.

 partstat-jour    = ("NEEDS-ACTION"    ; Journal needs action
                  / "ACCEPTED"         ; Journal accepted
                  / "DECLINED"         ; Journal declined
                  / x-name             ; Experimental status
                  / iana-token)        ; Other IANA-registered
                                       ; status
 ; These are the participation statuses for a "VJOURNAL".
 ; Default is NEEDS-ACTION.

Description

This parameter can be specified on properties with a CAL-ADDRESS value type. The parameter identifies the participation status for the calendar user specified by the property value. The parameter values differ depending on whether they are associated with a group-scheduled "VEVENT", "VTODO", or "VJOURNAL". The values MUST match one of the values allowed for the given calendar component. If not specified on a property that allows this parameter, the default value is NEEDS-ACTION. Applications MUST treat x-name and iana-token values they don't recognize the same way as they would the NEEDS-ACTION value.

Example

 ATTENDEE;PARTSTAT=DECLINED:mailto:jsmith@example.com

This document was automatically converted to XHTML using an RFC to HTML converter with the original text document at the Internet Engineering Task Force web site at ietf.org .  The original text document should be referred to if there are any errors or discrepancies found in this document.

Need to test your iCalendar feeds?

The iCalendar Validator provides developers and testers a method to validate their iCalendar feeds, which can take data from either a URL, file or text snippet and compare it against the RFC 5545 specification.  We believe we have one of the best iCalendar validation tools available on the internet. More information about the validator can be found here.