Update a Project

PUT /api/0/projects/{organization_id_or_slug}/{project_id_or_slug}/

Update various attributes and configurable settings for the given project.

Note that solely having the project:read scope restricts updatable settings to isBookmarked.

Path Parameters

organization_id_or_slug (string) REQUIRED: The ID or slug of the organization the resource belongs to.
project_id_or_slug (string) REQUIRED: The ID or slug of the project the resource belongs to.

Body Parameters

isBookmarked (boolean)

Enables starring the project within the projects tab. Can be updated with project:read permission.

name (string)

The name for the project

slug (string)

Uniquely identifies a project and is used for the interface.

platform (string)

The platform for the project

subjectPrefix (string)

Custom prefix for emails from this project.

subjectTemplate (string)

The email subject to use (excluding the prefix) for individual alerts. Here are the list of variables you can use:

$title
$shortID
$projectID
$orgID
${tag:key} - such as ${tag:environment} or ${tag:release}.

resolveAge (integer)

Automatically resolve an issue if it hasn't been seen for this many hours. Set to 0 to disable auto-resolve.

Scopes

You need to authenticate via bearer auth token.

<auth_token> requires one of the following scopes:

project:admin
project:read
project:write

curl https://sentry.io/api/0/projects/{organization_id_or_slug}/{project_id_or_slug}/ \
 -H 'Authorization: Bearer <auth_token>' \
 -X PUT \
 -H 'Content-Type: application/json' \
 -d '{}'

RESPONSESCHEMA

{
  "id": "4505278496",
  "slug": "pump-station",
  "name": "Pump Station",
  "platform": "python",
  "dateCreated": "2021-01-14T22:08:52.711809Z",
  "isBookmarked": false,
  "isMember": true,
  "features": [
    "alert-filters",
    "custom-inbound-filters",
    "data-forwarding",
    "discard-groups",
    "minidump",
    "race-free-group-creation",
    "rate-limits",
    "servicehooks",
    "similarity-indexing",
    "similarity-indexing-v2",
    "similarity-view",
    "similarity-view-v2"
  ],
  "firstEvent": "2021-01-14T22:08:52.711809Z",
  "firstTransactionEvent": true,
  "access": [
    "member:read",
    "event:read",
    "project:admin",
    "team:write",
    "project:write",
    "team:admin",
    "project:read",
    "org:integrations",
    "org:read",
    "project:releases",
    "team:read",
    "alerts:write",
    "event:admin",
    "event:write",
    "alerts:read"
  ],
  "hasAccess": true,
  "hasMinifiedStackTrace": false,
  "hasCustomMetrics": false,
  "hasMonitors": false,
  "hasProfiles": false,
  "hasReplays": false,
  "hasSessions": false,
  "isInternal": false,
  "isPublic": false,
  "avatar": {
    "avatarType": "letter_avatar",
    "avatarUuid": null
  },
  "color": "#3f70bf",
  "status": "active",
  "team": {
    "id": "2",
    "name": "Powerful Abolitionist",
    "slug": "powerful-abolitionist"
  },
  "teams": [
    {
      "id": "2",
      "name": "Powerful Abolitionist",
      "slug": "powerful-abolitionist"
    }
  ],
  "latestRelease": {
    "version": "backend@3e90a5d9e767ebcfa70e921d7a7ff6c037461168"
  },
  "options": {
    "sentry:grouping_auto_update": false,
    "sentry:span_description_cluster_rules": [],
    "sentry:transaction_name_cluster_rules": [],
    "digests:mail:maximum_delay": 600,
    "sentry:scrub_defaults": false,
    "sentry:scrape_javascript": true,
    "mail:subject_prefix": "",
    "sentry:relay_pii_config": null,
    "sentry:scrub_data": false,
    "sentry:token": "e84c8c0fb1c121e988558785885f9cde",
    "sentry:resolve_age": 168,
    "sentry:grouping_config": "newstyle:2023-01-11",
    "quotas:spike-protection-disabled": false,
    "sentry:store_crash_reports": 5,
    "digests:mail:minimum_delay": 180,
    "sentry:secondary_grouping_config": "newstyle:2019-10-29",
    "sentry:secondary_grouping_expiry": 147555024,
    "sentry:builtin_symbol_sources": [
      "ios",
      "android",
      "chromium"
    ],
    "sentry:origins": [
      "getsentry.com",
      "app.getsentry.com",
      "www.getsentry.com",
      "sentry.io"
    ],
    "sentry:sensitive_fields": [
      "sudo"
    ],
    "sentry:scrub_ip_address": false,
    "sentry:default_environment": "prod",
    "sentry:verify_ssl": true,
    "sentry:csp_ignored_sources_defaults": true,
    "sentry:csp_ignored_sources": "",
    "filters:blacklisted_ips": "",
    "filters:react-hydration-errors": true,
    "filters:chunk-load-error": true,
    "filters:releases": "",
    "filters:error_messages": "",
    "feedback:branding": true
  },
  "digestsMinDelay": 180,
  "digestsMaxDelay": 600,
  "subjectPrefix": "",
  "allowedDomains": [
    "getsentry.com",
    "app.getsentry.com",
    "www.getsentry.com",
    "sentry.io"
  ],
  "resolveAge": 168,
  "dataScrubber": false,
  "dataScrubberDefaults": false,
  "safeFields": [],
  "storeCrashReports": 5,
  "sensitiveFields": [
    "sudo"
  ],
  "subjectTemplate": "$shortID - $title",
  "securityToken": "e84c8c0fb1c121e988558785885f9cde",
  "securityTokenHeader": null,
  "verifySSL": true,
  "scrubIPAddresses": false,
  "scrapeJavaScript": true,
  "groupingConfig": "newstyle:2023-01-11",
  "groupingEnhancements": "",
  "groupingEnhancementsBase": null,
  "secondaryGroupingExpiry": 1687010243,
  "secondaryGroupingConfig": "newstyle:2019-10-29",
  "groupingAutoUpdate": false,
  "fingerprintingRules": "",
  "organization": {
    "id": "1",
    "slug": "sentry",
    "status": {
      "id": "active",
      "name": "active"
    },
    "name": "Sentry",
    "dateCreated": "2014-12-15T04:06:24.263571Z",
    "isEarlyAdopter": true,
    "require2FA": false,
    "requireEmailVerification": false,
    "avatar": {
      "avatarType": "upload",
      "avatarUuid": "24f6f762f7a7473888b259c566da5adb"
    },
    "features": [
      "performance-uncompressed-assets-ingest",
      "dashboards-rh-widget",
      "org-subdomains",
      "performance-db-main-thread-visible",
      "transaction-name-mark-scrubbed-as-sanitized",
      "sentry-pride-logo-footer",
      "issue-list-prefetch-issue-on-hover",
      "mep-rollout-flag",
      "performance-issues-m-n-plus-one-db-detector",
      "session-replay-ui",
      "alert-crash-free-metrics",
      "performance-n-plus-one-db-queries-visible",
      "session-replay-recording-scrubbing",
      "profile-file-io-main-thread-visible",
      "performance-consecutive-http-detector",
      "profiling",
      "symbol-sources",
      "advanced-search",
      "performance-n-plus-one-db-queries-post-process-group",
      "minute-resolution-sessions",
      "performance-transaction-name-only-search-indexed",
      "performance-large-http-payload-detector",
      "performance-consecutive-db-queries-ingest",
      "business-to-team-promotion",
      "shared-issues",
      "performance-large-http-payload-post-process-group",
      "promotion-be-adoption-enabled",
      "monitors",
      "am2-billing",
      "project-stats",
      "profiling-ga",
      "performance-new-trends",
      "performance-n-plus-one-api-calls-post-process-group",
      "performance-db-main-thread-post-process-group",
      "performance-metrics-backed-transaction-summary",
      "performance-db-main-thread-detector",
      "issue-platform",
      "performance-consecutive-db-issue",
      "performance-consecutive-http-post-process-group",
      "performance-n-plus-one-api-calls-detector",
      "performance-render-blocking-asset-span-post-process-group",
      "performance-uncompressed-assets-post-process-group",
      "performance-issues-search",
      "performance-slow-db-issue",
      "performance-db-main-thread-ingest",
      "session-replay",
      "sql-format",
      "performance-consecutive-db-queries-visible",
      "user-spend-notifications-settings",
      "performance-m-n-plus-one-db-queries-post-process-group",
      "transaction-metrics-extraction",
      "performance-consecutive-db-queries-post-process-group",
      "performance-slow-db-query-post-process-group",
      "session-replay-sdk-errors-only",
      "performance-n-plus-one-db-queries-ingest",
      "profile-image-decode-main-thread-visible",
      "performance-issues-render-blocking-assets-detector",
      "performance-m-n-plus-one-db-queries-ingest",
      "anr-rate",
      "auto-enable-codecov",
      "ondemand-budgets",
      "profile-file-io-main-thread-post-process-group",
      "performance-render-blocking-asset-span-ingest",
      "profile-json-decode-main-thread-post-process-group",
      "onboarding-project-deletion-on-back-click",
      "invite-members-rate-limits",
      "transaction-name-normalize",
      "performance-file-io-main-thread-visible",
      "onboarding-sdk-selection",
      "performance-span-histogram-view",
      "performance-file-io-main-thread-ingest",
      "metrics-extraction",
      "profile-json-decode-main-thread-ingest",
      "onboarding",
      "promotion-mobperf-gift50kerr",
      "device-classification",
      "transaction-name-normalize-legacy",
      "performance-slow-db-query-ingest",
      "bundle-plan-checkout",
      "metric-alert-chartcuterie",
      "performance-issues-all-events-tab",
      "discover-events-rate-limit",
      "india-promotion",
      "track-button-click-events",
      "performance-issues-compressed-assets-detector",
      "device-class-synthesis",
      "profiling-billing",
      "performance-file-io-main-thread-detector",
      "integrations-deployment",
      "performance-m-n-plus-one-db-queries-visible",
      "mobile-cpu-memory-in-transactions",
      "derive-code-mappings",
      "performance-onboarding-checklist",
      "performance-consecutive-http-visible",
      "performance-n-plus-one-api-calls-ingest",
      "performance-landing-page-stats-period",
      "dynamic-sampling",
      "performance-slow-db-query-visible",
      "performance-n-plus-one-api-calls-visible",
      "profile-image-decode-main-thread-ingest",
      "set-grouping-config",
      "event-attachments",
      "open-membership",
      "new-spike-protection",
      "source-maps-debug-ids",
      "paid-to-free-promotion",
      "performance-large-http-payload-ingest",
      "crons-issue-platform",
      "profile-file-io-main-thread-ingest",
      "customer-domains",
      "performance-file-io-main-thread-post-process-group",
      "performance-render-blocking-asset-span-visible",
      "ds-sliding-window-org",
      "performance-consecutive-http-ingest",
      "profile-image-decode-main-thread-post-process-group",
      "performance-mep-bannerless-ui",
      "performance-uncompressed-assets-visible",
      "performance-large-http-payload-visible",
      "performance-view",
      "promotion-mobperf-discount20",
      "performance-new-widget-designs",
      "profile-json-decode-main-thread-visible"
    ],
    "links": {
      "organizationUrl": "https://sentry.sentry.io",
      "regionUrl": "https://us.sentry.io"
    },
    "hasAuthProvider": true
  },
  "plugins": [
    {
      "id": "asana",
      "name": "Asana",
      "slug": "asana",
      "shortName": "Asana",
      "type": "issue-tracking",
      "canDisable": true,
      "isTestable": false,
      "hasConfiguration": true,
      "metadata": {},
      "contexts": [],
      "status": "unknown",
      "assets": [],
      "doc": "",
      "firstPartyAlternative": null,
      "deprecationDate": null,
      "altIsSentryApp": null,
      "enabled": true,
      "version": "23.7.0.dev0",
      "author": {
        "name": "Sentry Team",
        "url": "https://github.com/getsentry/sentry"
      },
      "isDeprecated": false,
      "isHidden": false,
      "description": "\nImprove your productivity by creating tasks in Asana directly\nfrom Sentry issues. This integration also allows you to link Sentry\nissues to existing tasks in Asana.\n",
      "features": [
        "issue-basic"
      ],
      "featureDescriptions": [
        {
          "description": "Create and link Sentry issue groups directly to an Asana ticket in any of your\n            projects, providing a quick way to jump from a Sentry bug to tracked ticket!",
          "featureGate": "issue-basic"
        },
        {
          "description": "Link Sentry issues to existing Asana tickets.",
          "featureGate": "issue-basic"
        }
      ],
      "resourceLinks": [
        {
          "title": "Report Issue",
          "url": "https://github.com/getsentry/sentry/issues"
        },
        {
          "title": "View Source",
          "url": "https://github.com/getsentry/sentry/tree/master/src/sentry_plugins"
        }
      ]
    }
  ],
  "platforms": [
    "native",
    "other",
    "python"
  ],
  "processingIssues": 0,
  "defaultEnvironment": "prod",
  "relayPiiConfig": null,
  "builtinSymbolSources": [
    "ios",
    "android",
    "chromium"
  ],
  "dynamicSamplingBiases": [
    {
      "id": "boostEnvironments",
      "active": true
    },
    {
      "id": "boostLatestRelease",
      "active": true
    },
    {
      "id": "ignoreHealthChecks",
      "active": true
    },
    {
      "id": "boostKeyTransactions",
      "active": true
    },
    {
      "id": "boostLowVolumeTransactions",
      "active": true
    },
    {
      "id": "boostReplayId",
      "active": true
    },
    {
      "id": "recalibrationRule",
      "active": true
    }
  ],
  "eventProcessing": {
    "symbolicationDegraded": false
  },
  "symbolSources": "[]"
}

Account Settings

Organization Settings

Product Walkthroughs

Pricing & Billing

Sentry CLI

Sentry API

Security, Legal, & PII

Concepts & Reference

Update a Project

Path Parameters

Body Parameters

Scopes