---
title: "Sync Custom Integration integration."
method: POST
path: "/integrations/custom/{id}/sync"
tags: ["Integrations"]
---

# Sync Custom Integration integration.

`POST /integrations/custom/{id}/sync`

## Request

- Base URL: `https://public.escape.tech/v3`
- URL: `https://public.escape.tech/v3/integrations/custom/{id}/sync`
- Auth: API key in header `X-ESCAPE-API-KEY`

Start a discovery run (PULL) for a Custom Integration integration and return the created run.

## Path parameters

- `id` string, required: The integration ID

## Response `200`

OK

- object
  - `id` string, uuid, required: The id of the run
  - `kind` 'ACT_USING_UPDATE_ASSET' | 'ASM_APK' | 'ASM_AWS_LAMBDA' | 'ASM_BITBUCKET_REPOSITORY' | 'ASM_BURPSUITE_EXPORT' | 'ASM_CODE_PROJECT' | 'ASM_DNS' | 'ASM_GITHUB_REPOSITORY' | 'ASM_GITLAB_REPOSITORY' | 'ASM_GRAPHQL' | 'ASM_GRAPHQL_SCHEMA' | 'ASM_GRPC' | 'ASM_HAR_EXPORT' | 'ASM_INSOMNIA' | 'ASM_IPV4' | 'ASM_IPV4_RANGE' | 'ASM_IPV6' | 'ASM_MCP' | 'ASM_OPENAPI' | 'ASM_PACKAGE' | 'ASM_POSTMAN_COLLECTION' | 'ASM_POSTMAN_ENVIRONMENT' | 'ASM_REST' | 'ASM_SOAP' | 'ASM_SOFTWARE' | 'ASM_WEBAPP' | 'ASM_WEBSOCKET' | 'ASM_WP_JSON' | 'AUTOMATED_PENTEST' | 'BLST_GRAPHQL' | 'BLST_REST' | 'BUILD_SCHEMA' | 'CONTINUOUS_PENTEST' | 'EXPORT_USING_AZURE_BOARDS' | 'EXPORT_USING_JIRA' | 'EXPORT_USING_SERVICENOW' | 'EXPORT_USING_WEBHOOK' | 'EXPORT_USING_WIZ' | 'EXTERNAL_NETWORK_PENTEST' | 'FRONTEND_DAST' | 'MOBILE_APP_PENTEST' | 'NOTIFY_USING_DISCORD' | 'NOTIFY_USING_EMAILS' | 'NOTIFY_USING_SLACK' | 'NOTIFY_USING_TEAMS' | 'PARSE_PENTEST_SCENARIO_TEMPLATES' | 'PULL_AKAMAI' | 'PULL_AWS' | 'PULL_AWS_ACCOUNT' | 'PULL_AZURE' | 'PULL_AZURE_BOARDS' | 'PULL_AZURE_KEY_VAULT' | 'PULL_BITBUCKET' | 'PULL_CLOUDFLARE' | 'PULL_CUSTOM' | 'PULL_GCP' | 'PULL_GITHUB' | 'PULL_GITLAB' | 'PULL_JIRA' | 'PULL_K8S' | 'PULL_POSTMAN' | 'PULL_WIZ' | 'REGRESSION_TESTING' | 'RETEST' | 'SCAN_ISSUE_REPLAY' | 'VALIDATE_AKAMAI' | 'VALIDATE_AWS' | 'VALIDATE_AWS_ACCOUNT' | 'VALIDATE_AZURE_BOARDS' | 'VALIDATE_AZURE_KEY_VAULT' | 'VALIDATE_BITBUCKET' | 'VALIDATE_CLOUDFLARE' | 'VALIDATE_CONFIG' | 'VALIDATE_DNS' | 'VALIDATE_GCP' | 'VALIDATE_GITHUB' | 'VALIDATE_GITLAB' | 'VALIDATE_GRAPHQL' | 'VALIDATE_IPV4' | 'VALIDATE_IPV4_RANGE' | 'VALIDATE_IPV6' | 'VALIDATE_JIRA' | 'VALIDATE_K8S' | 'VALIDATE_PENTEST' | 'VALIDATE_PENTEST_APK' | 'VALIDATE_PENTEST_NETWORK' | 'VALIDATE_POSTMAN' | 'VALIDATE_REST' | 'VALIDATE_SERVICENOW' | 'VALIDATE_WEBAPP' | 'VALIDATE_WIZ', required: The kind of discovery workflow that ran
  - `status` 'CANCELED' | 'FAILED' | 'FINISHED' | 'RUNNING' | 'STARTING', required: The status of the run
  - `createdAt` string, date-time, required: The date and time the run was created
  - `finishedAt` string, date-time, nullable, required: The date and time the run finished
  - `duration` number, required: The duration of the run in milliseconds
  - `progressRatio` number, required: The progress ratio of the run, between 0 and 1

## Other responses

- `400`: Bad Request
- `404`: Not found

---

[API](https://skmtc.dev/escape/apis/escape-public-api.md) - [All operations](https://skmtc.dev/escape/apis/escape-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/escape/apis/escape-public-api/revisions/2eab35df40c7?raw)