> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/xdr-5-api/cloud-workload-protection/registry-onboarding.md).

# Registry Onboarding

APIs for managing Registry Onboarding

## Create a registry connector

> Creates a new registry connector for  based on the provided details.\
> \
> \> \*\*Required license:\*\* \
> \>\
> \> Cortex Cloud Posture Management or Cortex Cloud Runtime Security.

```json
{"openapi":"3.0.0","info":{"title":"Cloud Workload Protection APIs","version":"Cortex XDR 5.1"},"tags":[{"name":"Registry Onboarding","description":"APIs for managing Registry Onboarding"}],"servers":[{"url":"https://api-yourfqdn"}],"paths":{"/public_api/v1/cwp/registry_onboarding/instances":{"post":{"summary":"Create a registry connector","operationId":"createUnmanagedRegistryConnectorPublicAPI","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnmanagedRegistryConnectorPublicAPIObject"}}}},"responses":{"201":{"description":"Connector details have been stored successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"connector_id":{"type":"string"}},"required":["connector_id"]}}}},"400":{"description":"Client error","content":{"application/json; charset=UTF-8":{"schema":{"$ref":"#/components/schemas/PublicAPIErrorResponse"}}}},"500":{"description":"Service had unexpected internal error","content":{"application/json; charset=UTF-8":{"schema":{"$ref":"#/components/schemas/PublicAPIErrorResponse"}}}}},"tags":["Registry Onboarding"],"description":"Creates a new registry connector for  based on the provided details.\n\n> **Required license:** \n>\n> Cortex Cloud Posture Management or Cortex Cloud Runtime Security.","parameters":[{"schema":{"type":"string"},"in":"header","name":"Authorization","description":"{api_key}","required":true},{"schema":{"type":"string"},"in":"header","required":true,"name":"x-xdr-auth-id","description":"{api_key_id}"}]}}},"components":{"schemas":{"UnmanagedRegistryConnectorPublicAPIObject":{"type":"object","required":["vendor","name","url","username","password","auth_token","scanning_mode","region","insecure_pull","initial_scan_configuration"],"properties":{"connector_id":{"type":"string","description":"The connector ID."},"vendor":{"$ref":"#/components/schemas/Vendor"},"name":{"type":"string","description":"Name of the registry connector."},"enabled":{"type":"boolean","description":"Indicates whether the connector is enabled.","default":true},"url":{"type":"string","description":"The URL of the registry."},"username":{"type":"string","description":"The username for authentication."},"password":{"type":"string","description":"The password for authentication."},"auth_token":{"type":"string","description":"Token to authenticate the request."},"scanning_mode":{"$ref":"#/components/schemas/ScanningMode"},"cloud_provider":{"$ref":"#/components/schemas/Provider"},"outpost_id":{"type":"string","description":"The outpost ID."},"region":{"type":"string","description":"Specifies the region to use for registry scanning. As a best practice, choose the region closest to your registry deployment to achieve the best scanning throughput and potentially reduce cloud costs."},"insecure_pull":{"type":"boolean","description":"When set to `true`, allows image pulls from insecure registries."},"ca_certificate":{"type":"string","description":"*Optional*. The CA certificate used for authentication."},"repository":{"type":"string","description":"*Optional*. The repository used for image discovery."},"initial_scan_configuration":{"$ref":"#/components/schemas/InitialScanConfiguration"},"allow_static_ips":{"type":"boolean","description":"*Optional*. Indicates whether static IP addresses are allowed."},"ip_identifier":{"type":"string","description":"*Optional*. The identifier associated with the IP address."},"asset_scope_filters":{"$ref":"#/components/schemas/FilterObject"},"registry_type":{"$ref":"#/components/schemas/RegistryType"},"tenant_id":{"type":"string","description":"The tenant ID"},"broker_type":{"allOf":[{"$ref":"#/components/schemas/BrokerType"}]},"broker_id":{"type":"string","description":"The broker ID."},"filter_type":{"allOf":[{"$ref":"#/components/schemas/FilterType"}],"description":"Controls whether `asset_scope_filters` act as an inclusion or exclusion filter.","default":"INCLUDE"},"vendor_specific_configuration":{"$ref":"#/components/schemas/VendorSpecificConfig"}}},"Vendor":{"type":"string","enum":["DOCKER","JFROG","SONATYPE","DOCKER_HUB","HARBOR","GITLAB_CONTAINER_REGISTRY","OPENSHIFT"],"description":"Name of the registry vendor.","title":"Vendor"},"ScanningMode":{"type":"string","enum":["CLOUD","OUTPOST","BROKER","NOT_APPLICABLE","KAPI"],"description":"The scanning mode used by the connector"},"Provider":{"type":"string","enum":["AWS","GCP","AZURE"],"description":"Specifies the cloud provider for the Cortex environment to use for registry scanning."},"InitialScanConfiguration":{"type":"object","title":"Initial Scan Configuration","properties":{"mode":{"type":"string","description":"Specifies the initial scan configuration mode.\n \n* `ALL` — Scans all container images, including every tag, in all discovered repositories.\n* `LATEST_TAG` — Scans only images tagged as `latest` in all discovered repositories.\n* `TAGS_MODIFIED_DAYS` — Scans images in each repository modified within the last *X* days, where *X* is set via an argument. You can select a range of up to 90 days for the scan.\n","enum":["ALL","LATEST_TAG","TAGS_MODIFIED_DAYS"],"default":"ALL"},"numDays":{"type":"integer","description":"Number of days for the scan mode `lastNDays`"}}},"FilterObject":{"oneOf":[{"$ref":"#/components/schemas/ConnectorNode"},{"$ref":"#/components/schemas/TerminalNode"}],"title":"Asset Scope Filter","description":"Defines the type of assets to be filtered (the scope). You can combine multiple conditions to create complex rules for when the asset filter should be applied."},"ConnectorNode":{"type":"object","oneOf":[{"$ref":"#/components/schemas/AndConnectorNode"},{"$ref":"#/components/schemas/OrConnectorNode"}],"description":""},"AndConnectorNode":{"type":"object","properties":{"AND":{"type":"array","items":{"$ref":"#/components/schemas/FilterObject"}}}},"OrConnectorNode":{"type":"object","properties":{"OR":{"type":"array","items":{"$ref":"#/components/schemas/FilterObject"}}}},"TerminalNode":{"type":"object","properties":{"SEARCH_FIELD":{"type":"string","description":"Defines the Field to be searched."},"SEARCH_TYPE":{"type":"string","description":"Defines the comparison operator to use for this filter. "},"SEARCH_VALUE":{"type":"string","description":"Defines the value to be searched."}}},"RegistryType":{"type":"string","enum":["CLOUD_HOSTED","SELF_HOSTED"],"description":"The type of registry."},"BrokerType":{"type":"string","enum":["BROKER_VM","BROKER_CLUSTER"],"description":"Indicates the Broker VM type used by the Outpost."},"FilterType":{"type":"string","enum":["INCLUDE","EXCLUDE"]},"VendorSpecificConfig":{"type":"object","description":"Vendor specific configuration options for scanning.","oneOf":[{"$ref":"#/components/schemas/GitlabSpecificConfig"},{"$ref":"#/components/schemas/DockerhubSpecificConfig"},{"$ref":"#/components/schemas/OpenShiftSpecificConfig"}],"title":""},"GitlabSpecificConfig":{"type":"object","description":"Properties of a GitLab connector.","properties":{"group_ids":{"type":"string","description":"*Optional*. The group IDs to scan."},"project_ids":{"type":"string","description":"*Optional*. The project IDs to scan."},"api_domain_name":{"type":"string","description":"*Optional*. The API domain name to use for the scan."}},"title":"GitLab"},"DockerhubSpecificConfig":{"type":"object","description":"Properties of a Dockerhub connector.","properties":{"repository":{"type":"string","description":"*Optional*. The Docker Hub repository to scan."}},"title":"DockerHub"},"OpenShiftSpecificConfig":{"type":"object","description":"Properties of an OpenShift connector.","properties":{"cluster_id":{"type":"string","description":"The unique identifier of the OpenShift cluster."},"cluster_name":{"type":"string","description":"The name of the OpenShift cluster."},"cluster_asset_id":{"type":"string","description":"The asset ID associated with the cluster."},"cluster_asset_type_id":{"type":"string","description":"The asset type ID of the cluster."},"cluster_realm":{"type":"string","description":"The realm or environment in which the cluster resides."}},"title":"OpenShift"},"PublicAPIErrorResponse":{"type":"object","required":["err_msg","metadata"],"properties":{"err_msg":{"type":"string","description":"The error message"},"metadata":{"$ref":"#/components/schemas/PublicAPIErrorMetadata"}}},"PublicAPIErrorMetadata":{"type":"object","description":"Details for the PublicAPIError","properties":{"code":{"$ref":"#/components/schemas/Code"}},"required":["code"]},"Code":{"type":"string","description":"A short, programmatically safe string indicating the error code reported","enum":["BAD_REQUEST","INTERNAL_ERROR","NOT_FOUND","FORBIDDEN"]}}}}
```

## Get a registry connector

> Retrieves a registry connector details using its unique ID.\
> \
> \> \*\*Required license:\*\* \
> \>\
> \> Cortex Cloud Posture Management or Cortex Cloud Runtime Security.

```json
{"openapi":"3.0.0","info":{"title":"Cloud Workload Protection APIs","version":"Cortex XDR 5.1"},"tags":[{"name":"Registry Onboarding","description":"APIs for managing Registry Onboarding"}],"servers":[{"url":"https://api-yourfqdn"}],"paths":{"/public_api/v1/cwp/registry_onboarding/instances/{connectorID}":{"get":{"summary":"Get a registry connector","operationId":"getUnmanagedRegistryConnectorPublicAPI","tags":["Registry Onboarding"],"responses":{"200":{"description":"Connector details retrieved successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetUnmanagedRegistryConnectorResponse"}}}},"404":{"description":"Connector not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAPIErrorResponse"}}}},"500":{"description":"Service had unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAPIErrorResponse"}}}}},"description":"Retrieves a registry connector details using its unique ID.\n\n> **Required license:** \n>\n> Cortex Cloud Posture Management or Cortex Cloud Runtime Security.","parameters":[{"schema":{"type":"string"},"in":"header","name":"Authentication","description":"{api_key}","required":true},{"schema":{"type":"string"},"in":"header","description":"{api_key_id}","required":true,"name":"x-xdr-auth-id"}]}}},"components":{"schemas":{"GetUnmanagedRegistryConnectorResponse":{"type":"object","properties":{"connector_id":{"type":"string","description":"The connector ID."},"vendor":{"$ref":"#/components/schemas/Vendor"},"name":{"type":"string","description":"The name of the registry connector."},"enabled":{"type":"boolean","description":"Indicates whether the connector is enabled.","default":true},"url":{"type":"string","description":"The URL of the registry."},"username":{"type":"string","description":"The username for authentication."},"password":{"type":"string","description":"The password for authentication."},"auth_token":{"type":"string","description":"Authentication token used to authorize requests to the API."},"scanning_mode":{"$ref":"#/components/schemas/ScanningMode"},"cloud_provider":{"$ref":"#/components/schemas/Provider"},"outpost_id":{"type":"string","description":"The outpost ID."},"region":{"type":"string","description":"The region of the connector."},"insecure_pull":{"type":"boolean","description":"When set to `true`, allows image pulls from insecure registries."},"ca_certificate":{"type":"string","description":"*Optional*. The CA certificate used for authentication."},"repository":{"type":"string","description":"*Optional*. The repository used for image discovery."},"initial_scan_configuration":{"$ref":"#/components/schemas/InitialScanConfiguration"},"allow_static_ips":{"type":"boolean","description":"*Optional*. Indicates whether static IP addresses are allowed."},"ip_identifier":{"type":"string","description":"*Optional*. The identifier associated with the IP address."},"asset_scope_filters":{"$ref":"#/components/schemas/FilterObject"},"registry_type":{"$ref":"#/components/schemas/RegistryType"},"tenant_id":{"type":"string","description":"The tenant ID"},"broker_type":{"allOf":[{"$ref":"#/components/schemas/BrokerType"}]},"broker_id":{"type":"string","description":"The broker ID."},"filter_type":{"allOf":[{"$ref":"#/components/schemas/FilterType"}],"description":"Controls whether `asset_scope_filters` act as an inclusion or exclusion filter.","default":"INCLUDE"},"vendor_specific_configuration":{"$ref":"#/components/schemas/VendorSpecificConfig"}}},"Vendor":{"type":"string","enum":["DOCKER","JFROG","SONATYPE","DOCKER_HUB","HARBOR","GITLAB_CONTAINER_REGISTRY","OPENSHIFT"],"description":"Name of the registry vendor.","title":"Vendor"},"ScanningMode":{"type":"string","enum":["CLOUD","OUTPOST","BROKER","NOT_APPLICABLE","KAPI"],"description":"The scanning mode used by the connector"},"Provider":{"type":"string","enum":["AWS","GCP","AZURE"],"description":"Specifies the cloud provider for the Cortex environment to use for registry scanning."},"InitialScanConfiguration":{"type":"object","title":"Initial Scan Configuration","properties":{"mode":{"type":"string","description":"Specifies the initial scan configuration mode.\n \n* `ALL` — Scans all container images, including every tag, in all discovered repositories.\n* `LATEST_TAG` — Scans only images tagged as `latest` in all discovered repositories.\n* `TAGS_MODIFIED_DAYS` — Scans images in each repository modified within the last *X* days, where *X* is set via an argument. You can select a range of up to 90 days for the scan.\n","enum":["ALL","LATEST_TAG","TAGS_MODIFIED_DAYS"],"default":"ALL"},"numDays":{"type":"integer","description":"Number of days for the scan mode `lastNDays`"}}},"FilterObject":{"oneOf":[{"$ref":"#/components/schemas/ConnectorNode"},{"$ref":"#/components/schemas/TerminalNode"}],"title":"Asset Scope Filter","description":"Defines the type of assets to be filtered (the scope). You can combine multiple conditions to create complex rules for when the asset filter should be applied."},"ConnectorNode":{"type":"object","oneOf":[{"$ref":"#/components/schemas/AndConnectorNode"},{"$ref":"#/components/schemas/OrConnectorNode"}],"description":""},"AndConnectorNode":{"type":"object","properties":{"AND":{"type":"array","items":{"$ref":"#/components/schemas/FilterObject"}}}},"OrConnectorNode":{"type":"object","properties":{"OR":{"type":"array","items":{"$ref":"#/components/schemas/FilterObject"}}}},"TerminalNode":{"type":"object","properties":{"SEARCH_FIELD":{"type":"string","description":"Defines the Field to be searched."},"SEARCH_TYPE":{"type":"string","description":"Defines the comparison operator to use for this filter. "},"SEARCH_VALUE":{"type":"string","description":"Defines the value to be searched."}}},"RegistryType":{"type":"string","enum":["CLOUD_HOSTED","SELF_HOSTED"],"description":"The type of registry."},"BrokerType":{"type":"string","enum":["BROKER_VM","BROKER_CLUSTER"],"description":"Indicates the Broker VM type used by the Outpost."},"FilterType":{"type":"string","enum":["INCLUDE","EXCLUDE"]},"VendorSpecificConfig":{"type":"object","description":"Vendor specific configuration options for scanning.","oneOf":[{"$ref":"#/components/schemas/GitlabSpecificConfig"},{"$ref":"#/components/schemas/DockerhubSpecificConfig"},{"$ref":"#/components/schemas/OpenShiftSpecificConfig"}],"title":""},"GitlabSpecificConfig":{"type":"object","description":"Properties of a GitLab connector.","properties":{"group_ids":{"type":"string","description":"*Optional*. The group IDs to scan."},"project_ids":{"type":"string","description":"*Optional*. The project IDs to scan."},"api_domain_name":{"type":"string","description":"*Optional*. The API domain name to use for the scan."}},"title":"GitLab"},"DockerhubSpecificConfig":{"type":"object","description":"Properties of a Dockerhub connector.","properties":{"repository":{"type":"string","description":"*Optional*. The Docker Hub repository to scan."}},"title":"DockerHub"},"OpenShiftSpecificConfig":{"type":"object","description":"Properties of an OpenShift connector.","properties":{"cluster_id":{"type":"string","description":"The unique identifier of the OpenShift cluster."},"cluster_name":{"type":"string","description":"The name of the OpenShift cluster."},"cluster_asset_id":{"type":"string","description":"The asset ID associated with the cluster."},"cluster_asset_type_id":{"type":"string","description":"The asset type ID of the cluster."},"cluster_realm":{"type":"string","description":"The realm or environment in which the cluster resides."}},"title":"OpenShift"},"PublicAPIErrorResponse":{"type":"object","required":["err_msg","metadata"],"properties":{"err_msg":{"type":"string","description":"The error message"},"metadata":{"$ref":"#/components/schemas/PublicAPIErrorMetadata"}}},"PublicAPIErrorMetadata":{"type":"object","description":"Details for the PublicAPIError","properties":{"code":{"$ref":"#/components/schemas/Code"}},"required":["code"]},"Code":{"type":"string","description":"A short, programmatically safe string indicating the error code reported","enum":["BAD_REQUEST","INTERNAL_ERROR","NOT_FOUND","FORBIDDEN"]}}}}
```

## Update a registry connector

> Updates the attributes of an existing registry connector identified by its unique ID.\
> \
> \> \*\*Required license:\*\* \
> \>\
> \> Cortex Cloud Posture Management or Cortex Cloud Runtime Security.

```json
{"openapi":"3.0.0","info":{"title":"Cloud Workload Protection APIs","version":"Cortex XDR 5.1"},"tags":[{"name":"Registry Onboarding","description":"APIs for managing Registry Onboarding"}],"servers":[{"url":"https://api-yourfqdn"}],"paths":{"/public_api/v1/cwp/registry_onboarding/instances/{connectorID}":{"put":{"summary":"Update a registry connector","operationId":"modifyUnmanagedRegistryConnectorPublicAPI","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnmanagedRegistryConnectorPublicAPIObject"}}}},"tags":["Registry Onboarding"],"responses":{"204":{"description":"Connector details have been updated successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"connector_id":{"type":"string"}},"required":["connector_id"]}}}},"400":{"description":"Client error","content":{"application/json; charset=UTF-8":{"schema":{"$ref":"#/components/schemas/PublicAPIErrorResponse"}}}},"404":{"description":"Connector ID not found","content":{"application/json; charset=UTF-8":{"schema":{"$ref":"#/components/schemas/PublicAPIErrorResponse"}}}},"500":{"description":"Service had unexpected internal error","content":{"application/json; charset=UTF-8":{"schema":{"$ref":"#/components/schemas/PublicAPIErrorResponse"}}}}},"description":"Updates the attributes of an existing registry connector identified by its unique ID.\n\n> **Required license:** \n>\n> Cortex Cloud Posture Management or Cortex Cloud Runtime Security.","parameters":[{"schema":{"type":"string"},"in":"header","name":"Authentication","description":"{api_key}","required":true},{"schema":{"type":"string"},"in":"header","name":"x-xdr-auth-id","description":"{api_key_id}","required":true}]}}},"components":{"schemas":{"UnmanagedRegistryConnectorPublicAPIObject":{"type":"object","required":["vendor","name","url","username","password","auth_token","scanning_mode","region","insecure_pull","initial_scan_configuration"],"properties":{"connector_id":{"type":"string","description":"The connector ID."},"vendor":{"$ref":"#/components/schemas/Vendor"},"name":{"type":"string","description":"Name of the registry connector."},"enabled":{"type":"boolean","description":"Indicates whether the connector is enabled.","default":true},"url":{"type":"string","description":"The URL of the registry."},"username":{"type":"string","description":"The username for authentication."},"password":{"type":"string","description":"The password for authentication."},"auth_token":{"type":"string","description":"Token to authenticate the request."},"scanning_mode":{"$ref":"#/components/schemas/ScanningMode"},"cloud_provider":{"$ref":"#/components/schemas/Provider"},"outpost_id":{"type":"string","description":"The outpost ID."},"region":{"type":"string","description":"Specifies the region to use for registry scanning. As a best practice, choose the region closest to your registry deployment to achieve the best scanning throughput and potentially reduce cloud costs."},"insecure_pull":{"type":"boolean","description":"When set to `true`, allows image pulls from insecure registries."},"ca_certificate":{"type":"string","description":"*Optional*. The CA certificate used for authentication."},"repository":{"type":"string","description":"*Optional*. The repository used for image discovery."},"initial_scan_configuration":{"$ref":"#/components/schemas/InitialScanConfiguration"},"allow_static_ips":{"type":"boolean","description":"*Optional*. Indicates whether static IP addresses are allowed."},"ip_identifier":{"type":"string","description":"*Optional*. The identifier associated with the IP address."},"asset_scope_filters":{"$ref":"#/components/schemas/FilterObject"},"registry_type":{"$ref":"#/components/schemas/RegistryType"},"tenant_id":{"type":"string","description":"The tenant ID"},"broker_type":{"allOf":[{"$ref":"#/components/schemas/BrokerType"}]},"broker_id":{"type":"string","description":"The broker ID."},"filter_type":{"allOf":[{"$ref":"#/components/schemas/FilterType"}],"description":"Controls whether `asset_scope_filters` act as an inclusion or exclusion filter.","default":"INCLUDE"},"vendor_specific_configuration":{"$ref":"#/components/schemas/VendorSpecificConfig"}}},"Vendor":{"type":"string","enum":["DOCKER","JFROG","SONATYPE","DOCKER_HUB","HARBOR","GITLAB_CONTAINER_REGISTRY","OPENSHIFT"],"description":"Name of the registry vendor.","title":"Vendor"},"ScanningMode":{"type":"string","enum":["CLOUD","OUTPOST","BROKER","NOT_APPLICABLE","KAPI"],"description":"The scanning mode used by the connector"},"Provider":{"type":"string","enum":["AWS","GCP","AZURE"],"description":"Specifies the cloud provider for the Cortex environment to use for registry scanning."},"InitialScanConfiguration":{"type":"object","title":"Initial Scan Configuration","properties":{"mode":{"type":"string","description":"Specifies the initial scan configuration mode.\n \n* `ALL` — Scans all container images, including every tag, in all discovered repositories.\n* `LATEST_TAG` — Scans only images tagged as `latest` in all discovered repositories.\n* `TAGS_MODIFIED_DAYS` — Scans images in each repository modified within the last *X* days, where *X* is set via an argument. You can select a range of up to 90 days for the scan.\n","enum":["ALL","LATEST_TAG","TAGS_MODIFIED_DAYS"],"default":"ALL"},"numDays":{"type":"integer","description":"Number of days for the scan mode `lastNDays`"}}},"FilterObject":{"oneOf":[{"$ref":"#/components/schemas/ConnectorNode"},{"$ref":"#/components/schemas/TerminalNode"}],"title":"Asset Scope Filter","description":"Defines the type of assets to be filtered (the scope). You can combine multiple conditions to create complex rules for when the asset filter should be applied."},"ConnectorNode":{"type":"object","oneOf":[{"$ref":"#/components/schemas/AndConnectorNode"},{"$ref":"#/components/schemas/OrConnectorNode"}],"description":""},"AndConnectorNode":{"type":"object","properties":{"AND":{"type":"array","items":{"$ref":"#/components/schemas/FilterObject"}}}},"OrConnectorNode":{"type":"object","properties":{"OR":{"type":"array","items":{"$ref":"#/components/schemas/FilterObject"}}}},"TerminalNode":{"type":"object","properties":{"SEARCH_FIELD":{"type":"string","description":"Defines the Field to be searched."},"SEARCH_TYPE":{"type":"string","description":"Defines the comparison operator to use for this filter. "},"SEARCH_VALUE":{"type":"string","description":"Defines the value to be searched."}}},"RegistryType":{"type":"string","enum":["CLOUD_HOSTED","SELF_HOSTED"],"description":"The type of registry."},"BrokerType":{"type":"string","enum":["BROKER_VM","BROKER_CLUSTER"],"description":"Indicates the Broker VM type used by the Outpost."},"FilterType":{"type":"string","enum":["INCLUDE","EXCLUDE"]},"VendorSpecificConfig":{"type":"object","description":"Vendor specific configuration options for scanning.","oneOf":[{"$ref":"#/components/schemas/GitlabSpecificConfig"},{"$ref":"#/components/schemas/DockerhubSpecificConfig"},{"$ref":"#/components/schemas/OpenShiftSpecificConfig"}],"title":""},"GitlabSpecificConfig":{"type":"object","description":"Properties of a GitLab connector.","properties":{"group_ids":{"type":"string","description":"*Optional*. The group IDs to scan."},"project_ids":{"type":"string","description":"*Optional*. The project IDs to scan."},"api_domain_name":{"type":"string","description":"*Optional*. The API domain name to use for the scan."}},"title":"GitLab"},"DockerhubSpecificConfig":{"type":"object","description":"Properties of a Dockerhub connector.","properties":{"repository":{"type":"string","description":"*Optional*. The Docker Hub repository to scan."}},"title":"DockerHub"},"OpenShiftSpecificConfig":{"type":"object","description":"Properties of an OpenShift connector.","properties":{"cluster_id":{"type":"string","description":"The unique identifier of the OpenShift cluster."},"cluster_name":{"type":"string","description":"The name of the OpenShift cluster."},"cluster_asset_id":{"type":"string","description":"The asset ID associated with the cluster."},"cluster_asset_type_id":{"type":"string","description":"The asset type ID of the cluster."},"cluster_realm":{"type":"string","description":"The realm or environment in which the cluster resides."}},"title":"OpenShift"},"PublicAPIErrorResponse":{"type":"object","required":["err_msg","metadata"],"properties":{"err_msg":{"type":"string","description":"The error message"},"metadata":{"$ref":"#/components/schemas/PublicAPIErrorMetadata"}}},"PublicAPIErrorMetadata":{"type":"object","description":"Details for the PublicAPIError","properties":{"code":{"$ref":"#/components/schemas/Code"}},"required":["code"]},"Code":{"type":"string","description":"A short, programmatically safe string indicating the error code reported","enum":["BAD_REQUEST","INTERNAL_ERROR","NOT_FOUND","FORBIDDEN"]}}}}
```

## Delete a registry connector

> Deletes a specific registry connector identified by its unique ID.\
> \
> \> \*\*Required license:\*\* \
> \>\
> \> Cortex Cloud Posture Management or Cortex Cloud Runtime Security.

```json
{"openapi":"3.0.0","info":{"title":"Cloud Workload Protection APIs","version":"Cortex XDR 5.1"},"tags":[{"name":"Registry Onboarding","description":"APIs for managing Registry Onboarding"}],"servers":[{"url":"https://api-yourfqdn"}],"paths":{"/public_api/v1/cwp/registry_onboarding/instances/{connectorID}":{"delete":{"summary":"Delete a registry connector","operationId":"deleteUnmanagedRegistryConnectorPublicAPI","tags":["Registry Onboarding"],"responses":{"204":{"description":"Connector deleted successfully."},"404":{"description":"Connector not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAPIErrorResponse"}}}},"500":{"description":"Service had unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAPIErrorResponse"}}}}},"description":"Deletes a specific registry connector identified by its unique ID.\n\n> **Required license:** \n>\n> Cortex Cloud Posture Management or Cortex Cloud Runtime Security.","parameters":[{"schema":{"type":"string"},"in":"header","name":"Authentication","description":"{api_key}","required":true},{"schema":{"type":"string"},"in":"header","name":"x-xdr-auth-id","description":"{api_key_id}","required":true}]}}},"components":{"schemas":{"PublicAPIErrorResponse":{"type":"object","required":["err_msg","metadata"],"properties":{"err_msg":{"type":"string","description":"The error message"},"metadata":{"$ref":"#/components/schemas/PublicAPIErrorMetadata"}}},"PublicAPIErrorMetadata":{"type":"object","description":"Details for the PublicAPIError","properties":{"code":{"$ref":"#/components/schemas/Code"}},"required":["code"]},"Code":{"type":"string","description":"A short, programmatically safe string indicating the error code reported","enum":["BAD_REQUEST","INTERNAL_ERROR","NOT_FOUND","FORBIDDEN"]}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cortex-docs.paloaltonetworks.com/xdr-5-api/cloud-workload-protection/registry-onboarding.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.