---
title: "Get a permission set"
method: GET
path: "/permissions/v1/permission_set/{id}"
tags: ["Users"]
---

# Get a permission set

`GET /permissions/v1/permission_set/{id}`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/permissions/v1/permission_set/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Query parameters

- `include_users` boolean

## Response `200`

A successful response.

- S12PermissionsV1GetPermissionSetResponse: The response for GetPermissionSet.
  - `permission_set` S12PermissionsV1PermissionSetWithUsers
    - `permission_set` S12PermissionsV1PermissionSet: PermissionSet represents a permission set.
      - `identifier` S12PermissionsV1PermissionSetIdentifier: Identifier for a permission set.
        - `id` string: The ID of the permission set.
        - `type` 'PERMISSION_SET_TYPE_UNSPECIFIED' | 'PERMISSION_SET_TYPE_DEFAULT' | 'PERMISSION_SET_TYPE_CUSTOM': The possible types of permission sets. - PERMISSION_SET_TYPE_UNSPECIFIED: Unspecified permission set type. - PERMISSION_SET_TYPE_DEFAULT: Default permission set. - PERMISSION_SET_TYPE_CUSTOM: Custom permission set.
        - `name` string: The name of the permission set. Free text set by a customer admin on CreatePermissionSet/UpdatePermissionSet — tagged pii since nothing prevents a personal name being entered.
        - `description` string: The description of the permission set. Same free-text risk as `name`.
        - `allowed_seat_types` S12CommonSubscriptionSeatTypes[]: The seat types allowed for the permission set. The first element is the "minimum" allowed seat type.
        - `supports_email_less` boolean: Whether the permission set is applicable to users without an email-based username. False when the set grants any permission that is denylisted for non-email usernames (e.g. billing). Server-computed; ignored on writes.
      - `modified_at` string, date-time: Last modification time of the permission set.
      - `permissions` S12PermissionsV1Permissions: Permissions represents a set of permissions. Individual permissions can be omitted to leave them unchanged.
        - `manage_role` boolean: Permission representing "Admin"
        - `billing` boolean: Permission representing "Billing management"
        - `manage_folders` boolean: Permission representing "Site management"
        - `create_children` boolean: Permission representing "Group management"
        - `manage_users` boolean: Permission representing "User management"
        - `allow_modify_manage_data` boolean: Permission representing "Data management"
        - `manage_data` boolean: Permission representing "Data access"
        - `allow_mobile_data_access_sync` boolean: Permission representing "Mobile data access"
        - `create_template` boolean: Permission representing "Template creation"
        - `manage_response_sets` boolean: Permission representing "Manage response sets"
        - `share_public_library` boolean: Permission representing "Upload to Public Library"
        - `manage_report_preferences` boolean: Permission representing "Manage global report layouts"
        - `create_schedules` boolean: Permission representing "Schedule creation"
        - `manage_schedules` boolean: Permission representing "Schedule management"
        - `manage_incidents` boolean: Permission representing "Issues management"
        - `incident_access` boolean: Permission representing "Issues access"
        - `manage_sensors` boolean: Permission representing "Sensor management"
        - `view_sensors` boolean: Permission representing "Sensors access"
        - `create_heads_up` boolean: Permission representing "Create Heads up"
        - `manage_assets` boolean: Permission representing "Assets management"
        - `view_assets` boolean: Permission representing "Assets access"
        - `view_training` boolean: Permission representing "Training access"
        - `manage_tasks` boolean: Permission representing "Manage tasks"
        - `new_report_experience` boolean: Permission representing "New report experience" Should not be used in new cases. Returned only for backwards compat.
        - `manage_training` boolean: Permission representing "Training management"
        - `create_training` boolean: Permission representing "Training creation"
        - `manage_permissions` boolean: Permission representing "Permission management"
        - `view_analytics` boolean: Permission representing "Analytics access"
        - `create_analytics` boolean: Permission representing "Analytics report creation (creator-based)"
        - `create_site_analytics` boolean: Permission representing "Analytics report creation (site-based)"
        - `manage_analytics` boolean: Permission representing "Analytics management"
        - `settings_assets` boolean: Permission representing "Assets settings"
        - `manage_credentials` boolean: Permission representing "Credentials"
        - `create_course` boolean: Permission representing "Course creation"
        - `admin_resources` boolean: Permission representing "Resources Administration"
        - `manage_training_teams` boolean: Permission representing "Manage Teams"
        - `manage_companies` boolean: Permission representing "Manage Companies"
        - `manage_assets_media` boolean: Permission representing "Manage Assets media"
        - `manage_assets_maintenance` boolean: Permission representing "Manage Assets maintenance"
        - `settings_lone_worker` boolean: Permission representing "Lone worker settings"
        - `manage_lone_worker` boolean: Permission representing "Manage Lone Workers"
        - `access_lone_worker` boolean: Permission representing "Access Lone Workers"
        - `access_investigations` boolean: Permission representing "Create Investigations"
        - `manage_investigations` boolean: Permission representing "Manage Investigations"
        - `manage_heads_up` boolean: Permission representing "Manage Heads Up"
        - `configuration_investigations` boolean: Permission representing "Configuration Investigations"
        - `view_investigations` boolean: Permission representing "Read Investigations"
        - `access_osha` boolean: Permission representing "Access OSHA"
        - `view_inductions` boolean: Permission representing "Access Onboarding"
        - `access_ai_assistant` boolean: Permission representing "Access AI Assistant"
        - `manage_fields` boolean: Permission representing "Manage Fields"
        - `manage_content_library_publish` boolean: Permission representing "Content Library Publish"
        - `admin_manufacturing` boolean: Permission representing "Manufacturing Admin"
        - `operator_manufacturing` boolean: Permission representing "Manufacturing Operator"
        - `read_mcp` boolean: Permission representing "MCP Read"
        - `write_mcp` boolean: Permission representing "MCP Write"
        - `create_inspection` boolean: Permission representing "Conduct inspections"
        - `create_action` boolean: Permission representing "Create actions"
        - `view_companies` boolean: Permission representing "View Companies"
        - `approve_companies` boolean: Permission representing "Approve Companies"
        - `view_action` boolean: Permission representing "View Actions"
        - `view_construction` boolean: Permission representing "View Construction"
        - `view_content_library` boolean: Permission representing "View Content Library"
        - `view_documents` boolean: Permission representing "View Documents"
        - `view_groups` boolean: Permission representing "View Groups"
        - `view_heads_up` boolean: Permission representing "View Heads Up"
        - `view_inspection` boolean: Permission representing "View Inspections"
        - `view_marketplace` boolean: Permission representing "View Marketplace"
        - `view_qsr` boolean: Permission representing "View QSR"
        - `view_schedules` boolean: Permission representing "View Schedules"
        - `view_sign_on` boolean: Permission representing "View Sign On"
        - `view_sites` boolean: Permission representing "View Sites"
        - `view_template` boolean: Permission representing "View Templates"
        - `view_users` boolean: Permission representing "View Users"
        - `manage_labels` boolean: Permission representing "Manage labels"
        - `print_labels` boolean: Permission representing "Print labels"
      - `default_for_seat_types` S12CommonSubscriptionSeatTypes[]: The seat types that this permission set is the default for.
      - `permissions_denylist` S12PermissionsV1Permissions: Permissions represents a set of permissions. Individual permissions can be omitted to leave them unchanged.
        - `manage_role` boolean: Permission representing "Admin"
        - `billing` boolean: Permission representing "Billing management"
        - `manage_folders` boolean: Permission representing "Site management"
        - `create_children` boolean: Permission representing "Group management"
        - `manage_users` boolean: Permission representing "User management"
        - `allow_modify_manage_data` boolean: Permission representing "Data management"
        - `manage_data` boolean: Permission representing "Data access"
        - `allow_mobile_data_access_sync` boolean: Permission representing "Mobile data access"
        - `create_template` boolean: Permission representing "Template creation"
        - `manage_response_sets` boolean: Permission representing "Manage response sets"
        - `share_public_library` boolean: Permission representing "Upload to Public Library"
        - `manage_report_preferences` boolean: Permission representing "Manage global report layouts"
        - `create_schedules` boolean: Permission representing "Schedule creation"
        - `manage_schedules` boolean: Permission representing "Schedule management"
        - `manage_incidents` boolean: Permission representing "Issues management"
        - `incident_access` boolean: Permission representing "Issues access"
        - `manage_sensors` boolean: Permission representing "Sensor management"
        - `view_sensors` boolean: Permission representing "Sensors access"
        - `create_heads_up` boolean: Permission representing "Create Heads up"
        - `manage_assets` boolean: Permission representing "Assets management"
        - `view_assets` boolean: Permission representing "Assets access"
        - `view_training` boolean: Permission representing "Training access"
        - `manage_tasks` boolean: Permission representing "Manage tasks"
        - `new_report_experience` boolean: Permission representing "New report experience" Should not be used in new cases. Returned only for backwards compat.
        - `manage_training` boolean: Permission representing "Training management"
        - `create_training` boolean: Permission representing "Training creation"
        - `manage_permissions` boolean: Permission representing "Permission management"
        - `view_analytics` boolean: Permission representing "Analytics access"
        - `create_analytics` boolean: Permission representing "Analytics report creation (creator-based)"
        - `create_site_analytics` boolean: Permission representing "Analytics report creation (site-based)"
        - `manage_analytics` boolean: Permission representing "Analytics management"
        - `settings_assets` boolean: Permission representing "Assets settings"
        - `manage_credentials` boolean: Permission representing "Credentials"
        - `create_course` boolean: Permission representing "Course creation"
        - `admin_resources` boolean: Permission representing "Resources Administration"
        - `manage_training_teams` boolean: Permission representing "Manage Teams"
        - `manage_companies` boolean: Permission representing "Manage Companies"
        - `manage_assets_media` boolean: Permission representing "Manage Assets media"
        - `manage_assets_maintenance` boolean: Permission representing "Manage Assets maintenance"
        - `settings_lone_worker` boolean: Permission representing "Lone worker settings"
        - `manage_lone_worker` boolean: Permission representing "Manage Lone Workers"
        - `access_lone_worker` boolean: Permission representing "Access Lone Workers"
        - `access_investigations` boolean: Permission representing "Create Investigations"
        - `manage_investigations` boolean: Permission representing "Manage Investigations"
        - `manage_heads_up` boolean: Permission representing "Manage Heads Up"
        - `configuration_investigations` boolean: Permission representing "Configuration Investigations"
        - `view_investigations` boolean: Permission representing "Read Investigations"
        - `access_osha` boolean: Permission representing "Access OSHA"
        - `view_inductions` boolean: Permission representing "Access Onboarding"
        - `access_ai_assistant` boolean: Permission representing "Access AI Assistant"
        - `manage_fields` boolean: Permission representing "Manage Fields"
        - `manage_content_library_publish` boolean: Permission representing "Content Library Publish"
        - `admin_manufacturing` boolean: Permission representing "Manufacturing Admin"
        - `operator_manufacturing` boolean: Permission representing "Manufacturing Operator"
        - `read_mcp` boolean: Permission representing "MCP Read"
        - `write_mcp` boolean: Permission representing "MCP Write"
        - `create_inspection` boolean: Permission representing "Conduct inspections"
        - `create_action` boolean: Permission representing "Create actions"
        - `view_companies` boolean: Permission representing "View Companies"
        - `approve_companies` boolean: Permission representing "Approve Companies"
        - `view_action` boolean: Permission representing "View Actions"
        - `view_construction` boolean: Permission representing "View Construction"
        - `view_content_library` boolean: Permission representing "View Content Library"
        - `view_documents` boolean: Permission representing "View Documents"
        - `view_groups` boolean: Permission representing "View Groups"
        - `view_heads_up` boolean: Permission representing "View Heads Up"
        - `view_inspection` boolean: Permission representing "View Inspections"
        - `view_marketplace` boolean: Permission representing "View Marketplace"
        - `view_qsr` boolean: Permission representing "View QSR"
        - `view_schedules` boolean: Permission representing "View Schedules"
        - `view_sign_on` boolean: Permission representing "View Sign On"
        - `view_sites` boolean: Permission representing "View Sites"
        - `view_template` boolean: Permission representing "View Templates"
        - `view_users` boolean: Permission representing "View Users"
        - `manage_labels` boolean: Permission representing "Manage labels"
        - `print_labels` boolean: Permission representing "Print labels"
      - `supports_email_less` boolean: Whether the permission set is applicable to users without an email-based username. Derived from `permissions` and the non-email username denylist; mirrors PermissionSetIdentifier.supports_email_less for callers consuming the full PermissionSet. Server-computed; ignored on writes.
    - `users` string[]: A subset of the users assigned to the permission set.
    - `user_count` integer: The number of users assigned to the permission set.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `eb6bb843bf18`: 44 info
  - added the optional property `permission_set/allOf[subschema #1: A permission set and its users]/permission_set/allOf[#/components/schemas/s12.permissions.v1.PermissionSet]/permissions/allOf[#/components/schemas/s12.permissions.v1.Permissions]/approve_companies` to the response with the `200` status
  - added the optional property `permission_set/allOf[subschema #1: A permission set and its users]/permission_set/allOf[#/components/schemas/s12.permissions.v1.PermissionSet]/permissions/allOf[#/components/schemas/s12.permissions.v1.Permissions]/create_action` to the response with the `200` status
  - added the optional property `permission_set/allOf[subschema #1: A permission set and its users]/permission_set/allOf[#/components/schemas/s12.permissions.v1.PermissionSet]/permissions/allOf[#/components/schemas/s12.permissions.v1.Permissions]/create_inspection` to the response with the `200` status
  - added the optional property `permission_set/allOf[subschema #1: A permission set and its users]/permission_set/allOf[#/components/schemas/s12.permissions.v1.PermissionSet]/permissions/allOf[#/components/schemas/s12.permissions.v1.Permissions]/manage_labels` to the response with the `200` status
  - …40 more

[Operation history](https://skmtc.dev/safetyculture/apis/safetyculture-api/changes/permissions/v1/permission_set/:id/get.md)

---

[API](https://skmtc.dev/safetyculture/apis/safetyculture-api.md) - [All operations](https://skmtc.dev/safetyculture/apis/safetyculture-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safetyculture/apis/safetyculture-api/revisions/eb6bb843bf18?raw)
