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

<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,
  "hasInsightsHttp": true,
  "hasInsightsDb": false,
  "hasInsightsAssets": true,
  "hasInsightsAppStart": false,
  "hasInsightsScreenLoad": false,
  "hasInsightsVitals": false,
  "hasInsightsCaches": false,
  "hasInsightsQueues": false,
  "hasInsightsLlmMonitoring": 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,
  "extrapolateMetrics": true,
  "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": "",
  "uptimeAutodetection": true,
  "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",
      "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",
      "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",
      "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": "[]"
}