---
updatedAt: 2026-05-26T22:08:32.000Z
agentTools:
  projectIndex: https://doppel.readme.io/llms.txt
---

# Update Report

Updates a report in the system with certain parameters.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0.0",
    "title": "Doppel",
    "description": "APIs to interface with Doppel's core system",
    "contact": {}
  },
  "x-readme": {
    "parameter-ordering": [
      "path",
      "header",
      "query",
      "body",
      "cookie",
      "form"
    ]
  },
  "x-google-management": {
    "metrics": [
      {
        "name": "get-scan-result-request",
        "displayName": "Get Scan Result Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "submit-scan-request",
        "displayName": "Submit Scan Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "submit-eml-request",
        "displayName": "Submit EML Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "track-campaign-action-request",
        "displayName": "Track Campaign Action Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "create-alert-request",
        "displayName": "Create Alert Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "get-alert-request",
        "displayName": "Get Alert Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "get-alerts-request",
        "displayName": "Get Alerts Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "update-alert-request",
        "displayName": "Update Alert Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "alert-abuse-request",
        "displayName": "Alert Abuse Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "update-report-request",
        "displayName": "Update Report Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "submit-report-request",
        "displayName": "Submit Report Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "get-report-request",
        "displayName": "Get Report Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "get-reports-request",
        "displayName": "Get Reports",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "upload-new-protected-asset-request",
        "displayName": "Upload New Protected Asset Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "cloned-website-request",
        "displayName": "Cloned Website Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "submit-referrer-logs-request",
        "displayName": "Submit Referrer Logs Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      },
      {
        "name": "delete-protected-asset-request",
        "displayName": "Delete Protected Asset Quota",
        "valueType": "INT64",
        "metricKind": "DELTA"
      }
    ],
    "quota": {
      "limits": [
        {
          "name": "get-scan-result-limit",
          "metric": "get-scan-result-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 300
          }
        },
        {
          "name": "submit-scan-limit",
          "metric": "submit-scan-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 300
          }
        },
        {
          "name": "submit-eml-limit",
          "metric": "submit-eml-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 3000
          }
        },
        {
          "name": "track-campaign-action-limit",
          "metric": "track-campaign-action-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 300
          }
        },
        {
          "name": "create-alert-limit",
          "metric": "create-alert-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 100
          }
        },
        {
          "name": "alert-limit",
          "metric": "get-alert-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 100
          }
        },
        {
          "name": "get-alerts-limit",
          "metric": "get-alerts-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 100
          }
        },
        {
          "name": "alert-abuse-limit",
          "metric": "alert-abuse-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 1000
          }
        },
        {
          "name": "update-alert-limit",
          "metric": "update-alert-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 100
          }
        },
        {
          "name": "update-report-limit",
          "metric": "update-report-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 100
          }
        },
        {
          "name": "submit-report-limit",
          "metric": "submit-report-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 100
          }
        },
        {
          "name": "get-report-limit",
          "metric": "get-report-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 100
          }
        },
        {
          "name": "get-reports",
          "metric": "get-reports-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 100
          }
        },
        {
          "name": "submit-referrer-logs-limit",
          "metric": "submit-referrer-logs-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 1000
          }
        },
        {
          "name": "upload-new-protected-asset-limit",
          "metric": "upload-new-protected-asset-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 5
          }
        },
        {
          "name": "cloned-website-limit",
          "metric": "cloned-website-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 5
          }
        },
        {
          "name": "delete-protected-asset-limit",
          "metric": "delete-protected-asset-request",
          "unit": "1/min/{project}",
          "values": {
            "STANDARD": 100
          }
        }
      ]
    }
  },
  "paths": {
    "/report": {
      "put": {
        "description": "Updates a report in the system with certain parameters.",
        "summary": "Update Report",
        "deprecated": true,
        "operationId": "update_report",
        "tags": [
          "reports"
        ],
        "x-google-backend": {
          "address": "https://external-api-gateway-725058953679.us-west1.run.app",
          "jwt_audience": "https://external-api-gateway-725058953679.us-west1.run.app",
          "path_translation": "APPEND_PATH_TO_ADDRESS",
          "deadline": 30
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/XOrganizationCodeHeader"
          },
          {
            "name": "Content-Type",
            "in": "header",
            "required": true,
            "description": "",
            "schema": {
              "type": "string",
              "enum": [
                "application/json"
              ]
            }
          },
          {
            "name": "url",
            "in": "query",
            "required": false,
            "description": "One of the reports urls to update",
            "schema": {
              "type": "string",
              "format": "uri"
            }
          },
          {
            "name": "id",
            "in": "query",
            "required": false,
            "description": "The id of the report to update",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "display_id",
            "in": "query",
            "required": false,
            "description": "The display ID of the report to update",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "notes": {
                    "type": "string",
                    "description": "New notes to update report with (id or display id required)"
                  },
                  "report_status": {
                    "$ref": "#/components/schemas/ReportStatus"
                  },
                  "classification": {
                    "$ref": "#/components/schemas/ReportClassification"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Existing report found",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReportResponse"
                }
              }
            }
          },
          "201": {
            "description": "Updated report successfully",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReportResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": [],
            "user_api_key": []
          }
        ],
        "x-google-quota": {
          "metricCosts": {
            "update-report-request": 1
          }
        }
      }
    }
  },
  "security": [
    {
      "api_key": [],
      "user_api_key": []
    }
  ],
  "externalDocs": {
    "url": "https://doppel.com",
    "description": "Find out more about Doppel"
  },
  "servers": [
    {
      "url": "https://api.doppel.com/v1"
    }
  ],
  "components": {
    "parameters": {
      "XOrganizationCodeHeader": {
        "name": "x-organization-code",
        "in": "header",
        "description": "(optional) Your Doppel Organization Code. Required if user is in multiple organizations.",
        "required": false,
        "schema": {
          "type": "string"
        }
      }
    },
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header",
        "description": "API key from Doppel Vision API settings. Required for gateway authentication and quota."
      },
      "user_api_key": {
        "type": "apiKey",
        "name": "x-user-api-key",
        "in": "header",
        "description": "User API key from Doppel Vision API settings. Required together with x-api-key for authenticated requests."
      }
    },
    "schemas": {
      "ReportStatus": {
        "description": "Status of which queue the report is in.\n(Note: taken_down is equivalent to Resolved in the Doppel Vision App)\n",
        "type": "string",
        "enum": [
          "doppel_review",
          "needs_confirmation",
          "actioned",
          "taken_down",
          "monitoring",
          "archived"
        ]
      },
      "Product": {
        "description": "Product category the report belongs to.",
        "type": "string",
        "enum": [
          "domains",
          "social_media",
          "mobile_apps",
          "ecommerce",
          "crypto",
          "email",
          "paid_ads",
          "telco",
          "darkweb"
        ]
      },
      "ReportClassification": {
        "description": "New classification to update a report's url with (url required)",
        "type": "string",
        "enum": [
          "suspicious",
          "down",
          "parked",
          "active"
        ]
      },
      "ReportSource": {
        "description": "How the report was sourced.",
        "type": "string",
        "enum": [
          "Manual Upload",
          "API Upload",
          "Social Media API",
          "Web Search API",
          "Domains Feed",
          "Phishing Feed",
          "Marketplace API",
          "Ads Feed",
          "Dark Web Feed",
          "SSL Transparency Logs",
          "Pivot",
          "Abuse Box",
          "Brand Abusebox",
          "Email Inbox",
          "Web Beacon",
          "Other",
          "Crawler"
        ]
      },
      "ErrorResponse": {
        "title": "ErrorResponse",
        "description": "Standard error response returned for all non-2xx responses. Contains a single `message` field with a human-readable error description.",
        "type": "object",
        "required": [
          "message"
        ],
        "properties": {
          "message": {
            "type": "string",
            "description": "Human-readable error description.",
            "example": "This is an error message"
          }
        }
      },
      "AuditLog": {
        "title": "AuditLog",
        "description": "A log of the changes on a report.",
        "type": "object",
        "properties": {
          "changed_by": {
            "type": "string",
            "description": "Email of the user who made the change, or \"Doppel\"."
          },
          "value": {
            "type": "string",
            "description": "New log value"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the change was made."
          },
          "type": {
            "type": "string",
            "description": "Type of audit log."
          },
          "metadata": {
            "title": "Metadata",
            "description": "Metadata for audit log.",
            "type": "object",
            "properties": {
              "enforcement_request": {
                "description": "Enforcement request information.",
                "type": "object",
                "properties": {
                  "platform": {
                    "description": "Platform where the enforcement request was made.",
                    "type": "string"
                  },
                  "type": {
                    "description": "Type of enforcement request.",
                    "type": "string"
                  }
                }
              },
              "match": {
                "description": "Match information.",
                "type": "object",
                "properties": {
                  "domain": {
                    "description": "Domain information.",
                    "type": "object",
                    "properties": {
                      "url": {
                        "description": "URL associated with metadata.",
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "ReportResponse": {
        "title": "ReportResponse",
        "description": "Doppel report schema",
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the reported URL"
          },
          "display_id": {
            "type": "string",
            "description": "Unique identifier for the report (e.g. TST-1234)"
          },
          "submitted_url": {
            "description": "URL submitted for report",
            "type": "string"
          },
          "doppel_url": {
            "description": "Doppel URL of the report that was created",
            "type": "string"
          },
          "report_status": {
            "$ref": "#/components/schemas/ReportStatus"
          },
          "classification": {
            "$ref": "#/components/schemas/ReportClassification"
          },
          "product": {
            "$ref": "#/components/schemas/Product"
          },
          "source": {
            "$ref": "#/components/schemas/ReportSource"
          },
          "notes": {
            "description": "Notes associated with a report.",
            "type": "string"
          },
          "uploaded_by": {
            "description": "Email of the user who submitted the report, or \"Doppel\".",
            "type": "string"
          },
          "created_at": {
            "description": "Timestamp when the report was created.",
            "type": "string",
            "format": "date-time"
          },
          "matches": {
            "description": "A list of matches found for this report.",
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "domain": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "description": "The URL of the matched domain."
                    },
                    "screenshot_url": {
                      "type": "string",
                      "description": "The URL of the screenshot for the matched domain."
                    },
                    "classification": {
                      "type": "string",
                      "description": "The classification of the matched domain."
                    }
                  }
                }
              }
            }
          },
          "root_domain": {
            "type": "object",
            "properties": {
              "domain": {
                "type": "string",
                "description": "The root domain associated with the reported URL."
              },
              "registrar": {
                "type": "string",
                "description": "The registrar of the root domain."
              },
              "ip_address": {
                "type": "string",
                "description": "The IP address associated with the root domain."
              },
              "country_code": {
                "type": "string",
                "description": "The country code of the root domain's server location."
              },
              "hosting_provider": {
                "type": "string",
                "description": "The hosting provider for the root domain."
              }
            }
          },
          "audit_logs": {
            "description": "A list of changes made to this report.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AuditLog"
            }
          },
          "tags": {
            "description": "A list of tags associated with this report.",
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "The name of the tag."
                }
              }
            }
          }
        }
      }
    }
  }
}
```