Use case: Retrieve Jira Configurations for a Project

Before you start

  1. Verify Permissions: Confirm that you have permission to access Jira configurations for the Unity project. Typically, this means being a project member or organization admin.
  2. Project ID: You'll need the unique Unity Project ID to query for associated Jira configurations.
  3. Understand Scope: This operation returns Jira ServerConfigs that are available or linked to the specified Unity project.

How do I...?

To get all Jira configurations available for a Unity project, follow these steps:

  1. Get the Project ID: Identify the Unity Project for which you want to fetch Jira configurations.
  2. Use the SDK: Call the GetConfigsForProjectAsync method in the Unity Collaboration SDK with the required properties.
  3. Process the Response: The response will contain information about available ServerConfigs that can be used or linked.

Example:

var configs = await jiraConfigService.GetConfigsForProjectAsync(
    projectId: projectId,
    cancellationToken: cancellationToken);

Error Handling

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