Saltar al contenido principal
PATCH
/
workspaces
/
{workspaceId}
/
organizations
/
{organizationId}
Actualizar una organización
curl --request PATCH \
  --url https://api.altostrat.io/workspaces/{workspaceId}/organizations/{organizationId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Equipo de Marketing Global",
  "billing_account_id": "cus_a1b2c3d4e5f6g7h8",
  "limits": {
    "users": 100,
    "locations": null
  },
  "picture": "https://example.com/new_logo.png",
  "branding": {
    "display_name": "ACME Inc.",
    "login_hint": "acme-inc",
    "colors": {
      "primary": "#007bff"
    }
  }
}'
{
  "id": "org_aBcDeFg123456789",
  "name": "Departamento de Ingeniería",
  "workspace_id": "ws_a1b2c3d4e5f6g7h8",
  "external_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "parent_org_id": "org_zYxWvUt987654321",
  "path": "org_root123#org_parent456",
  "depth": 2,
  "billing_account_id": "cus_a1b2c3d4e5f6g7h8",
  "picture": "https://cdn.altostrat.io/logos/engineering.png",
  "usage": {
    "usage": {
      "locations": 2,
      "users": 5
    },
    "subtree_usage": {
      "locations": 10,
      "users": 25
    }
  },
  "limits": {
    "locations": 10,
    "users": 50
  },
  "branding": {
    "display_name": "ACME Corp",
    "login_hint": "acme-corp",
    "colors": {
      "primary": "#FF5733",
      "page_background": "#FFFFFF"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Introduzca su JWT en el formato: Bearer {token}

Path Parameters

​
workspaceId
string
required

El ID del espacio de trabajo.

Example:

"ws_a1b2c3d4e5f6g7h8"

​
organizationId
string
required

El ID de la organización.

Example:

"org_aBcDeFg123456789"

Body

application/json

Proporcione uno o más campos para actualizar. Los campos no proporcionados se dejarán sin cambios.

​
name
string

El nuevo nombre para la organización. Máximo 50 caracteres.

Example:

"Equipo de Marketing Global"

​
billing_account_id
string

El ID de la cuenta de facturación a asociar con una organización raíz.

Example:

"cus_a1b2c3d4e5f6g7h8"

​
limits
object

Actualizar límites de recursos. Para eliminar un límite, pase la clave con un valor null.

Example:
{ "users": 100, "locations": null }
​
picture
string | null

Una URL HTTPS pública o una URI de datos base64 para el nuevo logotipo. Para eliminar el logotipo, proporcione null.

Example:

"https://example.com/new_logo.png"

​
branding
object

Configuración de la marca para la organización.

Response

El objeto de la organización actualizada.

​
id
string

Identificador único para la organización (corresponde al ID de organización de Auth0), con prefijo org_.

Example:

"org_aBcDeFg123456789"

​
name
string

El nombre legible por humanos de la organización.

Example:

"Departamento de Ingeniería"

​
workspace_id
string

El ID del espacio de trabajo al que pertenece esta organización.

Example:

"ws_a1b2c3d4e5f6g7h8"

​
external_id
string<uuid>

Un identificador único y estable para la organización, independiente de su ID de Auth0.

Example:

"a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"

​
parent_org_id
string | null

El ID de la organización padre, si esta es una organización hija.

Example:

"org_zYxWvUt987654321"

​
path
string | null

Una cadena separada por # que representa la ruta jerárquica de los ancestros.

Example:

"org_root123#org_parent456"

​
depth
integer

La profundidad de la organización en la jerarquía (0 para nivel superior).

Example:

2

​
billing_account_id
string | null

El ID de la cuenta de facturación a la que está asociada esta organización (en modo assigned).

Example:

"cus_a1b2c3d4e5f6g7h8"

​
picture
string<uri> | null

Una URL al logotipo de la organización.

Example:

"https://cdn.altostrat.io/logos/engineering.png"

​
usage
object
​
limits
object

Un mapa de límites de recursos aplicados directamente a esta organización. Las claves son tipos medibles (locations, users, sso). Un valor null o una clave faltante significa que no se establece ningún límite a este nivel. Un valor 0 significa que el recurso está explícitamente deshabilitado.

Example:
{ "locations": 10, "users": 50 }
​
branding
object