@makeplane/plane-node-sdk 0.1.4 → 0.1.5

package/src/apis/ProjectsApi.ts

@@ -4,7 +4,7 @@
  * The Plane REST API
  * The Plane REST API  Visit our quick start guide and full API documentation at [developers.plane.so](https://developers.plane.so/api-reference/introduction).
  *
- * The version of the API Spec: 0.0.1
+ * The version of the API Spec: 0.0.2
  * Contact: support@plane.so
  *
  * NOTE: This class is auto generated.

package/src/apis/StatesApi.ts

@@ -4,7 +4,7 @@
  * The Plane REST API
  * The Plane REST API  Visit our quick start guide and full API documentation at [developers.plane.so](https://developers.plane.so/api-reference/introduction).
  *
- * The version of the API Spec: 0.0.1
+ * The version of the API Spec: 0.0.2
  * Contact: support@plane.so
  *
  * NOTE: This class is auto generated.

package/src/apis/UsersApi.ts

@@ -4,7 +4,7 @@
  * The Plane REST API
  * The Plane REST API  Visit our quick start guide and full API documentation at [developers.plane.so](https://developers.plane.so/api-reference/introduction).
  *
- * The version of the API Spec: 0.0.1
+ * The version of the API Spec: 0.0.2
  * Contact: support@plane.so
  *
  * NOTE: This class is auto generated.

package/src/apis/WorkItemActivityApi.ts

@@ -4,7 +4,7 @@
  * The Plane REST API
  * The Plane REST API  Visit our quick start guide and full API documentation at [developers.plane.so](https://developers.plane.so/api-reference/introduction).
  *
- * The version of the API Spec: 0.0.1
+ * The version of the API Spec: 0.0.2
  * Contact: support@plane.so
  *
  * NOTE: This class is auto generated.

package/src/apis/WorkItemAttachmentsApi.ts

@@ -4,7 +4,7 @@
  * The Plane REST API
  * The Plane REST API  Visit our quick start guide and full API documentation at [developers.plane.so](https://developers.plane.so/api-reference/introduction).
  *
- * The version of the API Spec: 0.0.1
+ * The version of the API Spec: 0.0.2
  * Contact: support@plane.so
  *
  * NOTE: This class is auto generated.
@@ -54,6 +54,14 @@ export interface RetrieveWorkItemAttachmentRequest {
     slug: string;
 }
 
+export interface UploadWorkItemAttachmentRequest {
+    issueId: string;
+    pk: string;
+    projectId: string;
+    slug: string;
+    body?: any | null;
+}
+
 /**
  * 
  */
@@ -332,4 +340,76 @@ export class WorkItemAttachmentsApi extends runtime.BaseAPI {
         await this.retrieveWorkItemAttachmentRaw(requestParameters, initOverrides);
     }
 
+    /**
+     * Mark an attachment as uploaded after successful file transfer to storage.
+     * Endpoints for issue attachment create/update/delete and fetch issue attachment details
+     */
+    async uploadWorkItemAttachmentRaw(requestParameters: UploadWorkItemAttachmentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
+        if (requestParameters['issueId'] == null) {
+            throw new runtime.RequiredError(
+                'issueId',
+                'Required parameter "issueId" was null or undefined when calling uploadWorkItemAttachment().'
+            );
+        }
+
+        if (requestParameters['pk'] == null) {
+            throw new runtime.RequiredError(
+                'pk',
+                'Required parameter "pk" was null or undefined when calling uploadWorkItemAttachment().'
+            );
+        }
+
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling uploadWorkItemAttachment().'
+            );
+        }
+
+        if (requestParameters['slug'] == null) {
+            throw new runtime.RequiredError(
+                'slug',
+                'Required parameter "slug" was null or undefined when calling uploadWorkItemAttachment().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // ApiKeyAuthentication authentication
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            headerParameters["Authorization"] = await this.configuration.accessToken("OAuth2Authentication", []);
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            headerParameters["Authorization"] = await this.configuration.accessToken("OAuth2Authentication", []);
+        }
+
+        const response = await this.request({
+            path: `/api/v1/workspaces/{slug}/projects/{project_id}/issues/{issue_id}/issue-attachments/{pk}/`.replace(`{${"issue_id"}}`, encodeURIComponent(String(requestParameters['issueId']))).replace(`{${"pk"}}`, encodeURIComponent(String(requestParameters['pk']))).replace(`{${"project_id"}}`, encodeURIComponent(String(requestParameters['projectId']))).replace(`{${"slug"}}`, encodeURIComponent(String(requestParameters['slug']))),
+            method: 'PATCH',
+            headers: headerParameters,
+            query: queryParameters,
+            body: requestParameters['body'] as any,
+        }, initOverrides);
+
+        return new runtime.VoidApiResponse(response);
+    }
+
+    /**
+     * Mark an attachment as uploaded after successful file transfer to storage.
+     * Endpoints for issue attachment create/update/delete and fetch issue attachment details
+     */
+    async uploadWorkItemAttachment(requestParameters: UploadWorkItemAttachmentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
+        await this.uploadWorkItemAttachmentRaw(requestParameters, initOverrides);
+    }
+
 }

package/src/apis/WorkItemCommentsApi.ts

@@ -4,7 +4,7 @@
  * The Plane REST API
  * The Plane REST API  Visit our quick start guide and full API documentation at [developers.plane.so](https://developers.plane.so/api-reference/introduction).
  *
- * The version of the API Spec: 0.0.1
+ * The version of the API Spec: 0.0.2
  * Contact: support@plane.so
  *
  * NOTE: This class is auto generated.

package/src/apis/WorkItemLinksApi.ts

@@ -4,7 +4,7 @@
  * The Plane REST API
  * The Plane REST API  Visit our quick start guide and full API documentation at [developers.plane.so](https://developers.plane.so/api-reference/introduction).
  *
- * The version of the API Spec: 0.0.1
+ * The version of the API Spec: 0.0.2
  * Contact: support@plane.so
  *
  * NOTE: This class is auto generated.

package/src/apis/WorkItemPropertiesApi.ts

@@ -4,7 +4,7 @@
  * The Plane REST API
  * The Plane REST API  Visit our quick start guide and full API documentation at [developers.plane.so](https://developers.plane.so/api-reference/introduction).
  *
- * The version of the API Spec: 0.0.1
+ * The version of the API Spec: 0.0.2
  * Contact: support@plane.so
  *
  * NOTE: This class is auto generated.
@@ -100,6 +100,13 @@ export interface ListIssuePropertyValuesRequest {
     slug: string;
 }
 
+export interface ListIssuePropertyValuesForAWorkitemRequest {
+    issueId: string;
+    projectId: string;
+    propertyId: string;
+    slug: string;
+}
+
 export interface RetrieveIssuePropertyRequest {
     projectId: string;
     propertyId: string;
@@ -695,6 +702,76 @@ export class WorkItemPropertiesApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * List issue property values for a workitem
+     * List issue property values for a workitem
+     */
+    async listIssuePropertyValuesForAWorkitemRaw(requestParameters: ListIssuePropertyValuesForAWorkitemRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<IssuePropertyValueAPI>> {
+        if (requestParameters['issueId'] == null) {
+            throw new runtime.RequiredError(
+                'issueId',
+                'Required parameter "issueId" was null or undefined when calling listIssuePropertyValuesForAWorkitem().'
+            );
+        }
+
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling listIssuePropertyValuesForAWorkitem().'
+            );
+        }
+
+        if (requestParameters['propertyId'] == null) {
+            throw new runtime.RequiredError(
+                'propertyId',
+                'Required parameter "propertyId" was null or undefined when calling listIssuePropertyValuesForAWorkitem().'
+            );
+        }
+
+        if (requestParameters['slug'] == null) {
+            throw new runtime.RequiredError(
+                'slug',
+                'Required parameter "slug" was null or undefined when calling listIssuePropertyValuesForAWorkitem().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // ApiKeyAuthentication authentication
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            headerParameters["Authorization"] = await this.configuration.accessToken("OAuth2Authentication", []);
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            headerParameters["Authorization"] = await this.configuration.accessToken("OAuth2Authentication", []);
+        }
+
+        const response = await this.request({
+            path: `/api/v1/workspaces/{slug}/projects/{project_id}/issues/{issue_id}/issue-properties/values/`.replace(`{${"issue_id"}}`, encodeURIComponent(String(requestParameters['issueId']))).replace(`{${"project_id"}}`, encodeURIComponent(String(requestParameters['projectId']))).replace(`{${"property_id"}}`, encodeURIComponent(String(requestParameters['propertyId']))).replace(`{${"slug"}}`, encodeURIComponent(String(requestParameters['slug']))),
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => IssuePropertyValueAPIFromJSON(jsonValue));
+    }
+
+    /**
+     * List issue property values for a workitem
+     * List issue property values for a workitem
+     */
+    async listIssuePropertyValuesForAWorkitem(requestParameters: ListIssuePropertyValuesForAWorkitemRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<IssuePropertyValueAPI> {
+        const response = await this.listIssuePropertyValuesForAWorkitemRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Get issue property by id
      * Get issue property by id

package/src/apis/WorkItemTypesApi.ts

@@ -4,7 +4,7 @@
  * The Plane REST API
  * The Plane REST API  Visit our quick start guide and full API documentation at [developers.plane.so](https://developers.plane.so/api-reference/introduction).
  *
- * The version of the API Spec: 0.0.1
+ * The version of the API Spec: 0.0.2
  * Contact: support@plane.so
  *
  * NOTE: This class is auto generated.

package/src/apis/WorkItemWorklogsApi.ts

@@ -4,7 +4,7 @@
  * The Plane REST API
  * The Plane REST API  Visit our quick start guide and full API documentation at [developers.plane.so](https://developers.plane.so/api-reference/introduction).
  *
- * The version of the API Spec: 0.0.1
+ * The version of the API Spec: 0.0.2
  * Contact: support@plane.so
  *
  * NOTE: This class is auto generated.

package/src/apis/WorkItemsApi.ts

@@ -4,7 +4,7 @@
  * The Plane REST API
  * The Plane REST API  Visit our quick start guide and full API documentation at [developers.plane.so](https://developers.plane.so/api-reference/introduction).
  *
- * The version of the API Spec: 0.0.1
+ * The version of the API Spec: 0.0.2
  * Contact: support@plane.so
  *
  * NOTE: This class is auto generated.
@@ -16,6 +16,10 @@ import * as runtime from '../runtime';
 import type {
   Issue,
   IssueDetail,
+  IssueRelation,
+  IssueRelationCreateRequest,
+  IssueRelationRemoveRequest,
+  IssueRelationResponse,
   IssueRequest,
   IssueSearch,
   PaginatedWorkItemResponse,
@@ -26,6 +30,14 @@ import {
     IssueToJSON,
     IssueDetailFromJSON,
     IssueDetailToJSON,
+    IssueRelationFromJSON,
+    IssueRelationToJSON,
+    IssueRelationCreateRequestFromJSON,
+    IssueRelationCreateRequestToJSON,
+    IssueRelationRemoveRequestFromJSON,
+    IssueRelationRemoveRequestToJSON,
+    IssueRelationResponseFromJSON,
+    IssueRelationResponseToJSON,
     IssueRequestFromJSON,
     IssueRequestToJSON,
     IssueSearchFromJSON,
@@ -42,6 +54,13 @@ export interface CreateWorkItemRequest {
     issueRequest: IssueRequest;
 }
 
+export interface CreateWorkItemRelationRequest {
+    issueId: string;
+    projectId: string;
+    slug: string;
+    issueRelationCreateRequest: IssueRelationCreateRequest;
+}
+
 export interface DeleteWorkItemRequest {
     pk: string;
     projectId: string;
@@ -54,6 +73,17 @@ export interface GetWorkspaceWorkItemRequest {
     slug: string;
 }
 
+export interface ListWorkItemRelationsRequest {
+    issueId: string;
+    projectId: string;
+    slug: string;
+    cursor?: string;
+    expand?: string;
+    fields?: string;
+    orderBy?: string;
+    perPage?: number;
+}
+
 export interface ListWorkItemsRequest {
     projectId: string;
     slug: string;
@@ -66,6 +96,13 @@ export interface ListWorkItemsRequest {
     perPage?: number;
 }
 
+export interface RemoveWorkItemRelationRequest {
+    issueId: string;
+    projectId: string;
+    slug: string;
+    issueRelationRemoveRequest: IssueRelationRemoveRequest;
+}
+
 export interface RetrieveWorkItemRequest {
     pk: string;
     projectId: string;
@@ -163,6 +200,79 @@ export class WorkItemsApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Create relationships between work items. Supports various relation types including blocking, blocked_by, duplicate, relates_to, start_before, start_after, finish_before, and finish_after.
+     * Create work item relation
+     */
+    async createWorkItemRelationRaw(requestParameters: CreateWorkItemRelationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<IssueRelation>>> {
+        if (requestParameters['issueId'] == null) {
+            throw new runtime.RequiredError(
+                'issueId',
+                'Required parameter "issueId" was null or undefined when calling createWorkItemRelation().'
+            );
+        }
+
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling createWorkItemRelation().'
+            );
+        }
+
+        if (requestParameters['slug'] == null) {
+            throw new runtime.RequiredError(
+                'slug',
+                'Required parameter "slug" was null or undefined when calling createWorkItemRelation().'
+            );
+        }
+
+        if (requestParameters['issueRelationCreateRequest'] == null) {
+            throw new runtime.RequiredError(
+                'issueRelationCreateRequest',
+                'Required parameter "issueRelationCreateRequest" was null or undefined when calling createWorkItemRelation().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // ApiKeyAuthentication authentication
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            headerParameters["Authorization"] = await this.configuration.accessToken("OAuth2Authentication", []);
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            headerParameters["Authorization"] = await this.configuration.accessToken("OAuth2Authentication", []);
+        }
+
+        const response = await this.request({
+            path: `/api/v1/workspaces/{slug}/projects/{project_id}/issues/{issue_id}/relations/`.replace(`{${"issue_id"}}`, encodeURIComponent(String(requestParameters['issueId']))).replace(`{${"project_id"}}`, encodeURIComponent(String(requestParameters['projectId']))).replace(`{${"slug"}}`, encodeURIComponent(String(requestParameters['slug']))),
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: IssueRelationCreateRequestToJSON(requestParameters['issueRelationCreateRequest']),
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(IssueRelationFromJSON));
+    }
+
+    /**
+     * Create relationships between work items. Supports various relation types including blocking, blocked_by, duplicate, relates_to, start_before, start_after, finish_before, and finish_after.
+     * Create work item relation
+     */
+    async createWorkItemRelation(requestParameters: CreateWorkItemRelationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<IssueRelation>> {
+        const response = await this.createWorkItemRelationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Permanently delete an existing work item from the project. Only admins or the item creator can perform this action.
      * Delete work item
@@ -288,6 +398,89 @@ export class WorkItemsApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Retrieve all relationships for a work item including blocking, blocked_by, duplicate, relates_to, start_before, start_after, finish_before, and finish_after relations.
+     * List work item relations
+     */
+    async listWorkItemRelationsRaw(requestParameters: ListWorkItemRelationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<IssueRelationResponse>> {
+        if (requestParameters['issueId'] == null) {
+            throw new runtime.RequiredError(
+                'issueId',
+                'Required parameter "issueId" was null or undefined when calling listWorkItemRelations().'
+            );
+        }
+
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling listWorkItemRelations().'
+            );
+        }
+
+        if (requestParameters['slug'] == null) {
+            throw new runtime.RequiredError(
+                'slug',
+                'Required parameter "slug" was null or undefined when calling listWorkItemRelations().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
+
+        if (requestParameters['expand'] != null) {
+            queryParameters['expand'] = requestParameters['expand'];
+        }
+
+        if (requestParameters['fields'] != null) {
+            queryParameters['fields'] = requestParameters['fields'];
+        }
+
+        if (requestParameters['orderBy'] != null) {
+            queryParameters['order_by'] = requestParameters['orderBy'];
+        }
+
+        if (requestParameters['perPage'] != null) {
+            queryParameters['per_page'] = requestParameters['perPage'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // ApiKeyAuthentication authentication
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            headerParameters["Authorization"] = await this.configuration.accessToken("OAuth2Authentication", []);
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            headerParameters["Authorization"] = await this.configuration.accessToken("OAuth2Authentication", []);
+        }
+
+        const response = await this.request({
+            path: `/api/v1/workspaces/{slug}/projects/{project_id}/issues/{issue_id}/relations/`.replace(`{${"issue_id"}}`, encodeURIComponent(String(requestParameters['issueId']))).replace(`{${"project_id"}}`, encodeURIComponent(String(requestParameters['projectId']))).replace(`{${"slug"}}`, encodeURIComponent(String(requestParameters['slug']))),
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => IssueRelationResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Retrieve all relationships for a work item including blocking, blocked_by, duplicate, relates_to, start_before, start_after, finish_before, and finish_after relations.
+     * List work item relations
+     */
+    async listWorkItemRelations(requestParameters: ListWorkItemRelationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<IssueRelationResponse> {
+        const response = await this.listWorkItemRelationsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Retrieve a paginated list of all work items in a project. Supports filtering, ordering, and field selection through query parameters.
      * List work items
@@ -372,6 +565,78 @@ export class WorkItemsApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Remove a relationship between work items by specifying the related work item ID.
+     * Remove work item relation
+     */
+    async removeWorkItemRelationRaw(requestParameters: RemoveWorkItemRelationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
+        if (requestParameters['issueId'] == null) {
+            throw new runtime.RequiredError(
+                'issueId',
+                'Required parameter "issueId" was null or undefined when calling removeWorkItemRelation().'
+            );
+        }
+
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling removeWorkItemRelation().'
+            );
+        }
+
+        if (requestParameters['slug'] == null) {
+            throw new runtime.RequiredError(
+                'slug',
+                'Required parameter "slug" was null or undefined when calling removeWorkItemRelation().'
+            );
+        }
+
+        if (requestParameters['issueRelationRemoveRequest'] == null) {
+            throw new runtime.RequiredError(
+                'issueRelationRemoveRequest',
+                'Required parameter "issueRelationRemoveRequest" was null or undefined when calling removeWorkItemRelation().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // ApiKeyAuthentication authentication
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            headerParameters["Authorization"] = await this.configuration.accessToken("OAuth2Authentication", []);
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            headerParameters["Authorization"] = await this.configuration.accessToken("OAuth2Authentication", []);
+        }
+
+        const response = await this.request({
+            path: `/api/v1/workspaces/{slug}/projects/{project_id}/issues/{issue_id}/relations/remove/`.replace(`{${"issue_id"}}`, encodeURIComponent(String(requestParameters['issueId']))).replace(`{${"project_id"}}`, encodeURIComponent(String(requestParameters['projectId']))).replace(`{${"slug"}}`, encodeURIComponent(String(requestParameters['slug']))),
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: IssueRelationRemoveRequestToJSON(requestParameters['issueRelationRemoveRequest']),
+        }, initOverrides);
+
+        return new runtime.VoidApiResponse(response);
+    }
+
+    /**
+     * Remove a relationship between work items by specifying the related work item ID.
+     * Remove work item relation
+     */
+    async removeWorkItemRelation(requestParameters: RemoveWorkItemRelationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
+        await this.removeWorkItemRelationRaw(requestParameters, initOverrides);
+    }
+
     /**
      * Retrieve details of a specific work item.
      * Retrieve work item