Add Project Grant
POSThttps://$CUSTOM-DOMAIN/management/v1/projects/:projectId/grants
Grant a project to another organization. The project grant will allow the granted organization to access the project and manage the authorizations for its users. Project Grant will be listed in the granted project of the granted organization
Request​
Path Parameters
projectId stringrequired
Header Parameters
x-zitadel-orgid string
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
grantedOrgId string
roleKeys string[]
Body
required
grantedOrgId string
roleKeys string[]
Body
required
grantedOrgId string
roleKeys string[]
Responses​
- 200
- default
A successful response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
grantId string
details
object
{
"grantId": "28746028909593987",
"details": {
"sequence": "2",
"creationDate": "2025-03-25T15:37:46.330Z",
"changeDate": "2025-03-25T15:37:46.330Z",
"resourceOwner": "69629023906488334"
}
}
- Schema
- Example (from schema)
Schema
grantId string
details
object
{
"grantId": "28746028909593987",
"details": {
"sequence": "2",
"creationDate": "2025-03-25T15:37:46.331Z",
"changeDate": "2025-03-25T15:37:46.331Z",
"resourceOwner": "69629023906488334"
}
}
- Schema
- Example (from schema)
Schema
grantId string
details
object
{
"grantId": "28746028909593987",
"details": {
"sequence": "2",
"creationDate": "2025-03-25T15:37:46.331Z",
"changeDate": "2025-03-25T15:37:46.331Z",
"resourceOwner": "69629023906488334"
}
}
An unexpected error response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
code int32
message string
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
code int32
message string
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
code int32
message string
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- curl
- python
- go
- nodejs
- ruby
- csharp
- php
- java
- powershell
- CURL
curl -L 'https://$CUSTOM-DOMAIN/management/v1/projects/:projectId/grants' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
"grantedOrgId": "28746028909593987",
"roleKeys": [
"RoleKey1",
"RoleKey2"
]
}'
ResponseClear