---
title: "Run Discovery job"
method: POST
path: "/schedule/api/v3/discovery/run"
tags: ["describe"]
---

# Run Discovery job

`POST /schedule/api/v3/discovery/run`

## Request

- Base URL: `https://api.opengovernance.io`
- URL: `https://api.opengovernance.io/schedule/api/v3/discovery/run`
- Auth: API key in header `Authorization`

Triggers a discovery job to run immediately for the given resource types and Integrations

## Request body

- GithubComOpengovernOpengovernancePkgDescribeApiRunDiscoveryRequest
  - `force_full` boolean: force full discovery. only matters if ResourceTypes is empty
  - `integration_info` GithubComOpengovernOpengovernancePkgDescribeApiIntegrationInfoFilter[]
    - `integration_id` string
    - `integration_type` string
    - `name` string
    - `provider_id` string
  - `resource_types` string[]

## Response `200`

OK

- GithubComOpengovernOpengovernancePkgDescribeApiRunDiscoveryResponse
  - `jobs` GithubComOpengovernOpengovernancePkgDescribeApiRunDiscoveryJob[]
    - `failure_reason` string
    - `integration_info` GithubComOpengovernOpengovernancePkgDescribeApiIntegrationInfo
      - `integration_id` string
      - `integration_type` string
      - `name` string
      - `provider_id` string
    - `job_id` integer
    - `resource_type` string
    - `status` string
  - `trigger_id` integer

---

[API](https://skmtc.dev/opengovern/apis/opengovernance-service-api.md) - [All operations](https://skmtc.dev/opengovern/apis/opengovernance-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/opengovern/apis/opengovernance-service-api/revisions/ab05295c4094?raw)