Reschedule a session
Change the recorded appointment date and time.
Overview
Update the meeting timestamp and refresh related scheduling work. The timestamp identifies an exact instant. This operation does not reserve a notary’s availability; confirm the appointment with the intended participants.
Use an owned session and agree the new time with participants. Check the account’s reschedule-notification and open-call scheduling settings.
- Agree a new time
Confirm the intended local date, time, and timezone.
- Convert and update
Generate the correct offset and send session_timing.
- Confirm downstream effects
Check reminders, notifications, and any open-call schedule.
Parameters
| Field | Requirement | Description |
|---|---|---|
bn_session_idstring · path | Required | The existing BlueNotary session ID. |
session_timingstring · date-time | Required | ISO 8601 timestamp with an explicit offset. The example is 16:30 UTC. Compute the offset for the appointment date. |
Request example
Use a server-side API key. Replace example IDs and values before using this request in an approved test environment.
curl --request PUT \
--url 'https://app.bluenotary.us/api/integrationsv2/sessions/YOUR_SESSION_ID/reschedule' \
--header "Authorization: Bearer $BLUENOTARY_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"session_timing": "2030-01-16T11:30:00-05:00"
}'Response
200 · Example success Illustrative values in the current response shape.
{
"response": "Success",
"response_message": "Session rescheduled successfully"
}- Validate that the appointment is in the future, the session can be rescheduled, and the notary is available before calling this operation. These checks are not all enforced by the reschedule handler.
- Email notification depends on account configuration; there is no confirmed per-request notification switch here.
- The
session_rescheduledevent carries updated meeting information. Reconcile event-driven state with Get Session if needed. - Verify both stored appointment time and actual dispatch behavior across daylight-saving transitions.
Errors & recovery
| Status | What happened | What to do |
|---|---|---|
| 400 | Missing or invalid session_timing | Provide a valid date-time with an explicit UTC offset. |
| 401 | Authentication failed | Use a valid API key. |
| 403 | Session Not Found | Check ownership and the returned session ID. |
Explore the response
Response simulator
LOCAL EXAMPLEExplore the example response without an API key. This does not send requests or validate your account configuration.