Projects in Sentry represent a single application or service you want to monitor. These endpoints let you manage projects within an organization.
List projects in an organization
GET /api/0/organizations/{organization_id_or_slug}/projects/
project:read
Path parameters
The ID or slug of the organization.
Query parameters
Pagination cursor from the Link response header.
Example request
curl https://sentry.io/api/0/organizations/my-org/projects/ \
-H "Authorization: Bearer <token>"
Example response
[
{
"id": "2",
"slug": "pump-station",
"name": "Pump Station",
"platform": "python",
"dateCreated": "2018-11-06T21:19:58.536Z",
"isBookmarked": false,
"isMember": true,
"hasAccess": true,
"firstEvent": "2018-11-06T21:19:58.639Z",
"firstTransactionEvent": false,
"features": [],
"status": "active"
}
]
Create a project
POST /api/0/teams/{organization_id_or_slug}/{team_id_or_slug}/projects/
project:write
Path parameters
The ID or slug of the organization.
The ID or slug of the team that will own the project.
Request body
A unique slug for the project. Generated from the name if not provided.
The platform identifier (e.g. python, javascript, java).
Example request
curl -X POST https://sentry.io/api/0/teams/my-org/my-team/projects/ \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"name": "Backend API", "platform": "python"}'
Retrieve a project
GET /api/0/projects/{organization_id_or_slug}/{project_id_or_slug}/
project:read
Path parameters
The ID or slug of the organization.
The ID or slug of the project.
Example request
curl https://sentry.io/api/0/projects/my-org/pump-station/ \
-H "Authorization: Bearer <token>"
Response fields
The unique ID of the project.
The URL-friendly identifier for the project.
The display name of the project.
The primary platform of the project (e.g. python, javascript).
ISO 8601 timestamp of when the project was created.
Whether the authenticated user has bookmarked this project.
Whether the authenticated user is a member of a team assigned to this project.
Whether the authenticated user has access to this project.
ISO 8601 timestamp of the first event received, or null if no events have been received.
The project status. One of active or deleted.
Update a project
PUT /api/0/projects/{organization_id_or_slug}/{project_id_or_slug}/
project:write
Path parameters
The ID or slug of the organization.
The ID or slug of the project.
Request body
The new display name for the project.
A new URL slug for the project.
The project’s primary platform.
Whether the current user bookmarks the project.
Example request
curl -X PUT https://sentry.io/api/0/projects/my-org/pump-station/ \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"name": "Pump Station v2"}'
Delete a project
DELETE /api/0/projects/{organization_id_or_slug}/{project_id_or_slug}/
project:admin
Deleting a project is permanent and cannot be undone. All issues, events, and releases associated with the project will be removed.
Path parameters
The ID or slug of the organization.
The ID or slug of the project to delete.
Example request
curl -X DELETE https://sentry.io/api/0/projects/my-org/pump-station/ \
-H "Authorization: Bearer <token>"
204 No Content. 
