Operações de grants
Operações de grants
Esta página é uma tradução automática da página em inglês, que prevalece. Machine-translated from the English page, which is authoritative.
Os campos exatos que cada operação grants.* recebe e retorna.
Toda op é POST /v1/<op> via HTTP e a ferramenta MCP loom_<op>. Os campos de identidade (org, namespace, agent, user_id, session_id) são preenchidos a partir do token e da sessão MCP quando o transporte consegue fazer isso; em uma chamada HTTP sem token em um servidor de usuário único, é preenchida a org da instalação em todas as ops, exceto code.* e tracker.* (que mantêm a org do próprio plano), e, em algumas ops, também o namespace e o agente; veja identidades e namespaces. O índice de operações explica role, kind e a listagem all do MCP. Campos de entrada desconhecidos são atendidos e listados em ignored_args.
grants.approve
Aprova (ou rejeita) uma solicitação de concessão pendente.
POST /v1/grants.approve · MCP loom_grants_approve · papel admin · idempotente · auditado · não listado no toolset all do MCP
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
namespace |
str |
obrigatório | O namespace que a op lê ou grava. |
subject |
str |
obrigatório | De quem é a solicitação pendente a decidir: um e-mail ou uma claim sub de conta de serviço. |
decision |
Literal['approve', 'reject'] |
'approve' |
approve ativa o papel solicitado (ou o papel substituto); reject descarta a solicitação, mantendo qualquer papel base, ou remove a linha quando o subject não tinha acesso base. |
role |
Literal['viewer', 'writer', 'admin'] | None |
None |
Aprova com um papel diferente do solicitado (uma solicitação de mantenedor respondida como leitor). |
| Campo de saída | Tipo | Significado |
|---|---|---|
subject |
str |
O subject como a solicitação o escreveu. |
namespace |
str |
O namespace que a op lê ou grava. |
decision |
Literal['approve', 'reject'] |
A decisão aplicada (repete a solicitação). |
role |
Literal['viewer', 'writer', 'admin'] | None |
O papel aprovado (em reject, o papel que a solicitação teria tido); None quando não existia linha de concessão para o subject. |
decided_at |
datetime |
Quando a decisão foi gravada (UTC). |
grants.create
Concede a outro sujeito (usuário ou conta de serviço) o papel de viewer / writer / admin em um namespace.
POST /v1/grants.create · MCP loom_grants_create · papel admin · idempotente · auditado
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
namespace |
str |
obrigatório | O namespace que a op lê ou escreve. |
subject |
str |
obrigatório | Um login, um e-mail (ele admite uma conta assim que esse e-mail é verificado: o de uma conta SSO ou o de uma conta vinculada) ou a claim sub de uma conta de serviço. |
role |
Literal['viewer', 'writer', 'admin'] |
obrigatório | viewer, writer ou admin; um namespace de código aceita apenas viewer (leitor) e admin (mantenedor). |
granted_by |
str |
'admin' |
Ignorado quando há autenticação: o servidor registra o chamador autenticado. |
replace |
bool |
False |
A tabela substitui por (org, namespace, subject), então um create abaixo do papel ativo atual do sujeito o rebaixaria silenciosamente. |
| Campo de saída | Tipo | Significado |
|---|---|---|
org |
str |
O tenant (primeiro elemento da tupla de identidade). |
namespace |
str |
O namespace que a op lê ou escreve. |
subject |
str |
O sujeito como a requisição o escreveu (a linha é armazenada sob o login da conta cujo e-mail verificado ele é; caso contrário, como foi escrito). |
role |
Literal['viewer', 'writer', 'admin'] |
O papel agora ativo para o sujeito. |
granted_at |
datetime |
Quando a linha da concessão foi gravada (UTC). |
grants.list
Lista as concessões ativas em um namespace: quem tem acesso e com qual papel.
POST /v1/grants.list · MCP loom_grants_list · role viewer · read
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
namespace |
str |
obrigatório | O namespace que a op lê ou grava. |
limit |
int |
100 |
Linhas por página, uma por pessoa, com a concessão mais recente primeiro; de 1 a 500. |
cursor |
str | None |
None |
Retoma a página anterior no mesmo namespace; deixe sem definir na primeira página. |
fields |
list[str] | None |
None |
Os campos de saída que o chamador lê (uma lista de permissão resolvida contra o modelo da linha; um nome desconhecido resulta em 422); sem definir, todos os campos. |
| Campo de saída | Tipo | Significado |
|---|---|---|
rows |
list[_GrantEntry] |
Concessões vigentes no namespace, ativas e pendentes (as revogadas são excluídas), da mais recente para a mais antiga; uma linha por pessoa, com as outras grafias dela em also. |
next_cursor |
str | None |
Passe como cursor para obter a próxima página; None quando esta página é a última. |
truncated |
bool |
True quando há mais pessoas depois desta página (next_cursor está definido). |
grants.pending_for_me
Todas as solicitações pendentes nos namespaces que o chamador administra, em uma única instrução.
POST /v1/grants.pending_for_me · MCP loom_grants_pending_for_me · role viewer · leitura · não listado no toolset all do MCP
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
limit |
int |
500 |
No máximo esta quantidade de solicitações, das mais recentes para as mais antigas; de 1 a 2,000. |
| Campo de saída | Tipo | Significado |
|---|---|---|
rows |
list[_PendingForMeEntry] |
Solicitações pendentes de entrada ou de elevação nos namespaces que o chamador administra, das mais recentes para as mais antigas; vazio para um chamador anônimo. |
grants.revoke
Remove a concessão de um sujeito em um namespace.
POST /v1/grants.revoke · MCP loom_grants_revoke · role admin · idempotente · auditado · não listado no toolset all do MCP
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
namespace |
str |
obrigatório | O namespace que a op lê ou grava. |
subject |
str |
obrigatório | De quem revogar a concessão: um login handle, um e-mail ou o sub de uma conta de serviço; a linha da pessoa em cada grafia verificada é removida, e uma solicitação pendente é rejeitada. |
| Campo de saída | Tipo | Significado |
|---|---|---|
revoked |
bool |
True quando alguma das linhas de concessão do sujeito foi encontrada e revogada; false quando não havia nenhuma. |
revoked_at |
datetime | None |
Quando a revogação foi gravada (UTC); None quando nada foi revogado. |
grants.share_agent
Permite que outro agente do mesmo trust do chamador leia, ou escreva, no namespace do próprio chamador.
POST /v1/grants.share_agent · MCP loom_grants_share_agent · role writer · idempotente · auditado · não listado no toolset all do MCP
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
namespace |
str |
obrigatório | O namespace do próprio agente chamador, o único que ele pode compartilhar. |
grantee |
str |
obrigatório | O agente do mesmo trust com quem compartilhar, conforme o nome dado pelo seu plano de controle. |
role |
Literal['viewer', 'writer'] |
'viewer' |
O que esse agente pode fazer ali: viewer lê, writer também escreve. |
| Campo de saída | Tipo | Significado |
|---|---|---|
namespace |
str |
O namespace que a op lê ou escreve. |
subject |
str |
O subject sob o qual o grant é armazenado, sa:<trust>:<agent>. |
role |
Literal['viewer', 'writer'] |
O role agora ativo para esse agente. |
granted_at |
datetime |
Quando a linha do grant foi gravada (UTC). |
grants.unshare_agent
Retira o que o chamador emprestou a outro agente da sua confiança.
POST /v1/grants.unshare_agent · MCP loom_grants_unshare_agent · role writer · idempotente · auditado · não listado no toolset all do MCP
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
namespace |
str |
obrigatório | O namespace do próprio agente que faz a chamada. |
grantee |
str |
obrigatório | O agente da mesma confiança cujo grant deve ser revogado. |
| Campo de saída | Tipo | Significado |
|---|---|---|
revoked |
bool |
True quando o agente tinha um grant e ele foi revogado. |
revoked_at |
datetime | None |
Quando a revogação foi gravada (UTC); None quando nada foi revogado. |