Use case: Check Required Jira Permissions

Before you start

  1. Verify Permissions: Ensure you have permission to access Jira projects and configurations in your Unity Organization. Typically, this means being an admin or having specific collaboration settings access.
  2. Organization Context: Know the Organization identifier (GUID) of the Unity Organization where the Jira server is configured.
  3. Jira ServerConfig ID: Obtain the unique identifier (GUID) of the Jira ServerConfig.
  4. Jira Project ID: Obtain the unique identifier (GUID) of the Jira project to check permissions for.

How do I...?

To check if the Jira configuration has the required permissions:

  1. Get the Organization ID: Identify the Unity Organization where the Jira server is configured.
  2. Get the Jira ServerConfig ID: Obtain the ServerConfig ID to use for the request.
  3. Get the Jira Project ID: Obtain the Jira project ID to check permissions for.
  4. Use the SDK: Call the HasRequiredPermissionsAsync method in the Unity Collaboration SDK with the required properties.
  5. Process the Response: Review the result to confirm if the configuration has the necessary permissions.

Example:

var result = await jiraManagementService.HasRequiredPermissionsAsync(
    organizationId: organizationId,
    jiraServerConfigId: jiraServerConfigId,
    jiraProjectId: jiraProjectId,
    cancellationToken: cancellationToken);

Error Handling

  • 400 Bad Request: Invalid input.
  • 401 Unauthorized: Authentication required.
  • 403 Forbidden: Insufficient permissions.