Skip to main content
PUT
Update a trip

Authorizations

Authorization
string
header
required

Passport bearer token authentication for legacy admin sessions.

Path Parameters

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.

name
string

Validation: required|string|max:255.

Maximum string length: 255
Example:

"Follow up with trip participants"

slug
string | null

Unique within the organization; generated from name when omitted on create.

Maximum string length: 255
Pattern: ^[a-z0-9-]+$
Example:

"uganda-service-trip"

description
string | null

Validation: nullable|string|max:50000.

Maximum string length: 50000
Example:

"Please review the updated trip details."

destination
string | null

Validation: nullable|string|max:255.

Maximum string length: 255
Example:

"Kampala, Uganda"

start_date
string<date-time> | null

Validation: nullable|date.

Example:

"2026-10-20T09:00:00Z"

end_date
string<date-time> | null

Trip end date; must be on or after start_date.

Example:

"2026-10-20T09:00:00Z"

fundraising_goal
number

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

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

40

status
enum<string>

Validation: required|in:draft,active,completed,archived,cancelled.

Available options:
draft,
active,
completed,
archived,
cancelled
Example:

"draft"

cover_image_id
integer | null

Validation: nullable|integer.

Example:

1

settings
object | null

Trip-specific settings merged with saved settings on update. Binding IDs must belong to this organization. background_check_validity_months is validated but stripped before storage; Checkr owns validity. sample_seed is preserved and cannot be supplied by callers.

Response

Update a trip response.

id
integer
name
string
slug
string
status
string
fundraising_goal
number
total_raised
number
progress_percent
number
participant_count
integer
is_sample_trip
boolean
sample_seed_version
integer | null
created_at
string<date-time>
updated_at
string<date-time>
destination
string | null
start_date
string<date> | null
end_date
string<date> | null