Times · miCore

O que é

Times são os grupos de pessoas da empresa, com um gestor e membros. Existem em todo miCore, com ou sem Quadros: cada quadro pertence a um time, e as solicitações vão de um time para outro.

Na prática: você lista os times para descobrir o gestor e os membros, por exemplo o owner_team_id ao criar um quadro ou o time que recebe uma solicitação.

O que dá para fazer hoje

Listar os times, com filtros e busca.
Consultar um time com o gestor e os membros.

Importante

Só leitura: a API não cria nem edita times.
Não depende de nenhum módulo contratado: é um recurso da empresa, protegido só pela permissão Times.
O gestor e os membros de um time são os elegíveis ao montar um quadro.
Exige o escopo teams:read.

Disponibilidade na API

Endpoints de Times

Consulte os times da empresa e seus membros. Os exemplos abaixo são gerados pelo contrato OpenAPI oficial.

GET /api/v1/teams

Lista os times

Exige o escopo `teams:read`. Use para descobrir o `owner_team_id` e os membros ao criar um quadro.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`status`query	boolean	Não	—
`search`query	string	Não	Busca por nome.
`per_page`query	integer	Não	—

Exemplo de requisição

cURL

curl "$MICORE_BASE_URL/teams" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200

{
    "data": [
        {
            "id": 5,
            "name": "Time de Suporte",
            "status": true,
            "manager": {
                "id": 7,
                "name": "Ana Souza"
            },
            "members": [
                {
                    "id": 9,
                    "name": "Bruno Lima"
                },
                {
                    "id": 12,
                    "name": "Carla Dias"
                }
            ],
            "created_at": "2026-10-19T09:00:00-03:00",
            "updated_at": "2026-10-19T09:00:00-03:00"
        }
    ],
    "links": [],
    "meta": []
}

Respostas possíveis

200 Página de times401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant

GET /api/v1/teams/{team}

Exibe um time

Exige o escopo `teams:read`. Traz o gestor e os membros.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`team`path	integer	Sim	—

Exemplo de requisição

cURL

curl "$MICORE_BASE_URL/teams/{team}" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200

{
    "data": {
        "id": 5,
        "name": "Time de Suporte",
        "status": true,
        "manager": {
            "id": 7,
            "name": "Ana Souza"
        },
        "members": [
            {
                "id": 9,
                "name": "Bruno Lima"
            },
            {
                "id": 12,
                "name": "Carla Dias"
            }
        ],
        "created_at": "2026-10-19T09:00:00-03:00",
        "updated_at": "2026-10-19T09:00:00-03:00"
    }
}

Respostas possíveis

200 Time encontrado401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant