Resolve or ignore an error group
https://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.
Authorization: Bearer $RESPAN_API_KEYPath parameters
fingerprint string RequiredExample:
"9F3B2C1D4E5A6B7C"Request body
A request body is required.
application/json
$ object Required body
#/components/schemas/ErrorGroupResolutionRequeststatus string Required in parent
resolved, ignored, or unresolved to reopen.status (allOf 1) string Schema variantunresolved.Reference:
#/components/schemas/ErrorResolutionStatusAllowed:
"unresolved", "resolved", "ignored"Example:
"unresolved"OpenAPI request schema
{
"$ref": "#/components/schemas/ErrorGroupResolutionRequest"
}Example
{
"status": "resolved"
}Responses
200
The saved state.
application/json
$ object Body
#/components/schemas/ErrorGroupResolutionfingerprint string Required in parent"9F3B2C1D4E5A6B7C"status string Required in parentunresolved.Reference:
#/components/schemas/ErrorResolutionStatusAllowed:
"unresolved", "resolved", "ignored"Example:
"unresolved"updated_at string Required in parentdate-timeExample:
"2026-10-01T08:12:44.090211Z"OpenAPI response schema
{
"$ref": "#/components/schemas/ErrorGroupResolution"
}Example
{
"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
$ object Body
error string Required in parentOpenAPI response schema
{
"type": "object",
"required": [
"error"
],
"properties": {
"error": {
"type": "string"
}
}
}Example
{
"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
$ object Body
detail string Required in parentOpenAPI response schema
{
"type": "object",
"required": [
"detail"
],
"properties": {
"detail": {
"type": "string"
}
}
}Missing or invalid API key
{
"detail": "Your API key is invalid or expired, please check your API key in the platform settings."
}Key lacks the permission
{
"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
$ object Body
detail string Required in parentOpenAPI response schema
{
"type": "object",
"required": [
"detail"
],
"properties": {
"detail": {
"type": "string"
}
}
}Example
{
"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"
}
}
}
}