Workspaces

Un workspace es el tenant al que pertenece un inbox. Ver el modelo Workspace para la forma del objeto devuelto.

Comando	HTTP	Descripción
workspaces list	GET /workspaces	Lista los workspaces de tu organización. Paginado por cursor.
workspaces get	GET /workspaces/{id}	Obtiene un workspace por id interno o external_id.
workspaces create	POST /workspaces	Crea un workspace. Requiere un token src=system.
workspaces upsert	PUT /workspaces	Crea o actualiza, emparejado por id y luego external_id.
workspaces update	PATCH /workspaces/{id}	Actualiza en el lugar.
workspaces delete	DELETE /workspaces/{id}	Soft-delete.

Ejemplos

# Listar, filtrado y con máscara de campos
kobana inbox workspaces list \
  --params '{"source": "kobana_app", "limit": 25}' \
  --fields "id,label,slug,source"

# Obtener uno
kobana inbox workspaces get \
  --params '{"id": "WORKSPACE_ID"}' \
  --fields "id,label,monthly_cost_limit,monthly_emails_limit"

# Crear
kobana inbox workspaces create \
  --json '{"label": "Acme Inc.", "source": "kobana_app", "slug": "acme"}'

# Crear o actualizar, emparejado por external_id
kobana inbox workspaces upsert \
  --json '{"external_id": "acme-42", "label": "Acme Inc.", "monthly_cost_limit": 100}'

# Actualizar un límite
kobana inbox workspaces update \
  --params '{"id": "WORKSPACE_ID"}' \
  --json '{"monthly_emails_limit": 5000}'

# Soft-delete
kobana inbox workspaces delete --params '{"id": "WORKSPACE_ID"}' --dry-run

Próximos pasos

• Inboxes — las direcciones de recepción que pertenecen a un workspace.
• Introspección de schema — todos los parámetros que acepta este recurso.