Skip to main content
PUT
Update a trip participant

Authorizations

Authorization
string
header
required

Passport bearer token authentication for legacy admin sessions.

Path Parameters

tripId
integer
required

Trip ID belonging to the authenticated organization.

id
integer
required

Record ID within the organization and any parent resource in this route.

Body

application/json

Request fields accepted by this operation. Omitted optional properties retain the behavior described above.

individual_goal
number

Validation: numeric|min:0|max:999999999.99.

Required range: 0 <= x <= 999999999.99
Example:

40

role
enum<string>

Validation: in:participant,leader.

Available options:
participant,
leader
Example:

"participant"

is_minor
boolean

Validation: boolean.

Example:

false

guardian_name
string | null

Validation: nullable|string|max:255.

Maximum string length: 255
guardian_email
string<email> | null

Validation: nullable|email|max:255.

Maximum string length: 255
Example:

"alex@example.org"

guardian_phone
string | null

Validation: nullable|string|max:255.

Maximum string length: 255
guardian_relationship
string | null

Validation: nullable|string|max:255.

Maximum string length: 255
guardian_donor_id
integer | null

Guardian donor must belong to this organization.

Example:

1

permissions
object | null

Leader-only permission overrides; cleared for participant roles. Missing leader permissions use defaults; promote_leaders defaults false.

tags
string[] | null
Maximum string length: 100
status
enum<string>

Validation: in:requested,active,withdrawn,completed.

Available options:
requested,
active,
withdrawn,
completed
Example:

"requested"

is_public
boolean

Validation: boolean.

Example:

false

is_anonymous
boolean

Validation: boolean.

Example:

false

bio
string | null

Validation: nullable|string|max:2000.

Maximum string length: 2000
video_url
string<uri> | null

Validation: nullable|url.

Example:

"https://example.org/document.pdf"

Response

Update a trip participant response.

Participant projections returned by roster, detail, create and update operations. Detailed fundraising/profile fields are present on reads; mutation responses contain the fields saved by that operation.

id
integer
donor_id
integer
entity_id
integer | null
name
string
email
string
phone
string | null
role
string
individual_goal
number
total_raised
number
progress_percent
number
status
string
is_public
boolean
is_anonymous
boolean
bio
string | null
video_url
string | null
is_minor
boolean
guardian_name
string | null
guardian_email
string | null
guardian_phone
string | null
guardian_relationship
string | null
guardian_donor_id
integer | null
background_check_status
string | null
background_check_provider_check_id
string | null
background_check_id
integer | null
background_check_report_url
string | null
background_check_updated_at
string<date-time> | null
background_check_expires_at
string<date> | null
background_check_adjudication
string | null
esignature_status
string | null
created_at
string<date-time>
permissions
object | null
effective_leader_permissions
object | null
tags
string[]
esignature_readiness
object
esignature_template_id
string | null
esignature_request_id
integer | null
esignature_provider_request_id
string | null
esignature_signed_document_url
string | null
esignature_signed_document_upload_id
integer | null
esignature_sent_at
string<date-time> | null
esignature_signed_at
string<date-time> | null