Resolve technical issue

Mark one page’s occurrence of a technical issue resolved, or reopen it. Scoped to a single row from Get technical issue’s data[], not the whole issue group — resolving one affected page never touches the group’s other pages. A manual resolve sticks until the issue is re-detected on that page by a future audit or discover run, which reopens it automatically.


PATCH /brands/{brand_id}/technical/issue-pages/{page_issue_id}

Authorization

Header	Type	Required
`Authorization`	`Bearer asky_sk_…`	required
`Idempotency-Key`	`string`	required on every write. See Idempotency

Path parameters

Parameter	Type	Required	Description
`brand_id`	`uuid`	required	From List brands
`page_issue_id`	`uuid`	required	One row’s `id` from Get technical issue’s `data[]`

Body parameters

Parameter	Type	Required	Description
`resolved`	`boolean`	optional	`true` to resolve (default), `false` to reopen

Request

cURL


curl --request PATCH \
  --url 'https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/technical/issue-pages/bcb9c8a7-563e-47e9-90de-7f9b41348f8b' \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Idempotency-Key: 5b0e77d2-13a9-4f6a-8ce1-9a3f5e21c0aa' \
  --header 'Content-Type: application/json' \
  --data '{"resolved": true}'

Python


import requests
 
url = "https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/technical/issue-pages/bcb9c8a7-563e-47e9-90de-7f9b41348f8b"
 
headers = {
    "Authorization": "Bearer <api-key>",
    "Idempotency-Key": "5b0e77d2-13a9-4f6a-8ce1-9a3f5e21c0aa",
    "Content-Type": "application/json",
}
 
response = requests.patch(url, headers=headers, json={"resolved": True})
 
print(response.text)

JavaScript


const options = {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer <api-key>',
    'Idempotency-Key': '5b0e77d2-13a9-4f6a-8ce1-9a3f5e21c0aa',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({resolved: true}),
};
 
fetch('https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/technical/issue-pages/bcb9c8a7-563e-47e9-90de-7f9b41348f8b', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

PHP


<?php
 
$curl = curl_init();
 
curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/technical/issue-pages/bcb9c8a7-563e-47e9-90de-7f9b41348f8b",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode(["resolved" => true]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <api-key>",
    "Idempotency-Key: 5b0e77d2-13a9-4f6a-8ce1-9a3f5e21c0aa",
    "Content-Type: application/json"
  ],
]);
 
$response = curl_exec($curl);
$err = curl_error($curl);
 
curl_close($curl);
 
if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Go


package main
 
import (
    "fmt"
    "net/http"
    "strings"
    "io"
)
 
func main() {
 
    url := "https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/technical/issue-pages/bcb9c8a7-563e-47e9-90de-7f9b41348f8b"
 
    payload := strings.NewReader(`{"resolved": true}`)
 
    req, _ := http.NewRequest("PATCH", url, payload)
 
    req.Header.Add("Authorization", "Bearer <api-key>")
    req.Header.Add("Idempotency-Key", "5b0e77d2-13a9-4f6a-8ce1-9a3f5e21c0aa")
    req.Header.Add("Content-Type", "application/json")
 
    res, _ := http.DefaultClient.Do(req)
 
    defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)
 
    fmt.Println(string(body))
 
}

Ruby


require 'uri'
require 'net/http'
require 'json'
 
url = URI("https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/technical/issue-pages/bcb9c8a7-563e-47e9-90de-7f9b41348f8b")
 
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
 
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <api-key>'
request["Idempotency-Key"] = '5b0e77d2-13a9-4f6a-8ce1-9a3f5e21c0aa'
request["Content-Type"] = 'application/json'
request.body = {resolved: true}.to_json
 
response = http.request(request)
puts response.read_body

Response

200


{
  "data": {
    "page_issue_id": "bcb9c8a7-563e-47e9-90de-7f9b41348f8b",
    "resolved": true
  },
  "request_id": "req_5b0e77d213a94f6a8ce1"
}

401


{
  "error": {
    "code": "token_expired",
    "message": "This API key has expired. Roll it from the API tab on the Connections page to get a replacement.",
    "request_id": "req_8f21c0aa47b1490d2e63"
  }
}

404


{
  "error": {
    "code": "not_found",
    "message": "Not found.",
    "request_id": "req_2a7c5e91b8d04f36ac10"
  }
}

429


{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry after 24 seconds.",
    "request_id": "req_9a3f5e21c0aa47b190d2"
  }
}

Response fields

Field	Type	Description
`data.page_issue_id`	`uuid`	required
`data.resolved`	`boolean`	required. The state it was set to
`request_id`	`string`	required. Also returned as the `x-request-id` header. Quote it when contacting support

Errors

Status	Code	When
400	`invalid_request`	A parameter is unknown or malformed
401	`invalid_token`	The key is missing, malformed, or does not exist
401	`token_expired`	The key passed its expiry date
401	`token_revoked`	The key was revoked
403	`insufficient_scope`	The key does not carry `write:website`
403	`plan_required`	This workspace is not enabled for API writes
404	`not_found`	`page_issue_id` does not exist for this brand, or this key is not allowed to reach it
429	`rate_limited`	Over 60 requests per minute on write endpoints

Notes

This is per-occurrence, not per-group. List technical issues and Get technical issue work at the group level — one row per issue type (e.g. “Links with no anchor text”), affecting many pages. This endpoint resolves exactly one of those affected pages, identified by the id field on its row in data[]. Resolving every page in a group individually is the only way to clear the whole group through this endpoint; there is no bulk resolve-by-group action.

A resolve does not stick past the next detection. If a future audit or discover run re-detects the same issue on the same page, it reopens automatically — resolved_at is cleared and auto_resolved is set. This mirrors what “Mark as resolved” does in the app: it is a statement that the page is fixed right now, not a permanent suppression.