Skip to content
DocsGitHub

project

Work with Sentry projects

sentry project create [<org>/]<name>:<platform>...

Section titled “sentry project create [<org>/]<name>:<platform>...”

Create one or more projects

Arguments:

Argument Description
[<org>/]<name>:<platform>... One or more project name and platform pairs

Options:

Option Description
-t, --team <team> Team to create the project under
-n, --dry-run Show what would happen without making changes

Examples:

Terminal window
# Create a project (every project is a name:platform pair)
sentry project create my-new-app:javascript-nextjs
# Create several projects with their own platforms
sentry project create web:javascript api:python-django worker:node
# Create under a specific organization and team
sentry project create my-org/my-new-app:python --team backend-team
# Preview without creating
sentry project create my-new-app:node --dry-run
# Output the created project as JSON
sentry project create my-app:go --json

Delete a project

Arguments:

Argument Description
<org/project> <org>/<project> or <project> (search across orgs)

Options:

Option Description
-y, --yes Skip confirmation prompt
-f, --force Force the operation without confirmation
-n, --dry-run Show what would happen without making changes

Examples:

Terminal window
# Delete a project (prompts for confirmation)
sentry project delete my-org/old-project
# Delete without confirmation
sentry project delete my-org/old-project --yes
# Preview the deletion
sentry project delete my-org/old-project --dry-run

List projects

Arguments:

Argument Description
[<org/project>] <org>/ (all), <org>/<name> or <name> (a project, else matching names), or a name glob (<org>/web-*)

Options:

Option Description
-n, --limit <limit> Maximum number of projects to list (default: "25")
-p, --platform <platform> Filter by platform (e.g., javascript, python)
-f, --fresh Bypass cache, re-detect projects, and fetch fresh data
-c, --cursor <cursor> Navigate pages: "next", "prev", "first" (or raw cursor string)

Examples:

Terminal window
# List projects (organization auto-detected)
sentry project list
# List all projects in an organization
sentry project list my-org/
# Several projects in the same organization
sentry project list my-org/frontend,backend
# Filter by platform
sentry project list my-org/ --platform javascript
# Only projects whose slug or name matches a glob
sentry project list 'my-org/web-*'
# Projects named like 'frontend' (fuzzy when nothing matches exactly)
sentry project list my-org/frontnd
# Find a project across organizations
sentry project list frontend
# Fetch the next page
sentry project list my-org/ -c next
# Show more results
sentry project list my-org/ --limit 50
# Output as JSON
sentry project list my-org/ --json

View details of a project

Arguments:

Argument Description
[<org/project>] <org>/<project> or <project> (search)

Options:

Option Description
-w, --web Open in browser
-f, --fresh Bypass cache, re-detect projects, and fetch fresh data

Examples:

Terminal window
# View the auto-detected project
sentry project view
# View project details
sentry project view my-org/frontend
# Open the project in the browser
sentry project view my-org/frontend -w
# Find a project across organizations
sentry project view frontend

All commands support --json for machine-readable output and --fields to select specific JSON fields.