---
updatedAt: 2026-04-08T10:22:15.000Z
agentTools:
  projectIndex: https://developer.goacoustic.com/acoustic-content/llms.txt
---

# Deletes the webhook profile for the current tenant.

Use the /profile endpoint to delete the webhook profile from the database.<br />User roles: admin

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0.142",
    "x-ibm-name": "ibm-watson-content-hub-api",
    "title": "Acoustic Content API",
    "description": "Copyright © Acoustic, L.P. 2019"
  },
  "tags": [
    {
      "name": "Webhook profiles",
      "description": "Use the Content webhook service Rest APIs to work with webhook profiles. You can create, retrieve and update webhook profiles in a database.\n\n### Webhook Timeouts and Retry policy\nWebhooks will automatically timeout (with no retry) after 5s which means that receivers should always perform their processing in background threads. The only situation whereby webhooks will be retried/re-sent is in the event of a communication error, and in this case only a single retry will occur.\nNote: Non-2xx responses from receivers are explicitly not retried\n"
    }
  ],
  "paths": {
    "/webhook/v1/profile": {
      "delete": {
        "summary": "Deletes the webhook profile for the current tenant.",
        "description": "Use the /profile endpoint to delete the webhook profile from the database.<br />User roles: admin",
        "responses": {
          "200": {
            "description": "Success."
          },
          "401": {
            "description": "The user is not authorized to run this action.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "an error response.",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "description": "an individual error, info or warning message.",
                        "properties": {
                          "code": {
                            "type": "integer",
                            "description": "The message code."
                          },
                          "key": {
                            "type": "string",
                            "description": "The message key."
                          },
                          "message": {
                            "type": "string",
                            "description": "The error message."
                          },
                          "description": {
                            "type": "string",
                            "description": "Optional detailed error message."
                          },
                          "more_info": {
                            "type": "string",
                            "description": "Optional additional information for the message."
                          },
                          "category": {
                            "type": "string",
                            "description": "The message category whereby only user messages are designed to be shown to an end user.",
                            "enum": [
                              "API",
                              "USER"
                            ]
                          },
                          "level": {
                            "type": "string",
                            "description": "Indicates the message level.",
                            "enum": [
                              "INFO",
                              "WARNING",
                              "ERROR"
                            ]
                          },
                          "parameters": {
                            "type": "object",
                            "description": "The message parameters of this message."
                          },
                          "field": {
                            "type": "string",
                            "description": "Only present on field validation errors, indicates the field in error."
                          },
                          "locale": {
                            "type": "string",
                            "description": "The current locale used to produce the error message."
                          }
                        }
                      }
                    },
                    "requestId": {
                      "type": "string",
                      "description": "The current request ID."
                    },
                    "service": {
                      "type": "string",
                      "description": "The name of the service that produced the error."
                    },
                    "requestMethod": {
                      "type": "string",
                      "description": "The Http method type of the current request."
                    },
                    "requestUri": {
                      "type": "string",
                      "description": "The current request uri."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "There is no existing webhook profile.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "an error response.",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "description": "an individual error, info or warning message.",
                        "properties": {
                          "code": {
                            "type": "integer",
                            "description": "The message code."
                          },
                          "key": {
                            "type": "string",
                            "description": "The message key."
                          },
                          "message": {
                            "type": "string",
                            "description": "The error message."
                          },
                          "description": {
                            "type": "string",
                            "description": "Optional detailed error message."
                          },
                          "more_info": {
                            "type": "string",
                            "description": "Optional additional information for the message."
                          },
                          "category": {
                            "type": "string",
                            "description": "The message category whereby only user messages are designed to be shown to an end user.",
                            "enum": [
                              "API",
                              "USER"
                            ]
                          },
                          "level": {
                            "type": "string",
                            "description": "Indicates the message level.",
                            "enum": [
                              "INFO",
                              "WARNING",
                              "ERROR"
                            ]
                          },
                          "parameters": {
                            "type": "object",
                            "description": "The message parameters of this message."
                          },
                          "field": {
                            "type": "string",
                            "description": "Only present on field validation errors, indicates the field in error."
                          },
                          "locale": {
                            "type": "string",
                            "description": "The current locale used to produce the error message."
                          }
                        }
                      }
                    },
                    "requestId": {
                      "type": "string",
                      "description": "The current request ID."
                    },
                    "service": {
                      "type": "string",
                      "description": "The name of the service that produced the error."
                    },
                    "requestMethod": {
                      "type": "string",
                      "description": "The Http method type of the current request."
                    },
                    "requestUri": {
                      "type": "string",
                      "description": "The current request uri."
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests, the server has reached a limit, the request must be sent again at a later time.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "an error response.",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "description": "an individual error, info or warning message.",
                        "properties": {
                          "code": {
                            "type": "integer",
                            "description": "The message code."
                          },
                          "key": {
                            "type": "string",
                            "description": "The message key."
                          },
                          "message": {
                            "type": "string",
                            "description": "The error message."
                          },
                          "description": {
                            "type": "string",
                            "description": "Optional detailed error message."
                          },
                          "more_info": {
                            "type": "string",
                            "description": "Optional additional information for the message."
                          },
                          "category": {
                            "type": "string",
                            "description": "The message category whereby only user messages are designed to be shown to an end user.",
                            "enum": [
                              "API",
                              "USER"
                            ]
                          },
                          "level": {
                            "type": "string",
                            "description": "Indicates the message level.",
                            "enum": [
                              "INFO",
                              "WARNING",
                              "ERROR"
                            ]
                          },
                          "parameters": {
                            "type": "object",
                            "description": "The message parameters of this message."
                          },
                          "field": {
                            "type": "string",
                            "description": "Only present on field validation errors, indicates the field in error."
                          },
                          "locale": {
                            "type": "string",
                            "description": "The current locale used to produce the error message."
                          }
                        }
                      }
                    },
                    "requestId": {
                      "type": "string",
                      "description": "The current request ID."
                    },
                    "service": {
                      "type": "string",
                      "description": "The name of the service that produced the error."
                    },
                    "requestMethod": {
                      "type": "string",
                      "description": "The Http method type of the current request."
                    },
                    "requestUri": {
                      "type": "string",
                      "description": "The current request uri."
                    }
                  }
                }
              }
            }
          }
        },
        "x-ibm-dx-security-user-roles": [
          "admin"
        ],
        "tags": [
          "Webhook profiles"
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "ErrorResponse": {
        "description": "This JSON record represents an error condition.",
        "type": "object",
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "description": "This JSON record represents an individual error or warning contained in an error message.",
              "type": "object",
              "properties": {
                "code": {
                  "type": "integer",
                  "description": "An error code"
                },
                "message": {
                  "type": "string",
                  "description": "A message describing what went wrong."
                },
                "description": {
                  "type": "string",
                  "description": "Further explanation of the error condition and potential next steps to resolve the problem."
                },
                "more_info": {
                  "type": "string",
                  "description": "A URL pointing to a web site that provides more information on the given error condition."
                },
                "level": {
                  "type": "string",
                  "enum": [
                    "ERROR",
                    "WARNING"
                  ],
                  "description": "The severity level of the message. Default is error."
                },
                "parameters": {
                  "type": "object",
                  "description": "Additional properties reflecting the dynamic parts of the error condition."
                },
                "cause": {
                  "type": "object",
                  "description": "This property can be used to transport causing error message records produced by a down stream service calls."
                },
                "locale": {
                  "type": "string",
                  "description": "This property represents the locale of the text contained in properties 'message', and 'description'. This property is mandatory if message and description contain translated text."
                }
              },
              "required": [
                "code",
                "message"
              ]
            }
          },
          "requestId": {
            "type": "string",
            "description": "The ID of the failing request."
          },
          "service": {
            "type": "string",
            "description": "The name of the service serving the error message."
          }
        },
        "required": [
          "errors",
          "requestId"
        ]
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```