curl --request PUT \
--url https://public-api.sessionboard.com/v1/event/{eventId}/sessions/{sessionId}/fields \
--header 'Content-Type: application/json' \
--header 'x-access-token: <api-key>' \
--data '
{
"values": [
{
"internal_name": "track_code",
"value": "T-42"
}
]
}
'{
"data": {
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"updated_fields": [
{
"field_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"language": "<string>"
}
]
}
}Update session custom fields
Update custom field values on a session without touching other session properties. Requires the write:sessions scope.
curl --request PUT \
--url https://public-api.sessionboard.com/v1/event/{eventId}/sessions/{sessionId}/fields \
--header 'Content-Type: application/json' \
--header 'x-access-token: <api-key>' \
--data '
{
"values": [
{
"internal_name": "track_code",
"value": "T-42"
}
]
}
'{
"data": {
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"updated_fields": [
{
"field_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"language": "<string>"
}
]
}
}Authorizations
Organization API token. Generate from Organization Settings → API Tokens.
Body
Field values to write. Unlike the session PUT, this
endpoint takes an array of entries rather than a
custom_fields object, and each entry may carry its own
language — so this is the endpoint to use for writing a
language variant of a single field. An empty or missing
array returns 400 VALIDATION_ERROR.
Value formatting per type matches custom_fields
elsewhere: an empty string ("") clears a number,
currency, or percent field; checkbox takes boolean
true / false; datetime takes an ISO 8601 string.
Fields owned by an integration (for example
swoogo_session_id, cvent_session_id,
visit_session_id) are hydrated by the connector and
reject writes with 400 FIELD_READ_ONLY, naming the
field in details.field.
1Show child attributes
Show child attributes
Response
Custom fields updated. The response echoes the fields that were
written rather than the whole session — refetch with
GET /v1/event/{eventId}/sessions/{sessionId} if you need the
full record.
Show child attributes
Show child attributes