Skip to content
Vocapable Developers

Poll opaque Owner Command Center change hints while the app is foregrounded

GET
/v1/mobile/change-feed
curl --request GET \
  --url 'https://api.vocapable.com/v1/mobile/change-feed?limit=50' \
  --header 'Authorization: Bearer <token>'

Return safe change hints after a tenant-local high-watermark.

The first request returns a small recent slice to invalidate freshly loaded screens; it does not replay audit history. Each subsequent call must send next_cursor and receives only entries committed after that immutable version. Cursor validation is performed against the current tenant’s allowed source rows, not merely by decoding it.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
limit
Limit
integer
default: 50 >= 1 <= 100
cursor
Any of:
string

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
MobileChangeFeedPage

A bounded foreground update batch.

With no cursor the service returns a recent bounded slice and establishes a high-watermark. has_more is meaningful only after a cursor: historical audit records are deliberately not replayed through this lightweight invalidation channel.

object
items
Items
Array<object>
<= 100 items
MobileChangeHint

One immutable, opaque version of a safe foreground invalidation target.

object
version
required
Version
string
>= 1 characters <= 128 characters
target
required
MobileChangeTarget

A client route invalidation target without human or operational content.

object
kind
required
Kind
string
Allowed values: activity billing emergency_override handoff integrations notifications operations receptionist schedule team
resource_id
Any of:
string
>= 1 characters <= 128 characters
next_cursor
Any of:
string
has_more
Has More
boolean
Example
{
  "items": [
    {
      "target": {
        "kind": "activity"
      }
    }
  ],
  "has_more": false
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}