Grupos de Workspaces

1. Listar grupos de workspaces

Retorna uma lista de todos os grupos de workspaces.

• URL: /lighthouse/orgs/{org_id}/businesses/{business_id}/workspaces-groups

• Método: GET

• Descrição: Recupera uma lista paginada de workspaces.

Query Params

Nome	Tipo	Obrigatório	Descrição
page	integer	Não	Número da página (padrão: 1)
page_size	integer	Não	Número de resultados por página (padrão: 10)
search	string	Não	Chave utilizada como filtro de busca
context_id	uuid	Não	Id do contexto ao qual o grupo está inserido
sort_field	string	Não	Campo utilizado na ordenação dos resultados (padrão: created_at)
sort_order	string	Não	Determina a ordenação dos resultados (padrão: ASC)

Observações sobre os parâmetros

• page_size: se o valor forncido for maior que 100, será convertido automaticamente para este valor (100).

• sort_field: name ou created_at

• sort_order: ASC ou DESC

Exemplo de Requisição

curl -X GET https://api.piercloud.io/lighthouse/orgs/{org_id}/businesses/{business_id}/workspaces-groups?context_id=uuid \
     -H "Authorization: Bearer <access_token>"

Resposta de Sucesso (200 OK)

{
  "code": "success",
  "data": [
    {
      "id": "uuid",
      "name": "Nome do grupo",
      "description": "Descrição",
      "created_by_id": "uuid",
      "updated_by_id": "uuid",
      "created_at": "2025-01-01T00:00:00.911Z",
      "updated_at": "2025-01-01T00:00:00.911Z",
      "business_id": "uuid",
      "context_id": "uuid",
      "workspaces": [
        {
          "id": 1234,
          "name": "Nome do workspace",
          "description": "Descrição",
          "context_id": "uuid",
          "access_scope": "private",
          "created_at": "2025-01-01T00:00:00.911Z",
          "business_id": "uuid",
          "workspace_group_id": "uuid"
        }
      ],
      "access_scope": "public"
    }
  ],
  "meta": {
    "page": 1,
    "page_size": 10,
    "total": 1
  }
}

Resposta de Erro (400 Bad Request)

{
  "code": "bad-request/invalid-parameters",
  "message": "error message"
}

Resposta de Erro (401 Unauthorized)

{
  "code": "failed",
  "message": "invalid or expired token"
}

Resposta de Erro (403 Forbidden)

{
  "code": "authorization/forbidden",
  "message": "Unable to give access to the user"
}

---

2. Acessar informações de grupo de workspaces

Retorna as informações de um grupo especifico.

• URL: /lighthouse/orgs/{org_id}/businesses/{business_id}/workspaces-groups/{id}

• Método: GET

• Descrição: Retorna informações de um único grupo.

Query Params

Nome	Tipo	Obrigatório	Descrição

Exemplo de Requisição

curl -X GET https://api.piercloud.io/lighthouse/orgs/{org_id}/businesses/{business_id}/workspaces-groups/{id} \
     -H "Authorization: Bearer <access_token>"

Resposta de Sucesso (200 OK)

{
  "code": "success",
  "data": {
    "id": "uuid",
    "name": "Nome do grupo",
    "description": "Descrição",
    "created_at": "2025-01-01T00:00:00.911Z",
    "updated_at": "2025-01-01T00:00:00.911Z",
    "business_id": "uuid",
    "context_id": "uuid",
    "workspaces": [
      {
        "id": 1234,
        "name": "Nome do workspace",
        "description": "Descrição",
        "context_id": "uuid",
        "access_scope": "private",
        "created_at": "2025-01-01T00:00:00.911Z",
        "business_id": "uuid",
        "workspace_group_id": "uuid"
      }
    ],
    "access_scope": "public"
  }
}

Resposta de Erro (400 Bad Request)

{
  "code": "bad-request/invalid-parameters",
  "message": "error message"
}

Resposta de Erro (401 Unauthorized)

{
  "code": "failed",
  "message": "invalid or expired token"
}

Resposta de Erro (403 Forbidden)

{
  "code": "authorization/forbidden",
  "message": "Unable to give access to the user"
}

Resposta de Erro (404 Not Found)

{
  "code": "workspace-group/not-found",
  "message": "Workspace group not found"
}