Skip to content

Get events

BetaAPI v2 is in public beta: endpoints, fields and behaviour can change before general availability. See the changelog

GET
/account/integrations/{id}/events
curl --request GET \
--url 'https://app.stoqapp.com/api/v2/external/account/integrations/example/events?limit=5&before=string' \
--header 'X-Auth-Token: <X-Auth-Token>'

What happened to one integration, newest first: connect links and key links issued, connects, disconnects (auto_disconnected when the provider revoked STOQ’s access), keys set, cleared or refused, and settings changed (field names only). Each event says which surface did it: dashboard, quinn, mcp, api or system.

Note: limit is 1 to 100 (default 20). Pass next_cursor back as before for the next page. Changes saved in the dashboard are recorded too.

id
required
string
limit

Example

5
before

Example

string

Success — the requested resource.

Media typeapplication/json
object

Example generated

{}

Missing or invalid X-Auth-Token.

Media typeapplication/json

Error envelope returned by every failed request.

object
errors
required
Array<string>

Example

{
"errors": [
"Unauthorized"
]
}

The resource does not exist for this shop, or the action path is not registered.

Media typeapplication/json

Error envelope returned by every failed request.

object
errors
required
Array<string>

Example

{
"errors": [
"Offer not found"
]
}

The request failed validation.

Media typeapplication/json

Error envelope returned by every failed request.

object
errors
required
Array<string>

Example

{
"errors": [
"name is required"
]
}

Rate limited — cost-weighted per token (read 1, write 2; 360 points / 60s). Check Retry-After.

Media typeapplication/json

Error envelope returned by every failed request.

object
errors
required
Array<string>

Example

{
"errors": [
"Rate limit exceeded"
]
}
Was this page helpful?

Still stuck? Ask Quinn or chat with support