Skip to Content

Resolve or ignore an error group

POSThttps://api.respan.ai/api/pulses/errors/{fingerprint}/resolution/

Sets an error group’s triage state to resolved, ignored or unresolved. The state is saved per organization and fingerprint, and List error groups returns it as resolution.

Servers

https://api.respan.ai: Respan API Server

Authentication

RespanApiKey

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

HTTP scheme: bearer; format: Respan API key.

HTTP
Authorization: Bearer $RESPAN_API_KEY

Path parameters

Parameter Type Required Description and constraints
fingerprint string Required
Error group fingerprint from List error groups: 16 uppercase hex characters, case-sensitive.
Example: "9F3B2C1D4E5A6B7C"

Request body

A request body is required.

application/json

Field Type Requirement Description and constraints
$ object Required body
Reference: #/components/schemas/ErrorGroupResolutionRequest
status string Required in parent
resolved, ignored, or unresolved to reopen.
status (allOf 1) string Schema variant
Triage state. Groups you haven’t triaged are unresolved.
Reference: #/components/schemas/ErrorResolutionStatus
Allowed: "unresolved", "resolved", "ignored"
Example: "unresolved"

OpenAPI request schema

{
  "$ref": "#/components/schemas/ErrorGroupResolutionRequest"
}
Example
JSON
{ "status": "resolved" }

Responses

200

The saved state.

application/json

Field Type Requirement Description and constraints
$ object Body
Reference: #/components/schemas/ErrorGroupResolution
fingerprint string Required in parent
Example: "9F3B2C1D4E5A6B7C"
status string Required in parent
Triage state. Groups you haven’t triaged are unresolved.
Reference: #/components/schemas/ErrorResolutionStatus
Allowed: "unresolved", "resolved", "ignored"
Example: "unresolved"
updated_at string Required in parent
Format: date-time
Example: "2026-10-01T08:12:44.090211Z"

OpenAPI response schema

{
  "$ref": "#/components/schemas/ErrorGroupResolution"
}
Example
JSON
{ "fingerprint": "9F3B2C1D4E5A6B7C", "status": "resolved", "updated_at": "2026-10-01T08:12:44.090211Z" }

400

status is missing or not one of the allowed values.

application/json

Field Type Requirement Description and constraints
$ object Body
-
error string Required in parent
-

OpenAPI response schema

{
  "type": "object",
  "required": [
    "error"
  ],
  "properties": {
    "error": {
      "type": "string"
    }
  }
}
Example
JSON
{ "error": "status must be one of ['ignored', 'resolved', 'unresolved']" }

403

Forbidden: the API key is missing, invalid or expired; the key doesn’t grant logs:update (Write access does).

application/json

Field Type Requirement Description and constraints
$ object Body
-
detail string Required in parent
-

OpenAPI response schema

{
  "type": "object",
  "required": [
    "detail"
  ],
  "properties": {
    "detail": {
      "type": "string"
    }
  }
}
Missing or invalid API key
JSON
{ "detail": "Your API key is invalid or expired, please check your API key in the platform settings." }
Key lacks the permission
JSON
{ "detail": "This API key does not have the 'logs:update' permission." }

429

Rate limited. This endpoint allows 60 requests per minute per organization.

application/json

Field Type Requirement Description and constraints
$ object Body
-
detail string Required in parent
-

OpenAPI response schema

{
  "type": "object",
  "required": [
    "detail"
  ],
  "properties": {
    "detail": {
      "type": "string"
    }
  }
}
Example
JSON
{ "detail": "Request was throttled." }

OpenAPI source

The operation and referenced components below retain the complete OpenAPI definitions, including constraints and examples.

OpenAPI operation

{
  "summary": "Resolve or ignore an error group",
  "operationId": "updateErrorGroupResolution",
  "tags": [
    "Error Groups"
  ],
  "description": "Sets an error group's triage state to `resolved`, `ignored` or `unresolved`. The state is saved per organization and fingerprint, and List error groups returns it as `resolution`.",
  "parameters": [
    {
      "name": "fingerprint",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string"
      },
      "description": "Error group fingerprint from List error groups: 16 uppercase hex characters, case-sensitive.",
      "example": "9F3B2C1D4E5A6B7C"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/ErrorGroupResolutionRequest"
        },
        "example": {
          "status": "resolved"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "The saved state.",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorGroupResolution"
          },
          "example": {
            "fingerprint": "9F3B2C1D4E5A6B7C",
            "status": "resolved",
            "updated_at": "2026-10-01T08:12:44.090211Z"
          }
        }
      }
    },
    "400": {
      "description": "`status` is missing or not one of the allowed values.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "required": [
              "error"
            ],
            "properties": {
              "error": {
                "type": "string"
              }
            }
          },
          "example": {
            "error": "status must be one of ['ignored', 'resolved', 'unresolved']"
          }
        }
      }
    },
    "403": {
      "description": "Forbidden: the API key is missing, invalid or expired; the key doesn't grant `logs:update` (Write access does).",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "required": [
              "detail"
            ],
            "properties": {
              "detail": {
                "type": "string"
              }
            }
          },
          "examples": {
            "invalidKey": {
              "summary": "Missing or invalid API key",
              "value": {
                "detail": "Your API key is invalid or expired, please check your API key in the platform settings."
              }
            },
            "missingPermission": {
              "summary": "Key lacks the permission",
              "value": {
                "detail": "This API key does not have the 'logs:update' permission."
              }
            }
          }
        }
      }
    },
    "429": {
      "description": "Rate limited. This endpoint allows 60 requests per minute per organization.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "required": [
              "detail"
            ],
            "properties": {
              "detail": {
                "type": "string"
              }
            }
          },
          "example": {
            "detail": "Request was throttled."
          }
        }
      }
    }
  },
  "security": [
    {
      "RespanApiKey": []
    }
  ]
}

OpenAPI path metadata

{}

Referenced OpenAPI components

{
  "schemas": {
    "ErrorGroupResolution": {
      "type": "object",
      "required": [
        "fingerprint",
        "status",
        "updated_at"
      ],
      "properties": {
        "fingerprint": {
          "type": "string",
          "example": "9F3B2C1D4E5A6B7C"
        },
        "status": {
          "$ref": "#/components/schemas/ErrorResolutionStatus"
        },
        "updated_at": {
          "type": "string",
          "format": "date-time",
          "example": "2026-10-01T08:12:44.090211Z"
        }
      }
    },
    "ErrorGroupResolutionRequest": {
      "type": "object",
      "required": [
        "status"
      ],
      "properties": {
        "status": {
          "allOf": [
            {
              "$ref": "#/components/schemas/ErrorResolutionStatus"
            }
          ],
          "description": "`resolved`, `ignored`, or `unresolved` to reopen."
        }
      }
    },
    "ErrorResolutionStatus": {
      "type": "string",
      "enum": [
        "unresolved",
        "resolved",
        "ignored"
      ],
      "description": "Triage state. Groups you haven't triaged are `unresolved`.",
      "example": "unresolved"
    }
  },
  "securitySchemes": {
    "RespanApiKey": {
      "type": "http",
      "scheme": "bearer",
      "bearerFormat": "Respan API key",
      "description": "Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.",
      "x-fern-bearer": {
        "name": "respanApiKey",
        "env": "RESPAN_API_KEY"
      }
    }
  }
}