TeamCity REST API Reference 2026.2 Help

PermissionAssignmentLocator

Represents a locator string for filtering PermissionAssignment entities. Examples:

  • permission:CHANGE_USER — find assignments of the CHANGE_USER permission.

  • global:true — find globally assigned permissions.

Properties

Dimension

Data type

Format

Description

count

long

int64

For paginated calls, how many entities to return per page.

global

string

Return only globally assigned permissions.

Supported values:

  • true

  • false

  • any

permission

string

Permission to filter by.

Supported values:

  • run_build

  • cancel_build

  • cancel_any_personal_build

  • pin_unpin_build

  • tag_build

  • remove_build

  • pause_activate_build_configuration

  • comment_build

  • clean_build_configuration_sources

  • assign_investigation

  • view_project

  • view_build_configuration_settings

  • view_file_content

  • edit_vcs_modification

  • edit_project

  • change_cleanup_rules

  • backup

  • import_projects

  • customize_build_parameters

  • customize_build_revisions

  • patch_build_sources

  • create_sub_project

  • delete_sub_project

  • create_delete_vcs_root

  • change_user_roles_in_project

  • label_build

  • archive_project

  • manage_build_problems

  • manage_build_problem_instances

  • view_build_runtime_data

  • manage_agent_pools_for_project

  • edit_versioned_settings

  • edit_enforced_settings

  • enable_disable_agent_for_project

  • change_agent_run_configuration_policy_for_project

  • administer_agent_for_project

  • remove_agent_for_project

  • authorize_agent_for_project

  • view_agent_details_for_project

  • manage_agent_clouds

  • view_agent_clouds

  • start_stop_cloud_agent

  • connect_to_agent

  • change_user_notifications_in_project

  • change_vcs_username_in_project

  • create_user

  • delete_user

  • change_user

  • change_user_notifications

  • manage_server_licenses

  • change_server_settings

  • manage_authentication_settings

  • change_https_settings

  • change_agent_run_configuration_policy

  • clean_agent_sources

  • enable_disable_agent

  • authorize_agent

  • view_agent_details

  • manage_custom_ssl_certificates

  • configure_server_data_cleanup

  • change_own_profile

  • view_agent_usage_statistics

  • remove_agent

  • create_usergroup

  • delete_usergroup

  • change_usergroup

  • assign_users_add_subgroups

  • manage_roles

  • administer_agent

  • view_audit_log

  • reorder_build_queue

  • view_server_errors

  • view_usage_statistics

  • manage_agent_pools

  • view_user_profile

  • view_all_users

  • manage_server_installation

  • view_server_settings

  • manage_experimental_features

project

string

ProjectLocator

Project the permission is granted for. Note: a permission granted for a project might not be granted to it's subprojects.

start

long

int64

For paginated calls, from which entity to start rendering the page.

Last modified: 18 August 2026