Create Authorization

CreateAuthorization creates a new authorization for a user in an owned or granted project.

Note: Authorization in this context refers to role assignments, not to OAuth authorization.

Required permissions:

"user.grant.write"

Header Parameters

Connect-Protocol-Version*number

Define the version of the Connect protocol

Value in1

Connect-Timeout-Ms?number

Define the timeout, in ms

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

userId*string

UserID is the ID of the user who should be granted the authorization.

projectId*string

Project ID is the ID of the project the user should be authorized for.

organizationId*string

OrganizationID is the ID of the organization on which the authorization should be created. The organization must either own the project or have a grant for the project.

roleKeys?array<>

RoleKeys are the keys of the roles the user should be granted.

Response Body

`application/json`

curl -X POST "https://loading/zitadel.authorization.v2.AuthorizationService/CreateAuthorization" \  -H "Connect-Protocol-Version: 1" \  -H "Content-Type: application/json" \  -d '{    "userId": "string",    "projectId": "string",    "organizationId": "string"  }'

{
  "id": "string",
  "creationDate": "2023-01-15T01:30:15.01Z"
}

{
  "code": "not_found",
  "message": "string",
  "details": [
    {
      "type": "string",
      "value": "string",
      "debug": {}
    }
  ]
}

Header Parameters

Request Body

Response Body

200application/json

defaultapplication/json

`application/json`

`application/json`