api-referencePATCH
PATCH
https://analytics.flowsery.com/analytics/api/v1/issues/{issueId}Change the workflow status of an AI-detected issue. Returns the updated issue detail.
Bearer Token (workspace token or website API key)
Workspace Tokens Need a Website Selector
Workspace API tokens can access every website in the workspace. Pass either <code>websiteId</code> or <code>domain</code> so Flowsery knows which website to query or mutate. Website API keys are already scoped to one website, so the selector can be omitted.Website Selector
| Parameter | Type | Description |
|---|---|---|
websiteId | string | Website ID to use with a workspace API token. Include this field in the JSON body unless you provide domain. Omit when authenticating with a website API key. |
domain | string | Website domain to use with a workspace API token when websiteId is not provided. Include this field in the JSON body. Omit when authenticating with a website API key. |
Request Body
| Parameter | Type | Description |
|---|---|---|
statusREQUIRED | string | The new workflow status: open, in_progress, resolved, or suspended. |
Suspending an Issue
Suspended issues disappear from the default List issues response. Set any other status later to bring an issue back.The success payload contains the updated issue detail, in the same shape as Get issue details.
Error Responses
<strong>404 Not Found</strong> -- The issue does not exist on the selected website.
Mark an issue resolved
curl --request PATCH \
--url https://analytics.flowsery.com/analytics/api/v1/issues/{issueId} \
--header 'Authorization: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{ "status": "resolved" }'Suspend an issue
curl --request PATCH \
--url https://analytics.flowsery.com/analytics/api/v1/issues/{issueId} \
--header 'Authorization: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{ "status": "suspended" }'200
{
"status": "success",
"data": {
"id": "iss_64f1c2a9e8b4d90012ab34cd",
"websiteId": "flid_abc123",
"title": "Checkout button unresponsive on mobile Safari",
"description": "Tapping the checkout button produces no navigation or feedback. Visitors tap repeatedly and abandon the cart.",
"severity": "critical",
"status": "resolved",
"sessionsCount": 14,
"firstSeenAt": "2026-08-02T09:14:31.000Z",
"lastSeenAt": "2026-08-27T18:40:05.000Z",
"stepsToReplicate": [
"Open the store on an iPhone in Safari",
"Add any product to the cart",
"Tap the checkout button on the cart page"
],
"sampleRecordingId": "rec_9f8e7d6c5b4a",
"externalTicketProvider": "linear",
"externalTicketKey": "SHOP-142",
"externalTicketUrl": "https://linear.app/acme/issue/SHOP-142",
"occurrences": [
{
"description": "Visitor taps the checkout button five times with no response",
"atSeconds": 42,
"severity": "critical"
}
],
"sessions": [
{ "recordingId": "rec_9f8e7d6c5b4a", "atSeconds": 42 }
],
"comments": []
}
}