---
title: "POST Run a specific check for a task and store results"
description: "Initiates a specific integration check for a given task, records the results, and potentially updates the task's status based on the check outcome. Requires a connection ID and check ID in the requ..."
last_updated: "2026-05-06T07:33:49.075708+00:00"
canonical_url: "https://www.doc0.dev/docs/49c89830-117b-4def-8edc-b5bcc50766e0/api/task-integrations/runcheckfortask"
---

<APIEndpoint
  method={"POST"}
  path={"/integrations/tasks/:taskId/run-check"}
  summary={"Run a specific check for a task and store results"}
  description={"Initiates a specific integration check for a given task, records the results, and potentially updates the task's status based on the check outcome. Requires a connection ID and check ID in the request body."}
  deprecated={false}
  baseUrl={""}
/>

## Parameters

<APIParameters parameters={[{"name":"taskId","in":"path","required":true,"description":"The ID of the task for which the check will be run.","schema":{"type":"string"}},{"name":"organizationId","in":"query","required":true,"description":"The ID of the organization associated with the task.","schema":{"type":"string"}}]} />

## Request Body

Body for running a check for a task.

<APIRequestBody
  contentType={"application/json"}
  required={true}
  schema={{"type":"object"}}
/>

## Responses

<APIResponse
  statusCode={"201"}
  description={"Check run initiated successfully."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

<APIResponse
  statusCode={"400"}
  description={"Bad Request - organizationId is required, connection not active, or invalid credentials."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

<APIResponse
  statusCode={"404"}
  description={"Task, Connection, Provider, Manifest, or Check not found."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

<APIResponse
  statusCode={"500"}
  description={"Internal Server Error - Failed to run check."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

## Try It

<APIPlayground
  method={"POST"}
  path={"/integrations/tasks/:taskId/run-check"}
  parameters={[{"name":"taskId","in":"path","required":true,"description":"The ID of the task for which the check will be run.","schema":{"type":"string"}},{"name":"organizationId","in":"query","required":true,"description":"The ID of the organization associated with the task.","schema":{"type":"string"}}]}
  requestBody={{"contentType":"application/json","required":true,"description":"Body for running a check for a task.","schema":{"type":"object"}}}
  baseUrl={""}
/>


## Sitemap

See the full [sitemap](https://www.doc0.dev/docs/49c89830-117b-4def-8edc-b5bcc50766e0/llms.txt) for all pages in this wiki.