Pular para o conteúdo principal
POST
/
workspaces
/
{workspaceId}
/
organizations
Criar uma organização
curl --request POST \
  --url https://api.altostrat.io/workspaces/{workspaceId}/organizations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Equipe de Marketing",
  "billing_account_id": "cus_a1b2c3d4e5f6g7h8",
  "limits": {
    "locations": 5,
    "users": 20
  },
  "picture": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...",
  "branding": {
    "display_name": "ACME Inc.",
    "login_hint": "acme-inc",
    "colors": {
      "primary": "#007bff"
    }
  }
}'
{
  "id": "org_aBcDeFg123456789",
  "name": "Departamento de Engenharia",
  "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

Insira seu JWT no formato: Bearer {token}

Path Parameters

​
workspaceId
string
required

O ID do workspace.

Example:

"ws_a1b2c3d4e5f6g7h8"

Body

application/json
​
name
string
required

O nome da organização. Máximo de 50 caracteres.

Example:

"Equipe de Marketing"

​
billing_account_id
string | null

O ID da conta de faturamento a ser associada. Obrigatório para organizações raiz nos modos de faturamento single ou assigned. Deve ser null para organizações filhas ou qualquer organização no modo pooled.

Example:

"cus_a1b2c3d4e5f6g7h8"

​
limits
object

Defina limites de recursos para a organização. As chaves são tipos mensuráveis (locations, users, sso). Um valor null remove o limite, 0 desativa o recurso.

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

Uma URL HTTPS pública para uma imagem ou uma URI de dados codificada em base64. A imagem será processada и hospedada pela Altostrat. Deve ser um JPEG, PNG ou GIF com menos de 2MB.

Example:

"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA..."

​
branding
object

Configurações de branding para a organização.

Response

A organização foi criada com sucesso.

​
id
string

Identificador único para a organização (corresponde ao ID da organização Auth0), prefixado com org_.

Example:

"org_aBcDeFg123456789"

​
name
string

O nome legível por humanos da organização.

Example:

"Departamento de Engenharia"

​
workspace_id
string

O ID do workspace ao qual esta organização pertence.

Example:

"ws_a1b2c3d4e5f6g7h8"

​
external_id
string<uuid>

Um identificador estável e único para a organização, independente de seu ID Auth0.

Example:

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

​
parent_org_id
string | null

O ID da organização pai, se esta for uma organização filha.

Example:

"org_zYxWvUt987654321"

​
path
string | null

Uma string separada por # representando o caminho hierárquico dos ancestrais.

Example:

"org_root123#org_parent456"

​
depth
integer

A profundidade da organização na hierarquia (0 para nível superior).

Example:

2

​
billing_account_id
string | null

O ID da conta de faturamento à qual esta organização está associada (no modo assigned).

Example:

"cus_a1b2c3d4e5f6g7h8"

​
picture
string<uri> | null

Uma URL para o logotipo da organização.

Example:

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

​
usage
object
​
limits
object

Um mapa de limites de recursos aplicados diretamente a esta organização. As chaves são tipos mensuráveis (locations, users, sso). Um valor null ou uma chave ausente significa que nenhum limite está definido neste nível. Um valor 0 significa que o recurso está explicitamente desativado.

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