AzuraCast icon

AzuraCast

Interact with AzuraCast Web API

Actions263

Administration General → Restart Service

AI-generated

Summary

Restarts a service on the AzuraCast instance.

Inputs

  • path__restartservice__service (required) — Service name | Path parameter: {service}
  • body_optional__restartservice — Optional body fields for the restart action: auto_assign (ID3v2 field assignment), name, short_name (programmatic name).
  • sendAdditionalHeaders — Whether to include extra HTTP headers in this request.
  • additionalHeaders — Provide additional HTTP headers as a JSON object, for example {X-Trace-ID:abc123}. Shown when sendAdditionalHeaders is true.
  • bodyModeOverride — Auto uses the built-in fields for this action. Override only when you need to send the request body manually. Options: auto, binary, json, multipart, none, raw. Default: auto.
  • manualJsonBody — Manual request body as JSON. Used only when Body Mode Override is set to JSON. Default: {}. Shown when bodyModeOverride is json.
  • manualRawBody — Manual request body as plain text. Used only when Body Mode Override is set to Raw.
  • manualBinaryBodyProperty — Input binary property name to read when sending binary or multipart payloads manually. Default: data. Shown when bodyModeOverride is binary or multipart.
  • manualMultipartFileFieldName — Multipart file field name expected by the endpoint when using manual multipart mode. Default: file. Shown when bodyModeOverride is multipart.
  • manualMultipartFields — Additional multipart form fields as JSON when using manual multipart mode. Default: {}. Shown when bodyModeOverride is multipart.
  • responseFormat — Choose how n8n should parse the response returned by AzuraCast. Options: auto, binary, json, text. Default: auto.
  • binaryOutputProperty — Binary output property name used when Response Format is set to binary. Default: data. Shown when responseFormat is binary.
  • returnFullResponse — Whether to return the full HTTP response, including headers and status code. Default: false. Hidden when true.
  • wrapResponseData — Whether to keep the response body in a single output item. Disable to split array responses into multiple items. Default: true. Hidden when returnFullResponse is true.

Output shape

The API response from AzuraCast, parsed according to the responseFormat setting. When responseFormat is binary, data is available at binaryOutputProperty. When returnFullResponse is true, the full HTTP response (headers and status code) is included.

wrapResponseData controls whether the response body remains in one item or is split into multiple items.

Examples

Example 1: Restart the 'airtime' service with auto body mode.

Set path__restartservice__service to 'airtime', leave bodyModeOverride at auto (default), and accept default response settings.

Example 2: Restart a service with custom JSON body and full response.

Set path__restartservice__service to 'streaming', bodyModeOverride to json, manualJsonBody to {name: 'mystream'}, sendAdditionalHeaders to true, additionalHeaders to {X-Custom: val}, returnFullResponse to true.

Links

Discussion