Use case: Link a Unity Project to a Jira Project Configuration

Before you start

  1. Verify Permissions: Ensure you have permission to manage Jira integrations in your Unity Organization. Typically, this means being an admin or having specific collaboration settings access.
  2. Project Context: Know the Unity Project ID you want to link.
  3. Jira ProjectConfig ID: Obtain the unique identifier (GUID) of the Jira ProjectConfig to link to the Unity project.

How do I...?

To link a Unity project to a Jira ProjectConfig:

  1. Get the Project ID: Identify the Unity Project to link.
  2. Get the Jira ProjectConfig ID: Obtain the ProjectConfig ID to use for the request.
  3. Use the SDK: Call the LinkProjectAsync method in the Unity Collaboration SDK with the required properties.
  4. Confirm the Link: Ensure the Unity project is now associated with the Jira ProjectConfig.

Example:

await jiraManagementService.LinkProjectAsync(
    projectId: projectId,
    jiraProjectConfigId: jiraProjectConfigId,
    cancellationToken: cancellationToken);

Error Handling

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