API dei team

Gestisci i team e le appartenenze. Le richieste restano soggette alle autorizzazioni del tuo account e del team.

Usa Autenticazione API per le richieste protette. Gli esempi usano i tuoi ID di risorse e un token temporaneo; gli esempi di risposte salvate sono sintetici.

Metodo	Percorso	Operazione
`GET`	`/v1/team`	Elenca i team
`POST`	`/v1/team`	Crea team
`GET`	`/v1/team/{id}`	Ottieni team
`PUT`	`/v1/team/{id}`	Aggiorna team
`DELETE`	`/v1/team/{id}`	Elimina team
`GET`	`/v1/team/deployment-context`	Ottieni il contesto di distribuzione
`GET`	`/v1/team/members`	Elenca i membri del team
`GET`	`/v1/team/invitations`	Elenca gli inviti del team
`POST`	`/v1/team/invitations`	Invita un membro del team
`POST`	`/v1/team/invitations/{id}/resend`	Invia di nuovo l’invito del team
`DELETE`	`/v1/team/invitations/{id}`	Revoca un invito del team

Elenca i team

GET /v1/team

Restituisce un elenco paginato di Team

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
`X-Tenant-ID`	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.
`page`	query	No	Numero di pagina
`per_page`	query	No	Elementi per pagina

Esempio di richiesta

Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/team" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Elenco di Team

Campi di risposta

Campo	Tipo	Descrizione
`data`	array
`data[].created_at`	integer	(timestamp Unix)
`data[].deleted_at`	integer	(timestamp Unix)
`data[].description`	string
`data[].owner_id`	string
`data[].parent_id`	string
`data[].status`	string	Valori consentiti: active, inactive, suspended, deleted.
`data[].team_id`	string
`data[].title`	string
`data[].updated_at`	integer	(timestamp Unix)
`pagination`	object
`pagination.page`	integer	Numero di pagina attuale
`pagination.per_page`	integer	Numero di elementi per pagina
`pagination.total`	integer	Numero totale di elementi

Esempio illustrativo; non è una risposta dal vivo:

{
  "data": [
    {
      "created_at": 1791072000,
      "deleted_at": 0,
      "description": "",
      "owner_id": "000000000000000000000000001",
      "parent_id": "000000000000000000000000001",
      "status": "active",
      "team_id": "000000000000000000000000001",
      "title": "Postman example",
      "updated_at": 1791072000
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 1
  }
}

Crea team

POST /v1/team

Crea un nuovo oggetto Team

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Campi di richiesta (il corpo contiene un esempio modificabile):

Campo	Tipo	Obbligatorio	Descrizione
`description`	string	No	Valore predefinito: `""`.
`owner_id`	string	Sì
`parent_id`	string	No
`status`	string	Sì	Valori consentiti: active, inactive, suspended, deleted. Valore predefinito: `"active"`.
`title`	string	Sì

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
`X-Tenant-ID`	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

curl --fail-with-body --request POST "$ADIOS_API_URL/v1/team" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "owner_id": "YOUR_USER_ID",
  "title": "Postman example team",
  "status": "active"
}
JSON

Sostituisci YOUR_* nel corpo prima dell’invio. L’heredoc tra virgolette mantiene il JSON letterale.

Risposta: HTTP 201

Team creato

Campi di risposta

Campo	Tipo	Descrizione
`created_at`	integer	(timestamp Unix)
`deleted_at`	integer	(timestamp Unix)
`description`	string
`owner_id`	string
`parent_id`	string
`status`	string	Valori consentiti: active, inactive, suspended, deleted.
`team_id`	string
`title`	string
`updated_at`	integer	(timestamp Unix)

Esempio illustrativo; non è una risposta dal vivo:

{
  "created_at": 1791072000,
  "deleted_at": 0,
  "description": "",
  "owner_id": "000000000000000000000000001",
  "parent_id": "000000000000000000000000001",
  "status": "active",
  "team_id": "000000000000000000000000001",
  "title": "Postman example",
  "updated_at": 1791072000
}

Ottieni team

GET /v1/team/{id}

Restituisce un oggetto Team

Imposta team_id usando gli ID restituiti dalle tue risposte API.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
`id`	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
`X-Tenant-ID`	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/team/${ADIOS_TEAM_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Team

Campi di risposta

Campo	Tipo	Descrizione
`created_at`	integer	(timestamp Unix)
`deleted_at`	integer	(timestamp Unix)
`description`	string
`owner_id`	string
`parent_id`	string
`status`	string	Valori consentiti: active, inactive, suspended, deleted.
`team_id`	string
`title`	string
`updated_at`	integer	(timestamp Unix)

Esempio illustrativo; non è una risposta dal vivo:

{
  "created_at": 1791072000,
  "deleted_at": 0,
  "description": "",
  "owner_id": "000000000000000000000000001",
  "parent_id": "000000000000000000000000001",
  "status": "active",
  "team_id": "000000000000000000000000001",
  "title": "Postman example",
  "updated_at": 1791072000
}

Aggiorna team

PUT /v1/team/{id}

Aggiorna un oggetto Team esistente

Imposta team_id usando gli ID restituiti dalle tue risposte API.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Campi di richiesta (il corpo contiene un esempio modificabile):

Campo	Tipo	Obbligatorio	Descrizione
`description`	string	No	Valore predefinito: `""`.
`owner_id`	string	Sì
`parent_id`	string	No
`status`	string	Sì	Valori consentiti: active, inactive, suspended, deleted. Valore predefinito: `"active"`.
`title`	string	Sì

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
`id`	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
`X-Tenant-ID`	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

curl --fail-with-body --request PUT "$ADIOS_API_URL/v1/team/${ADIOS_TEAM_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "owner_id": "YOUR_USER_ID",
  "title": "Postman example team",
  "status": "active"
}
JSON

Sostituisci YOUR_* nel corpo prima dell’invio. L’heredoc tra virgolette mantiene il JSON letterale.

Risposta: HTTP 200

Team aggiornato

Campi di risposta

Campo	Tipo	Descrizione
`created_at`	integer	(timestamp Unix)
`deleted_at`	integer	(timestamp Unix)
`description`	string
`owner_id`	string
`parent_id`	string
`status`	string	Valori consentiti: active, inactive, suspended, deleted.
`team_id`	string
`title`	string
`updated_at`	integer	(timestamp Unix)

Esempio illustrativo; non è una risposta dal vivo:

{
  "created_at": 1791072000,
  "deleted_at": 0,
  "description": "",
  "owner_id": "000000000000000000000000001",
  "parent_id": "000000000000000000000000001",
  "status": "active",
  "team_id": "000000000000000000000000001",
  "title": "Postman example",
  "updated_at": 1791072000
}

Elimina team

DELETE /v1/team/{id}

Elimina un oggetto Team

Imposta team_id usando gli ID restituiti dalle tue risposte API.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
`id`	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
`X-Tenant-ID`	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

curl --fail-with-body --request DELETE "$ADIOS_API_URL/v1/team/${ADIOS_TEAM_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risorsa eliminata.

Campi di risposta

Campo	Tipo	Descrizione
`message`	string

Esempio illustrativo; non è una risposta dal vivo:

{
  "message": "Deleted successfully"
}

Ottieni il contesto di distribuzione

GET /v1/team/deployment-context

Scopri le regioni di distribuzione disponibili e il contesto di distribuzione attivo del team.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
`X-Tenant-ID`	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/team/deployment-context" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.

Elenca i membri del team

GET /v1/team/members

Elenca i membri del team selezionato.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
`X-Tenant-ID`	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/team/members" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.

Elenca gli inviti del team

GET /v1/team/invitations

Elenca gli inviti per il team selezionato.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
`X-Tenant-ID`	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/team/invitations" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.

Invita un membro del team

POST /v1/team/invitations

Invia un invito email per entrare nel team selezionato. role supporta user, manager o team_admin.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
`X-Tenant-ID`	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

curl --fail-with-body --request POST "$ADIOS_API_URL/v1/team/invitations" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "email": "YOUR_INVITE_EMAIL",
  "role": "user"
}
JSON

Sostituisci YOUR_* nel corpo prima dell’invio. L’heredoc tra virgolette mantiene il JSON letterale.

Risposta: HTTP 200

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.

Invia di nuovo l’invito del team

POST /v1/team/invitations/{id}/resend

Invia di nuovo l'email di invito.

Imposta invitation_id usando gli ID restituiti dalle tue risposte API.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
`id`	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
`X-Tenant-ID`	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

curl --fail-with-body --request POST "$ADIOS_API_URL/v1/team/invitations/${ADIOS_INVITATION_ID}/resend" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.

Revoca un invito del team

DELETE /v1/team/invitations/{id}

Revoca un invito in sospeso.

Imposta invitation_id usando gli ID restituiti dalle tue risposte API.

Questa richiesta modifica dati o avvia un’azione. Controlla la destinazione e il corpo prima dell’invio.

Autenticazione: token bearer e intestazione del team mostrate di seguito.

Parametri

Nome	Posizione	Obbligatorio	Descrizione
`id`	path	Sì	Identificativo della risorsa ottenuto dai risultati API del tuo team.
`X-Tenant-ID`	header	Sì	ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico.

Esempio di richiesta

curl --fail-with-body --request DELETE "$ADIOS_API_URL/v1/team/invitations/${ADIOS_INVITATION_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Risposta: HTTP 200

Risposta riuscita. Controlla lo stato restituito per le operazioni che avviano attività asincrone.

Per questa operazione personalizzata non è pubblicato uno schema completo del corpo della risposta. Controlla il contenuto e lo stato restituiti; qui non si presume alcun formato del payload.