# GET /Tasks/{taskId}

## GET /api/v1/Tasks/{taskId}

> Retrieves detailed information for a specific task.

```json
{"openapi":"3.0.4","info":{"title":"Cakewalk Open API","version":"v1"},"servers":[{"url":"https://open-api.getcakewalk.io"}],"security":[{"API Key":[]}],"components":{"securitySchemes":{"API Key":{"type":"apiKey","description":"Public API key used to identify the client application. It should be included in all requests.","name":"X-API-KEY","in":"header"}},"schemas":{"TaskDetailedRecordViewModelV1":{"required":["data","links"],"type":"object","properties":{"data":{"allOf":[{"$ref":"#/components/schemas/TaskDetailedViewModelV1"}],"description":"The single data record returned by the request."},"links":{"allOf":[{"$ref":"#/components/schemas/LinksViewModel"}],"description":"Navigation links related to the resource."}},"additionalProperties":false,"description":"A response model that contains a single data record and related navigation links."},"TaskDetailedViewModelV1":{"required":["createdAt","id","lastUpdatedAt","status","type"],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier of the task.","format":"uuid"},"type":{"allOf":[{"$ref":"#/components/schemas/TaskType"}],"description":"Type of the task."},"createdAt":{"type":"string","description":"Timestamp when the task was created.","format":"date-time"},"status":{"allOf":[{"$ref":"#/components/schemas/TaskStatus"}],"description":"Current status of the task."},"lastUpdatedAt":{"type":"string","description":"Timestamp of the most recent update to the task.","format":"date-time"},"isAutoprovisioning":{"type":"boolean","description":"Indicates whether the task was created as part of the Agent Cake autoprovisioning process."},"isActionStep":{"type":"boolean","description":"Indicates whether the task is considered an action (provisioning, de-provisioning, etc.) step of a request.","nullable":true},"assignedUser":{"allOf":[{"$ref":"#/components/schemas/UserSimplifiedViewModelV1"}],"description":"User currently assigned to the task.","nullable":true},"claimers":{"type":"array","items":{"$ref":"#/components/schemas/UserSimplifiedViewModelV1"},"description":"List of users who can claim the task.","nullable":true},"executedByUser":{"allOf":[{"$ref":"#/components/schemas/UserSimplifiedViewModelV1"}],"description":"User who executed the task, if any.","nullable":true},"request":{"allOf":[{"$ref":"#/components/schemas/RequestSimplifiedViewModelV1"}],"description":"Request related to the task, if any.","nullable":true},"snoozedTill":{"type":"string","description":"Date and time until which the task is snoozed.","format":"date-time","nullable":true},"offboardingMetadata":{"allOf":[{"$ref":"#/components/schemas/ReviewOffboardingMetadataViewModelV1"}],"description":"Offboarding-specific metadata associated with the task. Used for Review Offboarding Tasks.","nullable":true},"onboardingMetadata":{"allOf":[{"$ref":"#/components/schemas/ReviewOnboardingMetadataViewModelV1"}],"description":"Onboarding-specific metadata associated with the task. Used for Review Onboarding Tasks.","nullable":true},"rolledOutByUser":{"allOf":[{"$ref":"#/components/schemas/UserSimplifiedViewModelV1"}],"description":"In case of tasks to install the Cakewalk Browser Extension, the user who rolled out the extension.","nullable":true},"systemExecutionReason":{"allOf":[{"$ref":"#/components/schemas/TaskSystemExecutionReason"}],"description":"In case the task has been closed by the system, the reason for closing it.","nullable":true},"closedReason":{"type":"string","description":"Reason why the task was closed, if provided by the user when closing it (approve or decline).","nullable":true}},"additionalProperties":false,"description":"Detailed information about a task, including status, user assignments, metadata, and related request info."},"TaskType":{"enum":["StandAloneBrowserExtensionInstallationTask","StandAloneReviewOffboardingTask","StandAloneReviewOnboardingTask","RequestReviewTask","RequestActionTask"],"type":"string"},"TaskStatus":{"enum":["Approved","Declined","InProgress","Pending","Blocked","Drafted","NoClaimers","Cancelled"],"type":"string"},"UserSimplifiedViewModelV1":{"required":["email","id","name","statusName"],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier of the user.","format":"uuid"},"name":{"minLength":1,"type":"string","description":"Full name of the user."},"email":{"minLength":1,"type":"string","description":"Email address of the user."},"statusId":{"type":"integer","description":"Identifier of the user's status.","format":"int32"},"statusName":{"minLength":1,"type":"string","description":"Name of the user's status."}},"additionalProperties":false,"description":"Basic user information including identity and status details."},"RequestSimplifiedViewModelV1":{"required":["createdAt","id","requestStatus","requestType","requestedByUserId","sourceId","updatedAt","workAppId"],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier of the request.","format":"uuid"},"requestType":{"minLength":1,"type":"string","description":"Type of the request."},"requestStatus":{"minLength":1,"type":"string","description":"Current status of the request."},"requestedByUserId":{"type":"string","description":"ID of the user who created the request.","format":"uuid"},"cancelledByUserId":{"type":"string","description":"ID of the user who cancelled the request, if applicable.","format":"uuid","nullable":true},"workAppId":{"type":"string","description":"ID of the associated Work App.","format":"uuid"},"permissionLevelId":{"type":"string","description":"ID of the associated permission level, if applicable.","format":"uuid","nullable":true},"targetUserId":{"type":"string","description":"ID of the target user, if applicable.","format":"uuid","nullable":true},"requestPurpose":{"type":"string","description":"Purpose or reason for the request.","nullable":true},"sourceId":{"type":"string","description":"ID of the source entity related to the request.","format":"uuid"},"createdAt":{"type":"string","description":"Timestamp when the request was created.","format":"date-time"},"updatedAt":{"type":"string","description":"Timestamp when the request was last updated.","format":"date-time"}},"additionalProperties":false,"description":"A simplified view of a request, including key metadata such as type, status, and related identifiers."},"ReviewOffboardingMetadataViewModelV1":{"required":["externalIntegrationAppName","targetUser"],"type":"object","properties":{"targetUser":{"allOf":[{"$ref":"#/components/schemas/UserSimplifiedViewModelV1"}],"description":"User being offboarded."},"externalIntegrationAppName":{"minLength":1,"type":"string","description":"Name of the external integration application involved in offboarding."},"terminationDate":{"type":"string","description":"Termination date of the user, if available.","format":"date-time","nullable":true}},"additionalProperties":false,"description":"Offboarding-related metadata for a Review Offboarding Task, including the affected user, integration app, and optional termination date."},"ReviewOnboardingMetadataViewModelV1":{"required":["externalIntegrationAppName","onboardingUserEmail","onboardingUserFullName"],"type":"object","properties":{"onboardingUserFullName":{"minLength":1,"type":"string","description":"Full name of the user being onboarded."},"onboardingUserEmail":{"minLength":1,"type":"string","description":"Email address of the user being onboarded."},"externalIntegrationAppName":{"minLength":1,"type":"string","description":"Name of the external integration application involved in onboarding."},"externalConnectionAppIsEmailProvider":{"type":"boolean","description":"Indicates if the external app is also the email provider."},"startingDate":{"type":"string","description":"Start date for the onboarding process, if available.","format":"date-time","nullable":true}},"additionalProperties":false,"description":"Onboarding-related metadata for a Review Onboarding Task, including user details, integration app, and optional start date."},"TaskSystemExecutionReason":{"enum":["BrowserExtensionInstalled","OffboardingCreated","OnboardingCreated","UserLinkedToExternalProvider","CakewalkOwnerOffboarded","ValidKomboSyncReceivedWithNullTerminationDate","RequestCancelled","UserGainedAccessToWorkAppAlready","UsersGroupAutoProvisioning","CakewalkAutoprovisioning","UserAlreadyProvisioned","OpenApi","UserIgnored","UserMovedToManaged","UserToDeprovisionNotFound","SystemIntegrationCompletedOperation"],"type":"string"},"LinksViewModel":{"required":["self"],"type":"object","properties":{"self":{"minLength":1,"type":"string","description":"URL to the current resource or page."},"next":{"type":"string","description":"URL to the next page in the collection, if available.","nullable":true}},"additionalProperties":false,"description":"Pagination-related URLs for navigating a paginated collection."},"ProblemDetails":{"type":"object","properties":{"type":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"status":{"type":"integer","format":"int32","nullable":true},"detail":{"type":"string","nullable":true},"instance":{"type":"string","nullable":true}},"additionalProperties":{}}}},"paths":{"/api/v1/Tasks/{taskId}":{"get":{"tags":["Tasks"],"summary":"Retrieves detailed information for a specific task.","parameters":[{"name":"taskId","in":"path","description":"The unique identifier of the task.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-API-SECRET","in":"header","description":"API Secret is used to verify the integrity of the request and authenticate the client. It should be included in all requests. This value must be kept confidential and should never be exposed in client-side code or public repositories.","required":true,"schema":{"type":"string","description":"API Secret is used to verify the integrity of the request and authenticate the client. It should be included in all requests. This value must be kept confidential and should never be exposed in client-side code or public repositories."}}],"responses":{"200":{"description":"OK","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/TaskDetailedRecordViewModelV1"}},"application/json":{"schema":{"$ref":"#/components/schemas/TaskDetailedRecordViewModelV1"}},"text/json":{"schema":{"$ref":"#/components/schemas/TaskDetailedRecordViewModelV1"}}}},"401":{"description":"Unauthorized","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}},"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}},"text/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"Not Found","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}},"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}},"text/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}}}}
```