Create Project
POST/projects
Create a new project. A Project is a vessel for different applications sharing the same role context.
Request​
Header Parameters
The default is always the organization of the requesting user. If you like to change/get objects of another organization include the header. Make sure the requesting user has permission to access the requested data.
- application/json
- application/grpc
- application/grpc-web+proto
Body
required
Possible values: non-empty
and <= 200 characters
Enable this setting to have role information included in the user info endpoint. It is also dependent on your application settings to include it in tokens and other types.
When enabled ZITADEL will check if a user has a role of this project assigned when login into an application of this project.
When enabled ZITADEL will check if the organization of the user, that is trying to log in, has a grant to this project.
Possible 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
Define which private labeling/branding should trigger when getting to a login of this project.
Body
required
Possible values: non-empty
and <= 200 characters
Enable this setting to have role information included in the user info endpoint. It is also dependent on your application settings to include it in tokens and other types.
When enabled ZITADEL will check if a user has a role of this project assigned when login into an application of this project.
When enabled ZITADEL will check if the organization of the user, that is trying to log in, has a grant to this project.
Possible 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
Define which private labeling/branding should trigger when getting to a login of this project.
Body
required
Possible values: non-empty
and <= 200 characters
Enable this setting to have role information included in the user info endpoint. It is also dependent on your application settings to include it in tokens and other types.
When enabled ZITADEL will check if a user has a role of this project assigned when login into an application of this project.
When enabled ZITADEL will check if the organization of the user, that is trying to log in, has a grant to this project.
Possible 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
Define which private labeling/branding should trigger when getting to a login of this project.
Responses​
- 200
- default
A successful response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
details
object
on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the last event reduced by the projection
on manipulation: the
{
"id": "98729028932384528",
"details": {
"sequence": "2",
"creationDate": "2024-12-23T07:03:27.083Z",
"changeDate": "2024-12-23T07:03:27.083Z",
"resourceOwner": "69629023906488334"
}
}
- Schema
- Example (from schema)
Schema
details
object
on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the last event reduced by the projection
on manipulation: the
{
"id": "98729028932384528",
"details": {
"sequence": "2",
"creationDate": "2024-12-23T07:03:27.083Z",
"changeDate": "2024-12-23T07:03:27.083Z",
"resourceOwner": "69629023906488334"
}
}
- Schema
- Example (from schema)
Schema
details
object
on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the last event reduced by the projection
on manipulation: the
{
"id": "98729028932384528",
"details": {
"sequence": "2",
"creationDate": "2024-12-23T07:03:27.083Z",
"changeDate": "2024-12-23T07:03:27.083Z",
"resourceOwner": "69629023906488334"
}
}
An unexpected error response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}