Edit, stop, or delete a stream

Change the settings of a Data Stream stream, stop it and start it again, or delete it, in Azion Console or with the Azion API.

Last updated

View as Markdown Agent setup

You can edit, stop, or delete a Data Stream stream from Azion Console or with the Azion API. To create a stream, refer to the Data Stream quickstart.

A stopped stream keeps its settings and sends nothing until you start it again. A deleted stream is gone with its settings. For every field you can change, refer to Stream settings.

Select your interface once. The prerequisites and every task below show only that path.

Prerequisites

  • A stream on your Azion account. To create one, refer to the Data Stream quickstart.
  • The Edit Data Stream permission. With View Data Stream only, you can see the streams but not edit, stop, or delete them. For details, refer to Stream settings.
  • Access to Azion Console. To sign in, refer to How to access Azion Console.
  • An account with fewer than 3,000 workloads. At 3,000 workloads or more, the Console blocks the stream forms, and you manage streams through the API only.
  • A personal token. To create one, refer to How to manage a personal token.
  • curl.
  • The ID of the stream. The list response of GET /v4/workspace/stream/streams carries it in the id field of each stream. In Azion Console, it is the number at the end of the stream’s edit page URL, /data-stream/edit/<stream-id>.

Edit a stream

An edit keeps the stream’s ID and changes only the settings you save. Saving checks the format of the fields, not the endpoint, so a wrong credential shows up later as failed sends.

To edit a stream with the API, send a PATCH request with only the keys you change. This example renames the stream. Replace <stream-id> with the ID of your stream:

Shell
01curl -X PATCH 'https://api.azion.com/v4/workspace/stream/streams/<stream-id>' \
02 -H 'Content-Type: application/json' \
03 -H 'Authorization: Token [TOKEN VALUE]' \
04 -d '{"name": "activity-to-bucket"}'

The API answers 200 with the stored stream:

JSON
01{
02 "state": "executed",
03 "data": {
04 "id": 12345,
05 "name": "activity-to-bucket",
06 "last_editor": "user@example.com",
07 "created": "2026-01-01T11:30:47.000000Z",
08 "last_modified": "2026-01-01T11:30:59.000000Z",
09 "product_version": "1.0",
10 "active": true,
11 "inputs": [{ "type": "raw_logs", "attributes": { "data_source": "activity_history" } }],
12 "transform": [
13 { "type": "sampling", "attributes": { "rate": 100 } },
14 { "type": "render_template", "attributes": { "template": 251 } }
15 ],
16 "outputs": […]
17 }
18}

The name is the one you sent, and last_modified moves forward. The data source, transforms, and endpoint stay as they were. To replace the whole stream, send a PUT request with the keys a create requires: name, inputs, transform, and outputs. For the body of each key, refer to Stream settings.

To edit a stream in Azion Console:

Open Data Stream

Access Azion Console > Data Stream.

Open the stream

In the list, select the row of the stream. The edit page opens, titled with the stream’s name.

A stream without sampling opens with Filter Workloads selected in Option, because the form reads the option from the stream’s transforms.

Change the settings

In the General, Input, Transform, Render Template, Output, or Status section, change the fields you need. The Output section labels the endpoint field Connector.

On an edit, the Console does not require the S3 Secret Key. For AWS Kinesis Data Firehose, enter Secret Key again on every save.

Select Save
Confirm the sampling warning

If Sampling is on, the Attention dialog opens with After activating and saving these settings, all other Data Streams will be disabled. Select Confirm.

The Console shows Your data stream has been updated.

Edits take a few minutes to propagate. Saving an active stream that uses sampling deactivates every other stream on the account. After you change the endpoint, check the next sends in Real-Time Events: each send is recorded with the status code the endpoint returned.

Stop a stream

A stopped stream keeps its settings, so you can start it again without configuring it.

To stop a stream with the API, send a PATCH request that sets active to false:

Shell
01curl -X PATCH 'https://api.azion.com/v4/workspace/stream/streams/<stream-id>' \
02 -H 'Content-Type: application/json' \
03 -H 'Authorization: Token [TOKEN VALUE]' \
04 -d '{"active": false}'

The API answers 200 with the stored stream:

JSON
01{
02 "state": "executed",
03 "data": {
04 "id": 12345,
05 "name": "activity-to-bucket",
06 …
07 "last_modified": "2026-01-01T12:03:37.000000Z",
08 "product_version": "1.0",
09 "active": false,
10 …
11 }
12}

The stream reads "active": false, and its other settings are unchanged. To start the stream again, send the same request with {"active": true}.

To stop a stream in Azion Console:

Open Data Stream

Access Azion Console > Data Stream.

The Status column shows each stream as Active or Inactive.

Open the stream

In the list, select the row of the stream.

Turn off Active

In the Status section, turn off Active.

Select Save
Confirm the sampling warning

If the Attention dialog opens, select Confirm.

The Console shows Your data stream has been updated, and the list shows the stream as Inactive. To start the stream again, turn on Active and select Save.

A change of active state takes effect after one to two minutes. During that window, the stream can keep sending. After it, Real-Time Events records no further send from the stopped stream to its endpoint.

Delete a stream

Deleting a stream removes it and its settings. A deleted stream cannot be restored: the Console warns Once confirmed, this action can't be reversed. To pause a stream and keep its settings, stop it instead.

To delete a stream with the API, send a DELETE request:

Shell
01curl -X DELETE 'https://api.azion.com/v4/workspace/stream/streams/<stream-id>' \
02 -H 'Authorization: Token [TOKEN VALUE]'

The API answers 200:

{"state":"executed"}

The "state": "executed" value confirms that the API deleted the stream.

To delete a stream in Azion Console:

Open Data Stream

Access Azion Console > Data Stream.

Select Delete

In the row of the stream, select Delete, the trash icon. The Delete stream dialog opens.

Enter the stream's name

In the box, enter the name of the stream exactly as the dialog quotes it.

Select Delete

The Console shows Data Stream successfully deleted.

Next steps

Stream settingsLook up every field you can change, with its values, defaults, and errors.Data Stream quickstartCreate a stream and confirm that its first logs reach the endpoint.Troubleshoot Data StreamFix a stream that stops sending or an endpoint that rejects the logs.