Update project settings
PATCH/v2/orgs/:org_id/teams/:team_id/projects/:project_id/settings
Updates the settings of a project.
Required scope
projects:writeRate limiting
Level 1Enterprise only
This API is available only for Enterprise plan users. You can only use this endpoint if you have the role of a Company Admin. You can request temporary access to Enterprise APIs using this form.
Request
Path Parameters
The ID of the organization to which the project belongs.
The ID of the team to which the project belongs.
The ID of the project whose settings you want to update.
- application/json
Body
required
- "private": Only the members of the project can access the information within the project.
- "view": Anyone in the team can view the information in within the project.
sharingPolicySettings
object
Possible values: [private
, view
]
Default value: private
Team access
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 429
Project object
- application/json
- Schema
- Example (from schema)
Schema
- "private": Only the members of the project can access the information within the project.
- "view": Anyone in the team can view the information in within the project.
sharingPolicySettings
object
required
Possible values: [private
, view
]
Default value: private
Team access
Default value: project_settings
Type of the object
{
"sharingPolicySettings": {
"teamAccess": "private"
},
"type": "project_settings"
}
Malformed request
- application/json
- Schema
- Example (from schema)
Schema
Default value: 400
HTTP status code.
Default value: invalidParameters
Description of the status code.
Explanation of the error.
Default value: error
{
"status": 400,
"code": "invalidParameters",
"message": "string",
"type": "error"
}
Invalid authentication credentials
- application/json
- Schema
- Example (from schema)
Schema
Default value: 401
HTTP status code.
Default value: tokenNotProvided
Description of the status code.
Explanation of the error.
Default value: error
{
"status": 401,
"code": "tokenNotProvided",
"message": "string",
"type": "error"
}
Invalid access
- application/json
- Schema
- Example (from schema)
Schema
Default value: 403
HTTP status code.
Description of the status code.
Explanation of the error.
Default value: error
{
"status": 403,
"code": "forbiddenAccess",
"message": "string",
"type": "error"
}
Not found
- application/json
- Schema
- Example (from schema)
Schema
Default value: 404
HTTP status code.
Description of the status code.
Explanation of the error.
Default value: error
{
"status": 404,
"code": "notFound",
"message": "string",
"type": "error"
}
Conflict
- application/json
- Schema
- Example (from schema)
Schema
Default value: 409
HTTP status code.
Description of the status code.
Explanation of the error.
Default value: error
{
"status": 409,
"code": "conflict",
"message": "string",
"type": "error"
}
Too many requests
- application/json
- Schema
- Example (from schema)
Schema
Default value: 429
HTTP status code.
Description of the status code.
Explanation of the error.
Default value: error
{
"status": 429,
"code": "tooManyRequests",
"message": "string",
"type": "error"
}