Get Project By ID
Returns a project owned by the organization (no granted projects). A Project is a vessel for different applications sharing the same role context.
Path Parameters
- id string required
Header Parameters
- x-zitadel-orgid string
The default is always the organization of the requesting user. If you like to get/set a result of another organization include the header. Make sure the user has permission to access the requested data.
- 200
- default
A successful response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
project object
id stringdetails object
sequence uint64on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
creationDate date-timeon read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
changeDate date-timeon read: the timestamp of the last event reduced by the projection
on manipulation: the
resourceOwner resource_owner is the organization an object belongs toname stringstate stringPossible values: [
PROJECT_STATE_UNSPECIFIED
,PROJECT_STATE_ACTIVE
,PROJECT_STATE_INACTIVE
]Default value:
PROJECT_STATE_UNSPECIFIED
current state of the project
projectRoleAssertion describes if the roles of the user should be added to the tokenprojectRoleCheck ZITADEL checks if the user has at least one on this projecthasProjectCheck ZITADEL checks if the org of the user has permission for this projectprivateLabelingSetting Defines from where the private labeling should be triggeredPossible values: [
PRIVATE_LABELING_SETTING_UNSPECIFIED
,PRIVATE_LABELING_SETTING_ENFORCE_PROJECT_RESOURCE_OWNER_POLICY
,PRIVATE_LABELING_SETTING_ALLOW_LOGIN_USER_RESOURCE_OWNER_POLICY
]Default value:
PRIVATE_LABELING_SETTING_UNSPECIFIED
{
"project": {
"id": "69629023906488334",
"details": {
"sequence": "2",
"creationDate": "2023-05-02",
"changeDate": "2023-05-02",
"resourceOwner": "69629023906488334"
},
"name": "MyProject",
"state": "PROJECT_STATE_UNSPECIFIED",
"projectRoleAssertion": true,
"projectRoleCheck": true,
"hasProjectCheck": true,
"privateLabelingSetting": "PRIVATE_LABELING_SETTING_UNSPECIFIED"
}
}
- Schema
- Example (from schema)
Schema
project object
id stringdetails object
sequence uint64on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
creationDate date-timeon read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
changeDate date-timeon read: the timestamp of the last event reduced by the projection
on manipulation: the
resourceOwner resource_owner is the organization an object belongs toname stringstate stringPossible values: [
PROJECT_STATE_UNSPECIFIED
,PROJECT_STATE_ACTIVE
,PROJECT_STATE_INACTIVE
]Default value:
PROJECT_STATE_UNSPECIFIED
current state of the project
projectRoleAssertion describes if the roles of the user should be added to the tokenprojectRoleCheck ZITADEL checks if the user has at least one on this projecthasProjectCheck ZITADEL checks if the org of the user has permission for this projectprivateLabelingSetting Defines from where the private labeling should be triggeredPossible values: [
PRIVATE_LABELING_SETTING_UNSPECIFIED
,PRIVATE_LABELING_SETTING_ENFORCE_PROJECT_RESOURCE_OWNER_POLICY
,PRIVATE_LABELING_SETTING_ALLOW_LOGIN_USER_RESOURCE_OWNER_POLICY
]Default value:
PRIVATE_LABELING_SETTING_UNSPECIFIED
{
"project": {
"id": "69629023906488334",
"details": {
"sequence": "2",
"creationDate": "2023-05-02",
"changeDate": "2023-05-02",
"resourceOwner": "69629023906488334"
},
"name": "MyProject",
"state": "PROJECT_STATE_UNSPECIFIED",
"projectRoleAssertion": true,
"projectRoleCheck": true,
"hasProjectCheck": true,
"privateLabelingSetting": "PRIVATE_LABELING_SETTING_UNSPECIFIED"
}
}
- Schema
- Example (from schema)
Schema
project object
id stringdetails object
sequence uint64on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
creationDate date-timeon read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
changeDate date-timeon read: the timestamp of the last event reduced by the projection
on manipulation: the
resourceOwner resource_owner is the organization an object belongs toname stringstate stringPossible values: [
PROJECT_STATE_UNSPECIFIED
,PROJECT_STATE_ACTIVE
,PROJECT_STATE_INACTIVE
]Default value:
PROJECT_STATE_UNSPECIFIED
current state of the project
projectRoleAssertion describes if the roles of the user should be added to the tokenprojectRoleCheck ZITADEL checks if the user has at least one on this projecthasProjectCheck ZITADEL checks if the org of the user has permission for this projectprivateLabelingSetting Defines from where the private labeling should be triggeredPossible values: [
PRIVATE_LABELING_SETTING_UNSPECIFIED
,PRIVATE_LABELING_SETTING_ENFORCE_PROJECT_RESOURCE_OWNER_POLICY
,PRIVATE_LABELING_SETTING_ALLOW_LOGIN_USER_RESOURCE_OWNER_POLICY
]Default value:
PRIVATE_LABELING_SETTING_UNSPECIFIED
{
"project": {
"id": "69629023906488334",
"details": {
"sequence": "2",
"creationDate": "2023-05-02",
"changeDate": "2023-05-02",
"resourceOwner": "69629023906488334"
},
"name": "MyProject",
"state": "PROJECT_STATE_UNSPECIFIED",
"projectRoleAssertion": true,
"projectRoleCheck": true,
"hasProjectCheck": true,
"privateLabelingSetting": "PRIVATE_LABELING_SETTING_UNSPECIFIED"
}
}
An unexpected error response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}