Skip to main content
Grant or change one active organization member's project role

Authorizations

Authorization
string
header
required

Opaque control credential

Headers

Idempotency-Key
string
required
Required string length: 8 - 128
Pattern: ^[A-Za-z0-9._:-]+$

Path Parameters

projectId
string
required
Pattern: ^prj_[0-9a-z]{12,32}$

Body

application/json
subjectId
string
required
Pattern: ^usr_[0-9a-z]{12,32}$
role
enum<string>
required
Available options:
viewer,
builder,
manager
expectedVersion
integer
Required range: -9007199254740991 <= x <= 9007199254740991

Response

Updated project grant

schemaVersion
enum<number>
required
Available options:
1
grantId
string
required
Pattern: ^grant_[0-9a-z]{12,32}$
organizationId
string
required
Pattern: ^org_[0-9a-z]{12,32}$
projectId
string
required
Pattern: ^prj_[0-9a-z]{12,32}$
subjectId
string
required
Pattern: ^usr_[0-9a-z]{12,32}$
role
enum<string>
required
Available options:
viewer,
builder,
manager
actions
enum<string>[]
required
Required array length: 1 - 45 elements
Available options:
profile.read,
profile.manage,
organization.read,
organization.manage,
organization.billing.read,
organization.billing.manage,
organization.audit.read,
organization.evidence.export,
organization.members.manage,
project.create,
project.read,
project.manage,
project.members.manage,
repository.read,
repository.connect,
repository.sync,
build.read,
build.publish,
environment.read,
environment.create,
environment.promote,
environment.archive,
session.read,
session.create,
session.control,
session.destroy,
drill.read,
drill.run,
run.read,
run.cancel,
run.compare,
evidence.read,
evidence.delete,
evidence.share,
evidence.export,
evidence.upload,
credential.manage,
tool.read,
tool.publish,
authoring.read,
authoring.run,
authoring.publish,
ci.execute
createdAtMs
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
version
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991