Skip to main content

Permissions reference

View Markdown

Temporal Cloud access controls are organized across three scopes:

  • Account-level role permissions
  • Project-level permissions
  • Namespace-level permissions

Within each scope, permissions apply to publicly documented Temporal Cloud Ops API endpoints and to additional non-Cloud Ops capabilities, such as Temporal Cloud UI and internal automation behaviors.

Account-level access​

Account-level access is granted to users and service accounts by assigning them an account-level role. Temporal Cloud supports the following account-level roles:

  • Account Owner
  • Global Admin
  • Developer
  • Finance Admin
  • Read-Only
  • Metrics Read-Only

Cloud Ops API permissions​

The Metrics Read-Only role grants no Cloud Ops API permissions, so it is not included in the following table. For its permissions and API key requirements, see Metrics Read-Only role.

This table provides API-level details for permissions granted through account-level roles. These permissions are configured per user.

PermissionRead-onlyDeveloperFinance AdminGlobal AdminAccount Owner
AddUserGroupMember Global Admin Account Owner
CreateAccountAuditLogSink Global Admin Account Owner
CreateApiKey Read-only* Developer* Finance Admin* Global Admin* Account Owner*
CreateBillingReport Finance Admin Account Owner
CreateConnectivityRule Global Admin Account Owner
CreateNamespace Developer Global Admin Account Owner
CreateNexusEndpoint Developer Global Admin Account Owner
CreateProject Developer Global Admin Account Owner
CreateServiceAccount Read-only† Developer† Finance Admin† Global Admin† Account Owner†
CreateUser Global Admin Account Owner
CreateUserGroup Global Admin Account Owner
DeleteAccountAuditLogSink Global Admin Account Owner
DeleteApiKey Read-only* Developer* Finance Admin* Global Admin* Account Owner*
DeleteConnectivityRule Global Admin Account Owner
DeleteNexusEndpoint Developer Global Admin Account Owner
DeleteServiceAccount Read-only† Developer† Finance Admin† Global Admin† Account Owner†
DeleteUser Global Admin Account Owner
DeleteUserGroup Global Admin Account Owner
GetAccount Read-only Developer Finance Admin Global Admin Account Owner
GetAccountAuditLogSink Global Admin Account Owner
GetAccountAuditLogSinks Global Admin Account Owner
GetApiKey Read-only* Developer* Finance Admin* Global Admin* Account Owner*
GetApiKeys Read-only* Developer* Finance Admin* Global Admin* Account Owner*
GetAsyncOperation Read-only Developer Finance Admin Global Admin Account Owner
GetAuditLogs Global Admin Account Owner
GetBillingReport Finance Admin Account Owner
GetConnectivityRule Developer Global Admin Account Owner
GetConnectivityRules Developer Global Admin Account Owner
GetCurrentIdentity Read-only Developer Finance Admin Global Admin Account Owner
GetNamespaces Read-only Developer Finance Admin Global Admin Account Owner
GetNexusEndpoint Read-only Developer Finance Admin Global Admin Account Owner
GetNexusEndpoints Read-only Developer Finance Admin Global Admin Account Owner
GetProjects Read-only Developer Finance Admin Global Admin Account Owner
GetRegion Read-only Developer Finance Admin Global Admin Account Owner
GetRegions Read-only Developer Finance Admin Global Admin Account Owner
GetServiceAccount Read-only† Developer† Finance Admin† Global Admin† Account Owner†
GetServiceAccounts Read-only† Developer† Finance Admin† Global Admin† Account Owner†
GetUsage Finance Admin Global Admin Account Owner
GetUser Read-only‡ Developer‡ Finance Admin‡ Global Admin‡ Account Owner‡
GetUserGroup Read-only Developer Finance Admin Global Admin Account Owner
GetUserGroupMembers Read-only Developer Finance Admin Global Admin Account Owner
GetUserGroups Read-only Developer Finance Admin Global Admin Account Owner
GetUsers Read-only‡ Developer‡ Finance Admin‡ Global Admin‡ Account Owner‡
MoveNamespaceToProject Global Admin§ Account Owner§
RemoveUserGroupMember Global Admin Account Owner
UpdateAccount Global Admin Account Owner
UpdateAccountAuditLogSink Global Admin Account Owner
UpdateApiKey Read-only* Developer* Finance Admin* Global Admin* Account Owner*
UpdateNamespaceTags Global Admin Account Owner
UpdateNexusEndpoint Developer Global Admin Account Owner
UpdateServiceAccount Read-only† Developer† Finance Admin† Global Admin† Account Owner†
UpdateUser Global Admin Account Owner
UpdateUserGroup Global Admin Account Owner
ValidateAccountAuditLogSink Global Admin Account Owner

Namespace-level permissions​

Namespace-level permissions are granted to users and service accounts by assigning them a Namespace-level permission. Temporal Cloud supports the following Namespace-level permissions:

  • Namespace Admin
  • Write
  • Read

Users with the Global Admin and Account Owner roles automatically have Namespace Admin permissions on all Namespaces in the account.

Cloud Ops API permissions​

This table provides API-level details for permissions granted through Namespace-level permissions. These permissions are configured per Namespace per user.

PermissionReadWriteNamespace Admin
AddNamespaceRegion Namespace Admin
CreateNamespaceExportSink Namespace Admin
DeleteNamespace Namespace Admin
DeleteNamespaceExportSink Namespace Admin
DeleteNamespaceRegion Namespace Admin
FailoverNamespaceRegion Namespace Admin
GetNamespace Read Write Namespace Admin
GetNamespaceCapacityInfo Read Write Namespace Admin
GetNamespaceExportSink Read Write Namespace Admin
GetNamespaceExportSinks Read Write Namespace Admin
GetUserNamespaceAssignments Namespace Admin
RenameCustomSearchAttribute Namespace Admin
SetServiceAccountNamespaceAccess Namespace Admin
SetUserGroupNamespaceAccess Namespace Admin
SetUserNamespaceAccess Namespace Admin
UpdateNamespace Namespace Admin
UpdateNamespaceExportSink Namespace Admin
ValidateNamespaceExportSink Namespace Admin

Workflow-level permissions​

This table provides API-level details for Workflow-level Data Plane permissions granted through Namespace-level permissions. These permissions are configured per Namespace per user.

PermissionReadWriteNamespace Admin
CountActivityExecutions Read Write Namespace Admin
CountSchedules Read Write Namespace Admin
CountWorkflowExecutions Read Write Namespace Admin
CreateSchedule Write Namespace Admin
CreateWorkflowRule Write Namespace Admin
DeleteActivityExecution Write Namespace Admin
DeleteSchedule Write Namespace Admin
DeleteWorkerDeployment Write Namespace Admin
DeleteWorkerDeploymentVersion Write Namespace Admin
DeleteWorkflowExecution Write Namespace Admin
DeleteWorkflowRule Write Namespace Admin
DescribeActivityExecution Read Write Namespace Admin
DescribeBatchOperation Read Write Namespace Admin
DescribeNamespace Read Write Namespace Admin
DescribeSchedule Read Write Namespace Admin
DescribeTaskQueue Read Write Namespace Admin
DescribeWorker Read Write Namespace Admin
DescribeWorkerDeployment Read Write Namespace Admin
DescribeWorkerDeploymentVersion Read Write Namespace Admin
DescribeWorkflowExecution Read Write Namespace Admin
DescribeWorkflowRule Read Write Namespace Admin
ExecuteMultiOperation Write Namespace Admin
FetchWorkerConfig Read Write Namespace Admin
GetSearchAttributes Read Write Namespace Admin
GetWorkerBuildIdCompatibility Read Write Namespace Admin
GetWorkerTaskReachability Read Write Namespace Admin
GetWorkerVersioningRules Read Write Namespace Admin
GetWorkflowExecutionHistory Read Write Namespace Admin
GetWorkflowExecutionHistoryReverse Read Write Namespace Admin
ListActivityExecutions Read Write Namespace Admin
ListBatchOperations Read Write Namespace Admin
ListClosedWorkflowExecutions Read Write Namespace Admin
ListOpenWorkflowExecutions Read Write Namespace Admin
ListScheduleMatchingTimes Read Write Namespace Admin
ListSchedules Read Write Namespace Admin
ListTaskQueuePartitions Read Write Namespace Admin
ListWorkerDeployments Read Write Namespace Admin
ListWorkers Read Write Namespace Admin
ListWorkflowExecutions Read Write Namespace Admin
ListWorkflowRules Read Write Namespace Admin
PatchSchedule Write Namespace Admin
PauseActivity Write Namespace Admin
PauseWorkflowExecution Write Namespace Admin
PollActivityExecution Write Namespace Admin
PollActivityTaskQueue Write Namespace Admin
PollNexusTaskQueue Write Namespace Admin
PollWorkflowExecutionUpdate Write Namespace Admin
PollWorkflowTaskQueue Write Namespace Admin
QueryWorkflow Read Write Namespace Admin
RecordActivityTaskHeartbeat Write Namespace Admin
RecordActivityTaskHeartbeatById Write Namespace Admin
RecordWorkerHeartbeat Write Namespace Admin
RequestCancelActivityExecution Write Namespace Admin
RequestCancelWorkflowExecution Write Namespace Admin
ResetActivity Write Namespace Admin
ResetStickyTaskQueue Write Namespace Admin
ResetWorkflowExecution Write Namespace Admin
RespondActivityTaskCanceled Write Namespace Admin
RespondActivityTaskCanceledById Write Namespace Admin
RespondActivityTaskCompleted Write Namespace Admin
RespondActivityTaskCompletedById Write Namespace Admin
RespondActivityTaskFailed Write Namespace Admin
RespondActivityTaskFailedById Write Namespace Admin
RespondNexusTaskCompleted Write Namespace Admin
RespondNexusTaskFailed Write Namespace Admin
RespondQueryTaskCompleted Write Namespace Admin
RespondWorkflowTaskCompleted Write Namespace Admin
RespondWorkflowTaskFailed Write Namespace Admin
SetWorkerDeploymentCurrentVersion Write Namespace Admin
SetWorkerDeploymentManager Write Namespace Admin
SetWorkerDeploymentRampingVersion Write Namespace Admin
ShutdownWorker Write Namespace Admin
SignalWithStartWorkflowExecution Write Namespace Admin
SignalWorkflowExecution Write Namespace Admin
StartActivityExecution Write Namespace Admin
StartBatchOperation Write Namespace Admin
StartWorkflowExecution Write Namespace Admin
StopBatchOperation Write Namespace Admin
TerminateActivityExecution Write Namespace Admin
TerminateWorkflowExecution Write Namespace Admin
TriggerWorkflowRule Write Namespace Admin
UnpauseActivity Write Namespace Admin
UnpauseWorkflowExecution Write Namespace Admin
UpdateActivityOptions Write Namespace Admin
UpdateSchedule Write Namespace Admin
UpdateTaskQueueConfig Write Namespace Admin
UpdateWorkerBuildIdCompatibility Write Namespace Admin
UpdateWorkerConfig Write Namespace Admin
UpdateWorkerDeploymentVersionMetadata Write Namespace Admin
UpdateWorkerVersioningRules Write Namespace Admin
UpdateWorkflowExecution Write Namespace Admin
UpdateWorkflowExecutionOptions Write Namespace Admin

Project-level permissions​

Project-level permissions are granted to users, groups, and service accounts by assigning them a Project-level role. Temporal Cloud supports the following Project-level roles:

  • Project Admin
  • Project Write
  • Project Read
  • Project Contribute
  • Project List
  • Project Member

Users with the Global Admin and Account Owner roles automatically have Project Admin on all Projects in the account.

Project Admin, Project Write, and Project Read also grant Namespace Admin, Write, and Read respectively on every Namespace in the Project. Project Contribute, Project List, and Project Member grant no Namespace-level access. This is why Project Read and Project List grant the same Cloud Ops API permissions, as do Project Write and Project Contribute: they differ in the Namespace-level and Workflow-level permissions they carry, not in the Cloud Ops API endpoints they can call.

Cloud Ops API permissions​

This table provides API-level details for permissions granted through Project-level roles. These permissions are configured per Project per user.

These permissions control who can manage Nexus Endpoints in the Project. They do not restrict which Namespaces can call an Endpoint at runtime, which continues to be controlled by the Endpoint allowlist. See Use Nexus across Projects.

PermissionMemberListReadContributeWriteProject Admin
CreateConnectivityRule Contribute Write Project Admin
CreateNamespace Contribute Write Project Admin
CreateNexusEndpoint Contribute Write Project Admin
CreateServiceAccount Project Admin†
DeleteConnectivityRule Contribute Write Project Admin
DeleteNexusEndpoint Contribute Write Project Admin
DeleteProject Project Admin
GetConnectivityRule List Read Contribute Write Project Admin
GetConnectivityRules List Read Contribute Write Project Admin
GetNamespaces Member List Read Contribute Write Project Admin
GetNexusEndpoint List Read Contribute Write Project Admin
GetNexusEndpoints List Read Contribute Write Project Admin
GetProject Member List Read Contribute Write Project Admin
GetProjectScopedServiceAccounts Project Admin
GetServiceAccount List† Read† Contribute† Write† Project Admin†
GetServiceAccountProjectAssignments Project Admin
GetServiceAccounts List† Read† Contribute† Write† Project Admin†
GetUserGroupProjectAssignments Project Admin
GetUserProjectAssignments Project Admin
MoveNamespaceToProject Project Admin§
SetServiceAccountProjectAccess Project Admin
SetUserGroupProjectAccess Project Admin
SetUserProjectAccess Project Admin
UpdateNexusEndpoint Contribute Write Project Admin
UpdateProject Project Admin

Project Developer is a compatibility role that users with the Account Developer role inherit automatically. It cannot be assigned directly. It grants everything Project Contribute grants except CreateConnectivityRule and DeleteConnectivityRule, and carries no Namespace-level access. For details, see Project roles.

Custom Role permissions reference​

The following tables list the permission action strings available when defining Custom Roles. Use these strings in the actions field of a Custom Role permission grant.

Not all Cloud Ops API operations can be assigned to a Custom Role. For details on which operations are excluded and why, see Available permissions.

Account permissions​

PermissionCloud Ops APIResource type
cloud.account.getGetAccountAccount
cloud.account.updateUpdateAccountAccount
cloud.asyncoperation.getGetAsyncOperationAccount
cloud.auditlog.createSinkCreateAccountAuditLogSinkAccount
cloud.auditlog.deleteSinkDeleteAccountAuditLogSinkAccount
cloud.auditlog.getSinkGetAccountAuditLogSinkAccount
cloud.auditlog.listGetAuditLogsAccount
cloud.auditlog.listSinksGetAccountAuditLogSinksAccount
cloud.auditlog.updateSinkUpdateAccountAuditLogSinkAccount
cloud.auditlog.validateSinkValidateAccountAuditLogSinkAccount
cloud.billingreport.createCreateBillingReportAccount
cloud.billingreport.getGetBillingReportAccount
cloud.connectivityrule.listGetConnectivityRulesAccount, Project
cloud.customrole.createCreateCustomRoleAccount, Project
cloud.customrole.listGetCustomRolesAccount, Project
cloud.namespace.listGetNamespacesAccount, Project
cloud.nexusendpoint.listGetNexusEndpointsAccount, Project
cloud.region.getGetRegionAccount
cloud.region.listGetRegionsAccount
cloud.usage.getGetUsageAccount
cloud.user.createCreateUserAccount
cloud.user.deleteDeleteUserAccount
cloud.user.getGetUserAccount
cloud.user.listGetUsersAccount
cloud.usergroup.addMemberAddUserGroupMemberAccount
cloud.usergroup.createCreateUserGroupAccount
cloud.usergroup.deleteDeleteUserGroupAccount
cloud.usergroup.getGetUserGroupAccount
cloud.usergroup.getMembersGetUserGroupMembersAccount
cloud.usergroup.listGetUserGroupsAccount
cloud.usergroup.removeMemberRemoveUserGroupMemberAccount

Namespace permissions​

PermissionCloud Ops APIResource type
cloud.namespace.addRegionAddNamespaceRegionNamespace
cloud.namespace.callerratelimit.createCreateCallerRateLimitNamespace
cloud.namespace.callerratelimit.deleteDeleteCallerRateLimitNamespace
cloud.namespace.callerratelimit.getGetCallerRateLimitNamespace
cloud.namespace.callerratelimit.listGetCallerRateLimitsNamespace
cloud.namespace.callerratelimit.updateUpdateCallerRateLimitNamespace
cloud.namespace.capacityinfo.getGetNamespaceCapacityInfoNamespace
cloud.namespace.deleteDeleteNamespaceNamespace
cloud.namespace.deleteRegionDeleteNamespaceRegionNamespace
cloud.namespace.exportsink.createCreateNamespaceExportSinkNamespace
cloud.namespace.exportsink.deleteDeleteNamespaceExportSinkNamespace
cloud.namespace.exportsink.getGetNamespaceExportSinkNamespace
cloud.namespace.exportsink.listGetNamespaceExportSinksNamespace
cloud.namespace.exportsink.updateUpdateNamespaceExportSinkNamespace
cloud.namespace.exportsink.validateValidateNamespaceExportSinkNamespace
cloud.namespace.failoverRegionFailoverNamespaceRegionNamespace
cloud.namespace.getGetNamespaceNamespace
cloud.namespace.getServiceAccountNamespaceAssignmentsGetServiceAccountNamespaceAssignmentsNamespace
cloud.namespace.getUserGroupNamespaceAssignmentsGetUserGroupNamespaceAssignmentsNamespace
cloud.namespace.getUserNamespaceAssignmentsGetUserNamespaceAssignmentsNamespace
cloud.namespace.renameCustomSearchAttributeRenameCustomSearchAttributeNamespace
cloud.namespace.setUserAccessSetUserNamespaceAccessNamespace
cloud.namespace.setUserGroupAccessSetUserGroupNamespaceAccessNamespace
cloud.namespace.updateUpdateNamespaceNamespace
cloud.namespace.updateTagsUpdateNamespaceTagsNamespace

Project permissions​

PermissionCloud Ops APIResource type
cloud.connectivityrule.createCreateConnectivityRuleProject
cloud.connectivityrule.listGetConnectivityRulesAccount, Project
cloud.customrole.createCreateCustomRoleAccount, Project
cloud.customrole.listGetCustomRolesAccount, Project
cloud.namespace.createCreateNamespaceProject
cloud.namespace.listGetNamespacesAccount, Project
cloud.nexusendpoint.createCreateNexusEndpointProject
cloud.nexusendpoint.listGetNexusEndpointsAccount, Project

Nexus Endpoint permissions​

PermissionCloud Ops APIResource type
cloud.nexusendpoint.deleteDeleteNexusEndpointNexus Endpoint
cloud.nexusendpoint.getGetNexusEndpointNexus Endpoint
cloud.nexusendpoint.updateUpdateNexusEndpointNexus Endpoint

Connectivity Rule permissions​

PermissionCloud Ops APIResource type
cloud.connectivityrule.deleteDeleteConnectivityRuleConnectivity Rule
cloud.connectivityrule.getGetConnectivityRuleConnectivity Rule

Custom Role permissions​

PermissionCloud Ops APIResource type
cloud.customrole.deleteDeleteCustomRoleCustom Role
cloud.customrole.getGetCustomRoleCustom Role
cloud.customrole.updateUpdateCustomRoleCustom Role

Additional authorization behaviors​

Some APIs are granted to all account-level roles but enforce additional authorization rules at runtime. The action group grants access to call the API, but the scope of what the caller can interact with depends on their role.

API key authorization behavior​

All roles can create and manage their own API keys. An API key inherits the permissions of its owner — it cannot grant access beyond what the owning user or service account already has.

BehaviorRead-onlyDeveloperFinance AdminGlobal AdminAccount Owner
Create, view, update, and delete own API keys Read-only Developer Finance Admin Global Admin Account Owner
View, update, and delete any API key in the account Global Admin Account Owner

Affected APIs: CreateApiKey, GetApiKey, GetApiKeys, UpdateApiKey, DeleteApiKey

Service account authorization behavior​

All roles can list service accounts within their account. However, the ability to create, update, and delete service accounts depends on the scope of the service account and the caller's role.

BehaviorRead-onlyDeveloperFinance AdminGlobal AdminAccount Owner
List all service accounts in the account Read-only Developer Finance Admin Global Admin Account Owner
Manage unscoped (account-level) service accounts Global Admin Account Owner
Manage Namespace-scoped service accounts§§§ Global Admin Account Owner
Manage Project-scoped service accounts††† Global Admin Account Owner

§ Requires Namespace Admin permission on the target Namespace. Any role can manage Namespace-scoped service accounts if they hold Namespace Admin on that Namespace.

† Requires Project Admin permission on the target Project. Any role can manage Project-scoped service accounts if they hold Project Admin on that Project.

Affected APIs: CreateServiceAccount, GetServiceAccount, GetServiceAccounts, UpdateServiceAccount, DeleteServiceAccount

User authorization behavior​

Every account-level role can call GetUser and GetUsers. The response includes the user's ID, email, and state.

Another user's access (account role, Namespace permissions, Project access, and Custom Roles) and invitation are returned only to Account Owner and Global Admin. Namespace Admin does not change this.

GetUser of the caller always includes that caller's own access.

To list who has access to a Namespace, use GetUserNamespaceAssignments.

Affected APIs: GetUser, GetUsers