HOhoneybadger
Faults

Resolve faults

Marks faults as resolved. Name them with fault_ids, narrow them with q or a time filter, or pass "all": true to resolve every fault in the project. The request must include one of these.

post/projects/{project_id}/faults/resolve

Request

Path parameters

project_idstring required
Example:Xk9mZp

Project ID

Request body

allboolean

Apply to every fault the other filters match, which with no other filters is every fault in the project. Required to make an unbounded change explicit; ignored when fault_ids names specific faults.

dry_runboolean

Report what the request would change without changing it — no state change, no comments, no timeline entries. The response has the same shape either way, with dry_run echoed back.

fault_idsstring[]

IDs of the faults to change. If any ID isn't a fault in this project, nothing changes. Omit to act on everything the query and time filters match; with no filters, that requires "all": true.

qstring

Search query, in the syntax of the web UI's error search, applied when fault_ids is left out. See Error search for the syntax and filters.

created_afternumber double

Only faults created after this Unix timestamp. Applied when fault_ids is omitted, alongside q.

occurred_afternumber double

Only faults that occurred after this Unix timestamp. Applied when fault_ids is omitted, alongside q.

occurred_beforenumber double

Only faults that occurred before this Unix timestamp. Applied when fault_ids is omitted, alongside q.

Example request

{
  "fault_ids": [
    "12345",
    "12346"
  ],
  "q": "-is:resolved"
}

Response

Applied, or reported without applying when dry_run was set. The body says how many faults changed and names them.

Example response

{
  "data": {
    "count": 12,
    "fault_ids": [
      "12345",
      "12346"
    ]
  },
  "meta": {
    "request_id": "6f1c2b0e-8d4a-4f6e-9b2a-3c5d7e9f1a2b"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.