Update a shared token
PUThttps://api.logz.io/v1/shared-tokens/:id
Changes the filters attached to a shared token.
Note: This endpoint requires permissions that must be set by our Support team. Please email help@logz.io for assistance. Please ensure to change the region in the URL to match your account's region.
Request
Path Parameters
- application/json
Body
IDs of filters to attach to the token. To remove all filters, use an empty array []
.
Logical operator used to combine filters. Possible values can be OR
or AND
.
Responses
- 200
- 400
- 403
successful operation
- application/json
- Schema
- Example (from schema)
Schema
ID of the shared token
Descriptive name of the token
The token
Array of filter IDs attached to each token. If no filter is attached, null
.
UNIX timestamp in milliseconds. If token wasn't in use, null
.
UNIX timestamp in milliseconds. If token doesn't have expiration date, null
.
Logical operator used to combine filters. Possible values can be OR
or AND
.
{
"id": 1241,
"name": "Snapshotting token",
"token": "6c36edf51-cf93883aa35-5bc6ce6-7bcfe60d87",
"filters": [
339,
340
],
"lastUsed": 1735743699,
"expirationDate": 1735743699,
"filtersOperator": "OR"
}
not found
- application/json
- Schema
- Example (from schema)
Schema
The shared token or query filter could not be found
{
"message": "token with id 12345 not found for account 54321"
}
forbidden
- application/json
- Schema
- Example (from schema)
Schema
Insufficient privileges. Contact our Support team for access to this API feature.
{
"message": "Insufficient privileges"
}
Authorization: X-API-TOKEN
name: X-API-TOKENtype: apiKeydescription: You can manage your API tokens from the [Logz.io API tokens](https://app.logz.io/#/dashboard/settings/manage-tokens/api) page. API tokens are account-specific. You will need to be logged into the relevant Log Management or SIEM account to view the API tokens associated with it. To manage your API tokens, log into the relevant account in your Logz.io platform, click the gear in the top-right menu, and select [**Tools > Manage tokens > API tokens**](https://app.logz.io/#/dashboard/settings/manage-tokens/api). It's important to keep your tokens secure. API tokens carry privileges to make changes to users and accounts, so if you believe an API token has been compromised, delete it, and replace it with a new token in your integrations.in: header
- curl
- python
- go
- nodejs
- ruby
- csharp
- php
- java
- powershell
- CURL
curl -L -X PUT 'https://api.logz.io/v1/shared-tokens/:id' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'X-API-TOKEN: <API_KEY_VALUE>' \
--data-raw '{
"filters": [
339
],
"filtersOperator": "OR"
}'