Update the connector status Technical preview; Added in 8.12.0

PUT /_connector/{connector_id}/_status

Path parameters

  • connector_id string Required

    The unique identifier of the connector to be updated

application/json

Body Required

  • status string Required

    Values are created, needs_configuration, configured, connected, or error.

Responses

  • 200 application/json
    Hide response attribute Show response attribute object
    • result string Required

      Values are created, updated, deleted, not_found, or noop.
PUT /_connector/{connector_id}/_status 
PUT _connector/my-connector/_status
{
    "status": "needs_configuration"
}
curl \
 --request PUT 'http://api.example.com/_connector/{connector_id}/_status' \
 --header "Content-Type: application/json" \
 --data '"{\n    \"status\": \"needs_configuration\"\n}"'
Request examples
An example body for a `PUT _connector/my-connector/_status` request. 
{
    "status": "needs_configuration"
}
{
    "status": "needs_configuration"
}
Response examples (200) 
{
  "result": "updated"
}

Documentation preview

This is a preview of your version @2025-06-09 which is not yet released.

View current documentation