API de equipos

Gestiona equipos y miembros. Las solicitudes siguen sujetas a los permisos de tu cuenta y de tu equipo.

Usa Autenticación de la API para las solicitudes protegidas. Los ejemplos usan tus propios IDs de recursos y un token temporal; las respuestas de ejemplo guardadas son sintéticas.

Método	Ruta	Operación
`GET`	`/v1/team`	Listar equipos
`POST`	`/v1/team`	Crear equipo
`GET`	`/v1/team/{id}`	Obtener equipo
`PUT`	`/v1/team/{id}`	Actualizar equipo
`DELETE`	`/v1/team/{id}`	Eliminar el equipo
`GET`	`/v1/team/deployment-context`	Obtener contexto de despliegue
`GET`	`/v1/team/members`	Listar miembros del equipo
`GET`	`/v1/team/invitations`	Listar invitaciones del equipo
`POST`	`/v1/team/invitations`	Invitar a un miembro del equipo
`POST`	`/v1/team/invitations/{id}/resend`	Reenviar invitación del equipo
`DELETE`	`/v1/team/invitations/{id}`	Revocar invitación del equipo

Listar equipos

GET /v1/team

Devuelve una lista paginada de Team

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.
`page`	consulta	no	Número de página
`per_page`	consulta	no	Elementos por página

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

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

Respuesta: HTTP 200

Lista de Team

Campos de respuesta

Campo	Tipo	Descripción
`data`	array
`data[].created_at`	integer	(marca de tiempo Unix)
`data[].deleted_at`	integer	(marca de tiempo Unix)
`data[].description`	string
`data[].owner_id`	string
`data[].parent_id`	string
`data[].status`	string	Valores permitidos: active, inactive, suspended, deleted.
`data[].team_id`	string
`data[].title`	string
`data[].updated_at`	integer	(marca de tiempo Unix)
`pagination`	object
`pagination.page`	integer	Número de página actual
`pagination.per_page`	integer	Número de elementos por página
`pagination.total`	integer	Número total de elementos

Ejemplo ilustrativo; no es una respuesta real:

{
  "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
  }
}

Crear equipo

POST /v1/team

Crea un nuevo Team

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Campos de la solicitud (el cuerpo contiene un ejemplo editable):

Campo	Tipo	Obligatorio	Descripción
`description`	string	no	Valor predeterminado: `""`.
`owner_id`	string	sí
`parent_id`	string	no
`status`	string	sí	Valores permitidos: active, inactive, suspended, deleted. Valor predeterminado: `"active"`.
`title`	string	sí

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

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

Reemplaza los marcadores YOUR_* del cuerpo antes de enviar la solicitud. El heredoc entrecomillado conserva el JSON literal.

Respuesta: HTTP 201

Team creado

Campos de respuesta

Campo	Tipo	Descripción
`created_at`	integer	(marca de tiempo Unix)
`deleted_at`	integer	(marca de tiempo Unix)
`description`	string
`owner_id`	string
`parent_id`	string
`status`	string	Valores permitidos: active, inactive, suspended, deleted.
`team_id`	string
`title`	string
`updated_at`	integer	(marca de tiempo Unix)

Ejemplo ilustrativo; no es una respuesta real:

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

Obtener equipo

GET /v1/team/{id}

Devuelve un único Team

Configura team_id usando IDs de tus propias respuestas de la API.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`id`	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

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"

Respuesta: HTTP 200

Equipo

Campos de respuesta

Campo	Tipo	Descripción
`created_at`	integer	(marca de tiempo Unix)
`deleted_at`	integer	(marca de tiempo Unix)
`description`	string
`owner_id`	string
`parent_id`	string
`status`	string	Valores permitidos: active, inactive, suspended, deleted.
`team_id`	string
`title`	string
`updated_at`	integer	(marca de tiempo Unix)

Ejemplo ilustrativo; no es una respuesta real:

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

Actualizar equipo

PUT /v1/team/{id}

Actualiza un Team existente

Configura team_id usando IDs de tus propias respuestas de la API.

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Campos de la solicitud (el cuerpo contiene un ejemplo editable):

Campo	Tipo	Obligatorio	Descripción
`description`	string	no	Valor predeterminado: `""`.
`owner_id`	string	sí
`parent_id`	string	no
`status`	string	sí	Valores permitidos: active, inactive, suspended, deleted. Valor predeterminado: `"active"`.
`title`	string	sí

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`id`	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

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

Reemplaza los marcadores YOUR_* del cuerpo antes de enviar la solicitud. El heredoc entrecomillado conserva el JSON literal.

Respuesta: HTTP 200

Team actualizado

Campos de respuesta

Campo	Tipo	Descripción
`created_at`	integer	(marca de tiempo Unix)
`deleted_at`	integer	(marca de tiempo Unix)
`description`	string
`owner_id`	string
`parent_id`	string
`status`	string	Valores permitidos: active, inactive, suspended, deleted.
`team_id`	string
`title`	string
`updated_at`	integer	(marca de tiempo Unix)

Ejemplo ilustrativo; no es una respuesta real:

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

Eliminar el equipo

DELETE /v1/team/{id}

Elimina un Team

Configura team_id usando IDs de tus propias respuestas de la API.

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`id`	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

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"

Respuesta: HTTP 200

Recurso eliminado.

Campos de respuesta

Campo	Tipo	Descripción
`message`	string

Ejemplo ilustrativo; no es una respuesta real:

{
  "message": "Deleted successfully"
}

Obtener contexto de despliegue

GET /v1/team/deployment-context

Descubre las regiones de despliegue disponibles y el contexto de despliegue del equipo activo.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

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"

Respuesta: HTTP 200

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.

Listar miembros del equipo

GET /v1/team/members

Lista los miembros del equipo seleccionado.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

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"

Respuesta: HTTP 200

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.

Listar invitaciones del equipo

GET /v1/team/invitations

Lista las invitaciones del equipo seleccionado.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

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"

Respuesta: HTTP 200

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.

Invitar a un miembro del equipo

POST /v1/team/invitations

Envía una invitación por correo electrónico para unirse al equipo seleccionado. role admite user, manager o team_admin.

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

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

Reemplaza los marcadores YOUR_* del cuerpo antes de enviar la solicitud. El heredoc entrecomillado conserva el JSON literal.

Respuesta: HTTP 200

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.

Reenviar invitación del equipo

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

Envía de nuevo el correo de invitación.

Configura invitation_id usando IDs de tus propias respuestas de la API.

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`id`	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

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"

Respuesta: HTTP 200

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.

Revocar invitación del equipo

DELETE /v1/team/invitations/{id}

Revoca una invitación pendiente.

Configura invitation_id usando IDs de tus propias respuestas de la API.

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`id`	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

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"

Respuesta: HTTP 200

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.