Get project settings
GET/v2/orgs/:org_id/teams/:team_id/projects/:project_id/settings
Retrieves the project settings.
Required scope
projects:readRate 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 for which you want to retrieve the project settings.
Responses
- 200
- 400
- 401
- 403
- 404
- 429
Defines the sharing policies for the boards within the project.
- 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"
}
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"
}