HTTP Delete

preview

We're still working on this feature, but we'd love for you to try it out!

This feature is currently provided as part of a preview program pursuant to our pre-release policies.

This page provides a comprehensive reference for http delete available in the workflow automation actions catalog. These actions enable you to http delete request operations.

Prerequisites

Before using HTTP actions in workflow automation, ensure you have:

Target API endpoint URLs.
Any required authentication credentials (API keys, tokens, etc.).
Understanding of the API request/response formats.

Tip

HTTP actions support secret syntax for any header value, allowing you to securely pass sensitive data like API keys. See secrets management for more information.

Automatic request headers

All HTTP requests performed by Workflow Automation automatically include the following headers:

Header	Format
`x-abuse-info`	`Request sent by a New Relic WorkflowAutomation. {runId}` where `{runId}` is the workflow run ID
`User-Agent`	`NewRelic/WorkflowAutomation (region={region}; https://newrelic.com ; support@newrelic.com)` where `{region}` is the New Relic region

Delete web data

Performs an HTTP DELETE request to remove data at an API endpoint.

Important

If you need to pass sensitive data to an input, for example an Api-Key header, you can use values stored via the secretsManagementCreateSecret NerdGraph mutation.

Example:

{
  "inputs": [
    {
      "key": "headers",
      "value": "{\"Api-Key\": \"${{ :secrets:NR_API_KEY }}\"}"
    }
  ]
}

Input Field	Optionality	Type	Description
url	Required	String	The target URL for the request. The URL must include the scheme (for example, https:// or http://). Example: `https://example.com`
urlParams	Optional	Map	The query parameters to append to the URL. Takes a stringified JSON object.
headers	Optional	Map	The headers to add to the request. Takes a stringified JSON object.
selectors	Optional	List	The selectors to get only the specified parameters as output.

Output Field	Type	Description
responseBody	String	The body of the response.
statusCode	Int	The status code of the response.
success	Boolean	Status of the request.
errorMessage	String	Failure reason as message.

Workflow definition	Input	Output
`name: httpDeleteTest steps: - name: query type: action action: http.delete version: 1 inputs: url: ${{ .workflowInputs.url }} urlParams: ${{ .workflowInputs.urlParams }} headers: ${{ .workflowInputs.headers }} selectors: ${{ .workflowInputs.selectors }}`	`{ "inputs": [ { "key": "url", "value": "https://example.com" }, { "key": "urlParams", "value": "{\"foo\": \"bar\"}" }, { "key": "headers", "value": "{\"baz\": \"bat\"}" }, { "key": "selectors", "value": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]" } ] }`	`Success case: { "success": true, "responseBody": "<!doctype html>\n<html>...</html>\n", "statusCode": 200 } Failure case: { "errorMessage": "An unexpected error failed to call http delete endpoint.", "success": false }`

Workflow definition

Input

Output

name: httpDeleteTest
    steps:
      - name: query
        type: action
        action: http.delete
        version: 1
        inputs:
          url: ${{ .workflowInputs.url }}
          urlParams: ${{ .workflowInputs.urlParams }}
          headers: ${{ .workflowInputs.headers }}
          selectors: ${{ .workflowInputs.selectors }}

{
    "inputs": [
      {
        "key": "url",
        "value": "https://example.com"
      },
      {
        "key": "urlParams",
        "value": "{\"foo\": \"bar\"}"
      },
      {
        "key": "headers",
        "value": "{\"baz\": \"bat\"}"
      },
      {
        "key": "selectors",
        "value": "[{\"name\": \"responseBody\", \"expression\": \".responseBody\"}, {\"name\": \"statusCode\", \"expression\": \".statusCode\"}]"
      }
    ]
  }

Success case:
    {
      "success": true,
      "responseBody": "<!doctype html>\n<html>...</html>\n",
      "statusCode": 200
    }

  Failure case:
    {
      "errorMessage": "An unexpected error failed to call http delete endpoint.",
      "success": false
    }

preview

Prerequisites.css-21sua1{background:none;border:none;width:0;padding:0;}

Tip

Automatic request headers

Delete web data

Important

Prerequisites