Listar Escopos
curl --request GET \
--url https://api.truthlocks.com/v1/scopes \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.truthlocks.com/v1/scopes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/scopes"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/scopes"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}[
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"scope": "<string>",
"resource": "<string>",
"action": "<string>",
"display_name": "<string>",
"description": "<string>",
"category": "<string>",
"is_builtin": true,
"created_at": "2023-11-07T05:31:56Z"
}
]{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Sessões e Ferramentas do Agente
Listar Escopos
Listar todos os escopos de permissão disponíveis, incluindo os internos da plataforma e os escopos personalizados do locatário
GET
/
v1
/
scopes
Listar Escopos
curl --request GET \
--url https://api.truthlocks.com/v1/scopes \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.truthlocks.com/v1/scopes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/scopes"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/scopes"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}[
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"scope": "<string>",
"resource": "<string>",
"action": "<string>",
"display_name": "<string>",
"description": "<string>",
"category": "<string>",
"is_builtin": true,
"created_at": "2023-11-07T05:31:56Z"
}
]{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Listar Escopos
GET /v1/scopes
Retorna todos os escopos de permissão disponíveis para o locatário autenticado. Isso inclui escopos internos definidos pela plataforma e quaisquer escopos personalizados criados pelo locatário. Os escopos seguem o formato resource:action definido pelo protocolo MAIP.
Autenticação
Requer cabeçalhoX-API-Key ou token JWT de portador. O espaço de trabalho é derivado da credencial autenticada; não envie X-Tenant-ID.
Resposta
Retorna um array de objetos de definição de escopo.UUID do locatário que possui este escopo.
null para incorporado no nível da plataforma
escopos.A string de escopo completa no formato
resource:action (por exemplo, "data:read",
"model:train").true para escopos definidos pela plataforma, false para escopos personalizados criados pelo locatário.Exemplo
curl -G https://api.truthlocks.com/v1/scopes \
-H "X-API-Key: tl_live_..." \
-d "category=data"
Categorias de Escopo Integradas
A plataforma oferece mais de 25 escopos integrados em 6 categorias:| Categoria | Escopos | Descrição |
|---|---|---|
data | read, write, delete, * | Acesso a recursos de dados |
model | train, evaluate, deploy, attest, * | Ciclo de vida do modelo ML |
tool | search.web, search.db, execute, * | Invocação de ferramenta |
agent | delegate, manage, inspect, * | Gerenciamento do ciclo de vida do agente |
admin | config, audit, billing, * | Operações administrativas |
receipt | create, verify, revoke, * | Gerenciamento de recibos |
Referência de Formato de Escopo
resource:action Standard scope (e.g., "data:read")
resource:* Wildcard scope (e.g., "data:*" grants all data actions)
!resource:action Negation scope (e.g., "!data:delete" explicitly denies)
resource:sub.action Dotted sub-actions (e.g., "tool:search.web")

