Keep Staff View Alive
POST/api/portal/view-as/keep-alive
Extends a staff "View as buyer" session. A staff view is an idle window: every authenticated request already pushes its expiry out to 60 minutes from now, and this endpoint does so explicitly (the "Keep viewing" action shown before the view expires). It never extends past ends_by, 8 hours after the view opened. Allowed on a read-only staff view; it changes nothing of the buyer's.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Authenticate with the staff view's own bearer token. A buyer's own login has no staff view to extend and gets 404. Throttled 30/min.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthorized
Response Headers
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.