Vai al contenuto principale
GET
/
tags
/
{tagId}
Recupera una definizione di tag
curl --request GET \
  --url https://api.altostrat.io/tags/{tagId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "tag_01E8Z4Q6J7B6A5P4E3D2C1B0A9",
  "key": "Regione",
  "color": "#3F51B5",
  "mandatory_on": [
    "site"
  ],
  "created_at": "2025-10-29T12:00:00Z",
  "updated_at": "2025-10-29T12:30:00Z",
  "values": [
    {
      "tag_id": "tag_01E8Z4Q6J7B6A5P4E3D2C1B0A9",
      "correlation_id": "site_9b52d930f4324c0abac04c12dff85544",
      "correlation_type": "site",
      "value": "APAC",
      "created_at": "2025-10-29T13:00:00Z",
      "updated_at": "2025-10-29T13:00:00Z"
    }
  ]
}

Authorizations

Authorization
string
header
required

Un token bearer è richiesto per tutte le richieste API.

Path Parameters

tagId
string
required

L'identificatore univoco per la definizione del tag.

Response

La definizione del tag richiesta.

id
string

L'identificatore univoco per la definizione del tag.

Example:

"tag_01E8Z4Q6J7B6A5P4E3D2C1B0A9"

key
string

Il nome visualizzato per la categoria del tag (es. "Regione", "Priorità").

Example:

"Regione"

color
string

Un codice colore esadecimale utilizzato per la visualizzazione nell'interfaccia utente.

Example:

"#3F51B5"

mandatory_on
enum<string>[]

Un elenco di tipi di risorsa in cui questo tag deve essere applicato obbligatoriamente.

created_at
string<date-time>

La data e ora di creazione della definizione del tag.

Example:

"2025-10-29T12:00:00Z"

updated_at
string<date-time>

La data e ora dell'ultimo aggiornamento della definizione del tag.

Example:

"2025-10-29T12:30:00Z"

values
object[]

Un elenco di tutti i valori che sono stati applicati utilizzando questa definizione di tag.