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,
  "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": "[]"
}