认证
对运行时会话进行身份验证、结束和检查。 示例使用 A2A 代码模式。MCP 通过execute 工具公开相同的代码模式。
函数
auth.authorizations.grant
auth.authorizations.grant(account_id: str, grant_kind: "capability" | "account_owner" | "super_admin", subject_id: str, subject_type: "user" | "group" | "service_account", capability_key?: str | null, resource_id?: str | null, resource_type?: "client" | "account" | "workspace" | "domain" | "dns_record" | "mailbox" | "redirect" | "forwarding" | "credential" | "tenant" | "route" | "proxy" | null) -> Session
auth.authorizations.grant.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | POST /v1/public/accounts/{account_id}/auth/authorizations |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
grant_kind | "capability" | "account_owner" | "super_admin" | 是 |
subject_id | str | 是 |
subject_type | "user" | "group" | "service_account" | 是 |
capability_key | str | null | 否 |
resource_id | str | null | 否 |
resource_type | "client" | "account" | "workspace" | "domain" | "dns_record" | "mailbox" | "redirect" | "forwarding" | "credential" | "tenant" | "route" | "proxy" | null | 否 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
grant_kind | str | 是 |
id | str | 是 |
subject_id | str | 是 |
subject_type | str | 是 |
capability_key | str | null | 否 |
created_at | str | null | 否 |
resource_id | str | null | 否 |
resource_type | str | null | 否 |
revoked_at | str | null | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.authorizations.grant(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", grant_kind=\"<string>\", subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"<string>\", capability_key=\"<string>\", resource_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", resource_type=\"<string>\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": "<string>"
},
"responses": [
{
"index": 0,
"function": "auth.authorizations.grant",
"status": "completed",
"result": "<string>"
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.authorizations.grant(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", grant_kind=\"<string>\", subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"<string>\", capability_key=\"<string>\", resource_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", resource_type=\"<string>\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": \"<string>\"\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.authorizations.grant\",\n \"status\": \"completed\",\n \"result\": \"<string>\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.authorizations.list
auth.authorizations.list(account_id: str, capability_key?: str | null, grant_kind?: "capability" | "account_owner" | "super_admin" | null, include_revoked?: bool, subject_id?: str | null, subject_type?: "user" | "group" | "service_account" | null) -> list[Session]
auth.authorizations.list.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | GET /v1/public/accounts/{account_id}/auth/authorizations |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
capability_key | str | null | 否 |
grant_kind | "capability" | "account_owner" | "super_admin" | null | 否 |
include_revoked | bool | 否 |
subject_id | str | null | 否 |
subject_type | "user" | "group" | "service_account" | null | 否 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
grant_kind | str | 是 |
id | str | 是 |
subject_id | str | 是 |
subject_type | str | 是 |
capability_key | str | null | 否 |
created_at | str | null | 否 |
resource_id | str | null | 否 |
resource_type | str | null | 否 |
revoked_at | str | null | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.authorizations.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", capability_key=\"<string>\", grant_kind=\"<string>\", include_revoked=true, subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"<string>\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": "<string>"
},
"responses": [
{
"index": 0,
"function": "auth.authorizations.list",
"status": "completed",
"result": "<string>"
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.authorizations.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", capability_key=\"<string>\", grant_kind=\"<string>\", include_revoked=true, subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"<string>\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": \"<string>\"\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.authorizations.list\",\n \"status\": \"completed\",\n \"result\": \"<string>\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.authorizations.revoke
auth.authorizations.revoke(account_id: str, grant_id: str) -> {}
auth.authorizations.revoke.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | DELETE /v1/public/accounts/{account_id}/auth/authorizations/{grant_id} |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
grant_id | str | 是 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
result | {} | 是 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.authorizations.revoke(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", grant_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": {}
},
"responses": [
{
"index": 0,
"function": "auth.authorizations.revoke",
"status": "completed",
"result": {}
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.authorizations.revoke(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", grant_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": {}\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.authorizations.revoke\",\n \"status\": \"completed\",\n \"result\": {}\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.groups.create
auth.groups.create(account_id: str, payload: {"account_id": str, "name": str, "attributes"?: {} | null, "description"?: str | null}) -> Session
auth.groups.create.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | POST /v1/public/accounts/{account_id}/auth/groups |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
name | str | 是 |
attributes | {} | null | 否 |
description | str | null | 否 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
id | str | 是 |
keycloak_name | str | 是 |
name | str | 是 |
attributes | {} | 否 |
description | str | null | 否 |
keycloak_account_id | str | null | 否 |
linked_scopes | [{"resource_id": str, "resource_type": str}] | 否 |
parent_id | str | null | 否 |
path | str | null | 否 |
permission_context | {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str} | 否 |
subgroup_ids | [str] | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.groups.create(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", payload=\"<string>\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": "<string>"
},
"responses": [
{
"index": 0,
"function": "auth.groups.create",
"status": "completed",
"result": "<string>"
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.groups.create(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", payload=\"<string>\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": \"<string>\"\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.groups.create\",\n \"status\": \"completed\",\n \"result\": \"<string>\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.groups.delete
auth.groups.delete(account_id: str, group_id: str) -> {}
auth.groups.delete.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | DELETE /v1/public/accounts/{account_id}/auth/groups/{group_id} |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
group_id | str | 是 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
result | {} | 是 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.groups.delete(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": {}
},
"responses": [
{
"index": 0,
"function": "auth.groups.delete",
"status": "completed",
"result": {}
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.groups.delete(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": {}\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.groups.delete\",\n \"status\": \"completed\",\n \"result\": {}\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.groups.get
auth.groups.get(account_id: str, group_id: str) -> Session
auth.groups.get.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | GET /v1/public/accounts/{account_id}/auth/groups/{group_id} |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
group_id | str | 是 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
id | str | 是 |
keycloak_name | str | 是 |
name | str | 是 |
attributes | {} | 否 |
description | str | null | 否 |
keycloak_account_id | str | null | 否 |
linked_scopes | [{"resource_id": str, "resource_type": str}] | 否 |
parent_id | str | null | 否 |
path | str | null | 否 |
permission_context | {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str} | 否 |
subgroup_ids | [str] | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.groups.get(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": "<string>"
},
"responses": [
{
"index": 0,
"function": "auth.groups.get",
"status": "completed",
"result": "<string>"
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.groups.get(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": \"<string>\"\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.groups.get\",\n \"status\": \"completed\",\n \"result\": \"<string>\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.groups.invitations.create
auth.groups.invitations.create(account_id: str, group_id: str, email: str, locale?: str | null, note?: str | null) -> Session
auth.groups.invitations.create.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | POST /v1/public/accounts/{account_id}/auth/groups/{group_id}/invitations |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
group_id | str | 是 |
email | str | 是 |
locale | str | null | 否 |
note | str | null | 否 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
result | {"assignments": [{"assignment_kind": str, "position": int, "capability_key"?: str | null, "grant_kind"?: str | null, "group_id"?: str | null, "id"?: str | null, "resource_id"?: str | null, "resource_type"?: str | null, "role_key"?: str | null}], "email": str, "id": str, "permission_context": {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str}, "status": str, "accepted_at"?: str | null, "accepted_subject_id"?: str | null, "created_at"?: str | null, "expires_at"?: str | null, "note"?: str | null} | {"accepted_subject_id": str, "assignment_count": int, "email": str, "grant_count": int, "group_membership_count": int, "permission_context": {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str}, "role_assignment_count": int, "mode"?: str, "status"?: str} | 是 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.groups.invitations.create(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", email=\"user@example.com\", locale=\"<string>\", note=\"<string>\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.groups.invitations.create",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.groups.invitations.create(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", email=\"user@example.com\", locale=\"<string>\", note=\"<string>\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": 123\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.groups.invitations.create\",\n \"status\": \"completed\",\n \"result\": 123\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.groups.list
auth.groups.list(account_id: str) -> list[Session]
auth.groups.list.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | GET /v1/public/accounts/{account_id}/auth/groups |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
id | str | 是 |
keycloak_name | str | 是 |
name | str | 是 |
attributes | {} | 否 |
description | str | null | 否 |
keycloak_account_id | str | null | 否 |
linked_scopes | [{"resource_id": str, "resource_type": str}] | 否 |
parent_id | str | null | 否 |
path | str | null | 否 |
permission_context | {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str} | 否 |
subgroup_ids | [str] | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.groups.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": "<string>"
},
"responses": [
{
"index": 0,
"function": "auth.groups.list",
"status": "completed",
"result": "<string>"
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.groups.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": \"<string>\"\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.groups.list\",\n \"status\": \"completed\",\n \"result\": \"<string>\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.groups.members.add_group
auth.groups.members.add_group(account_id: str, group_id: str, child_group_id: str) -> Session
auth.groups.members.add_group.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | POST /v1/public/accounts/{account_id}/auth/groups/{group_id}/members/groups |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
group_id | str | 是 |
child_group_id | str | 是 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
group_edges | int | 是 |
groups_seen | int | 是 |
total_edges | int | 是 |
user_edges | int | 是 |
group_id | str | null | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.groups.members.add_group(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", child_group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.groups.members.add_group",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.groups.members.add_group(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", child_group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": 123\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.groups.members.add_group\",\n \"status\": \"completed\",\n \"result\": 123\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.groups.members.add_user
auth.groups.members.add_user(account_id: str, group_id: str, user_id: str) -> Session
auth.groups.members.add_user.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | POST /v1/public/accounts/{account_id}/auth/groups/{group_id}/members/users |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
group_id | str | 是 |
user_id | str | 是 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
group_edges | int | 是 |
groups_seen | int | 是 |
total_edges | int | 是 |
user_edges | int | 是 |
group_id | str | null | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.groups.members.add_user(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", user_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.groups.members.add_user",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.groups.members.add_user(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", user_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": 123\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.groups.members.add_user\",\n \"status\": \"completed\",\n \"result\": 123\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.groups.members.list
auth.groups.members.list(account_id: str, group_id: str, page?: int, page_size?: int, search?: str | null) -> Session
auth.groups.members.list.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | GET /v1/public/accounts/{account_id}/auth/groups/{group_id}/members |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
group_id | str | 是 |
page | int | 否 |
page_size | int | 否 |
search | str | null | 否 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
group_id | str | 是 |
page | int | 是 |
page_size | int | 是 |
total | int | 是 |
groups | [{"account_id": str, "id": str, "keycloak_name": str, "name": str, "attributes"?: {}, "description"?: str | null, "keycloak_account_id"?: str | null, "linked_scopes"?: [{"resource_id": str, "resource_type": str}], "parent_id"?: str | null, "path"?: str | null, "permission_context"?: {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str}, "subgroup_ids"?: [str]}] | 否 |
linked_scopes | [{"resource_id": str, "resource_type": str}] | 否 |
members | [{"resolved": bool, "subject_id": str, "subject_type": str, "group"?: {"account_id": str, "id": str, "keycloak_name": str, "name": str, "attributes"?: {}, "description"?: str | null, "keycloak_account_id"?: str | null, "linked_scopes"?: [{"resource_id": str, "resource_type": str}], "parent_id"?: str | null, "path"?: str | null, "permission_context"?: {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str}, "subgroup_ids"?: [str]} | null, "user"?: {"id": str, "email"?: str | null, "first_name"?: str | null, "last_name"?: str | null, "username"?: str | null} | null}] | 否 |
search | str | null | 否 |
users | [{"id": str, "email"?: str | null, "first_name"?: str | null, "last_name"?: str | null, "username"?: str | null}] | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.groups.members.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", page=123, page_size=123, search=\"<string>\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.groups.members.list",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.groups.members.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", page=123, page_size=123, search=\"<string>\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": 123\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.groups.members.list\",\n \"status\": \"completed\",\n \"result\": 123\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.groups.members.remove_group
auth.groups.members.remove_group(account_id: str, child_group_id: str, group_id: str) -> Session
auth.groups.members.remove_group.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | DELETE /v1/public/accounts/{account_id}/auth/groups/{group_id}/members/groups/{child_group_id} |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
child_group_id | str | 是 |
group_id | str | 是 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
group_edges | int | 是 |
groups_seen | int | 是 |
total_edges | int | 是 |
user_edges | int | 是 |
group_id | str | null | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.groups.members.remove_group(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", child_group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.groups.members.remove_group",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.groups.members.remove_group(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", child_group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": 123\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.groups.members.remove_group\",\n \"status\": \"completed\",\n \"result\": 123\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.groups.members.remove_user
auth.groups.members.remove_user(account_id: str, group_id: str, user_id: str) -> Session
auth.groups.members.remove_user.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | DELETE /v1/public/accounts/{account_id}/auth/groups/{group_id}/members/users/{user_id} |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
group_id | str | 是 |
user_id | str | 是 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
group_edges | int | 是 |
groups_seen | int | 是 |
total_edges | int | 是 |
user_edges | int | 是 |
group_id | str | null | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.groups.members.remove_user(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", user_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.groups.members.remove_user",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.groups.members.remove_user(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", user_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": 123\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.groups.members.remove_user\",\n \"status\": \"completed\",\n \"result\": 123\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.groups.update
auth.groups.update(account_id: str, group_id: str, attributes?: {} | null, description?: str | null, name?: str | null) -> Session
auth.groups.update.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | PATCH /v1/public/accounts/{account_id}/auth/groups/{group_id} |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
group_id | str | 是 |
attributes | {} | null | 否 |
description | str | null | 否 |
name | str | null | 否 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
id | str | 是 |
keycloak_name | str | 是 |
name | str | 是 |
attributes | {} | 否 |
description | str | null | 否 |
keycloak_account_id | str | null | 否 |
linked_scopes | [{"resource_id": str, "resource_type": str}] | 否 |
parent_id | str | null | 否 |
path | str | null | 否 |
permission_context | {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str} | 否 |
subgroup_ids | [str] | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.groups.update(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", attributes=\"<string>\", description=\"<string>\", name=\"<string>\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": "<string>"
},
"responses": [
{
"index": 0,
"function": "auth.groups.update",
"status": "completed",
"result": "<string>"
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.groups.update(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", group_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", attributes=\"<string>\", description=\"<string>\", name=\"<string>\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": \"<string>\"\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.groups.update\",\n \"status\": \"completed\",\n \"result\": \"<string>\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.invitations.create
auth.invitations.create(account_id: str, assignments: [{"capability_key"?: str | null, "grant_kind"?: "capability" | "account_owner" | "super_admin" | null, "group_id"?: str | null, "resource_id"?: str | null, "resource_type"?: "client" | "account" | "workspace" | "domain" | "dns_record" | "mailbox" | "redirect" | "forwarding" | "credential" | "tenant" | "route" | "proxy" | null, "role_key"?: str | null}], email: str, locale?: str | null, note?: str | null) -> Session
auth.invitations.create.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | POST /v1/public/accounts/{account_id}/auth/invitations |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
assignments | [{"capability_key"?: str | null, "grant_kind"?: "capability" | "account_owner" | "super_admin" | null, "group_id"?: str | null, "resource_id"?: str | null, "resource_type"?: "client" | "account" | "workspace" | "domain" | "dns_record" | "mailbox" | "redirect" | "forwarding" | "credential" | "tenant" | "route" | "proxy" | null, "role_key"?: str | null}] | 是 |
email | str | 是 |
locale | str | null | 否 |
note | str | null | 否 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
result | {"assignments": [{"assignment_kind": str, "position": int, "capability_key"?: str | null, "grant_kind"?: str | null, "group_id"?: str | null, "id"?: str | null, "resource_id"?: str | null, "resource_type"?: str | null, "role_key"?: str | null}], "email": str, "id": str, "permission_context": {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str}, "status": str, "accepted_at"?: str | null, "accepted_subject_id"?: str | null, "created_at"?: str | null, "expires_at"?: str | null, "note"?: str | null} | {"accepted_subject_id": str, "assignment_count": int, "email": str, "grant_count": int, "group_membership_count": int, "permission_context": {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str}, "role_assignment_count": int, "mode"?: str, "status"?: str} | 是 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.invitations.create(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", assignments=\"<string>\", email=\"user@example.com\", locale=\"<string>\", note=\"<string>\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.invitations.create",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.invitations.create(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", assignments=\"<string>\", email=\"user@example.com\", locale=\"<string>\", note=\"<string>\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": 123\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.invitations.create\",\n \"status\": \"completed\",\n \"result\": 123\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.invitations.delete
auth.invitations.delete(account_id: str, invitation_id: str) -> {}
auth.invitations.delete.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | DELETE /v1/public/accounts/{account_id}/auth/invitations/{invitation_id} |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
invitation_id | str | 是 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
result | {} | 是 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.invitations.delete(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", invitation_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": {}
},
"responses": [
{
"index": 0,
"function": "auth.invitations.delete",
"status": "completed",
"result": {}
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.invitations.delete(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", invitation_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": {}\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.invitations.delete\",\n \"status\": \"completed\",\n \"result\": {}\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.invitations.list
auth.invitations.list(account_id: str, email?: str | null, status?: str | null) -> list[Session]
auth.invitations.list.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | GET /v1/public/accounts/{account_id}/auth/invitations |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
email | str | null | 否 |
status | str | null | 否 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
assignments | [{"assignment_kind": str, "position": int, "capability_key"?: str | null, "grant_kind"?: str | null, "group_id"?: str | null, "id"?: str | null, "resource_id"?: str | null, "resource_type"?: str | null, "role_key"?: str | null}] | 是 |
email | str | 是 |
id | str | 是 |
permission_context | {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str} | 是 |
status | str | 是 |
accepted_at | str | null | 否 |
accepted_subject_id | str | null | 否 |
created_at | str | null | 否 |
expires_at | str | null | 否 |
note | str | null | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.invitations.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", email=\"user@example.com\", status=\"<string>\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.invitations.list",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.invitations.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", email=\"user@example.com\", status=\"<string>\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": 123\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.invitations.list\",\n \"status\": \"completed\",\n \"result\": 123\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.invitations.resend
auth.invitations.resend(account_id: str, invitation_id: str, payload?: {"locale"?: str | null} | null) -> Session
auth.invitations.resend.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | POST /v1/public/accounts/{account_id}/auth/invitations/{invitation_id}/resend |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
invitation_id | str | 是 |
payload | {"locale"?: str | null} | null | 是 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
assignments | [{"assignment_kind": str, "position": int, "capability_key"?: str | null, "grant_kind"?: str | null, "group_id"?: str | null, "id"?: str | null, "resource_id"?: str | null, "resource_type"?: str | null, "role_key"?: str | null}] | 是 |
email | str | 是 |
id | str | 是 |
permission_context | {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str} | 是 |
status | str | 是 |
accepted_at | str | null | 否 |
accepted_subject_id | str | null | 否 |
created_at | str | null | 否 |
expires_at | str | null | 否 |
note | str | null | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.invitations.resend(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", invitation_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", payload=\"<string>\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.invitations.resend",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.invitations.resend(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", invitation_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", payload=\"<string>\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": 123\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.invitations.resend\",\n \"status\": \"completed\",\n \"result\": 123\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.invitations.update
auth.invitations.update(account_id: str, invitation_id: str, assignments: [{"capability_key"?: str | null, "grant_kind"?: "capability" | "account_owner" | "super_admin" | null, "group_id"?: str | null, "resource_id"?: str | null, "resource_type"?: "client" | "account" | "workspace" | "domain" | "dns_record" | "mailbox" | "redirect" | "forwarding" | "credential" | "tenant" | "route" | "proxy" | null, "role_key"?: str | null}], note?: str | null) -> Session
auth.invitations.update.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | PATCH /v1/public/accounts/{account_id}/auth/invitations/{invitation_id} |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
invitation_id | str | 是 |
assignments | [{"capability_key"?: str | null, "grant_kind"?: "capability" | "account_owner" | "super_admin" | null, "group_id"?: str | null, "resource_id"?: str | null, "resource_type"?: "client" | "account" | "workspace" | "domain" | "dns_record" | "mailbox" | "redirect" | "forwarding" | "credential" | "tenant" | "route" | "proxy" | null, "role_key"?: str | null}] | 是 |
note | str | null | 否 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
assignments | [{"assignment_kind": str, "position": int, "capability_key"?: str | null, "grant_kind"?: str | null, "group_id"?: str | null, "id"?: str | null, "resource_id"?: str | null, "resource_type"?: str | null, "role_key"?: str | null}] | 是 |
email | str | 是 |
id | str | 是 |
permission_context | {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str} | 是 |
status | str | 是 |
accepted_at | str | null | 否 |
accepted_subject_id | str | null | 否 |
created_at | str | null | 否 |
expires_at | str | null | 否 |
note | str | null | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.invitations.update(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", invitation_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", assignments=\"<string>\", note=\"<string>\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.invitations.update",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.invitations.update(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", invitation_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", assignments=\"<string>\", note=\"<string>\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": 123\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.invitations.update\",\n \"status\": \"completed\",\n \"result\": 123\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.login
auth.login(identifier?: str, email?: str, username?: str, password?: str, service_account_token?: str) -> Session
auth.login.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | 无 | 需要身份验证 | 否 |
| 执行模式 | sync |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
identifier | str | 否 |
email | str | 否 |
username | str | 否 |
password | str | 否 |
service_account_token | str | 否 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
authenticated | bool | 是 |
principal_type | str | 是 |
user_id | str | 否 |
service_account_id | str | 否 |
email | str | 否 |
username | str | 否 |
expires_at | str | 是 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.login(identifier=\"<string>\", email=\"user@example.com\", username=\"<string>\", password=\"<string>\", service_account_token=\"<string>\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": true
},
"responses": [
{
"index": 0,
"function": "auth.login",
"status": "completed",
"result": true
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.login(identifier=\"<string>\", email=\"user@example.com\", username=\"<string>\", password=\"<string>\", service_account_token=\"<string>\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": true\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.login\",\n \"status\": \"completed\",\n \"result\": true\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.logout
auth.logout() -> Session
auth.logout.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | 无 | 需要身份验证 | 否 |
| 执行模式 | sync |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
logged_out | bool | 是 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.logout()"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": {
"logged_out": true
}
},
"responses": [
{
"index": 0,
"function": "auth.logout",
"status": "completed",
"result": {
"logged_out": true
}
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.logout()"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": {\n \"logged_out\": true\n }\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.logout\",\n \"status\": \"completed\",\n \"result\": {\n \"logged_out\": true\n }\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.role_assignments.create
auth.role_assignments.create(account_id: str, resource_id: str, resource_type: "client" | "account" | "workspace" | "domain" | "dns_record" | "mailbox" | "redirect" | "forwarding" | "credential" | "tenant" | "route" | "proxy", role_key: "viewer" | "editor" | "domain_manager" | "manager" | "dns_manager" | "ip_manager" | "billing_viewer" | "billing_admin" | "credential_manager", subject_id: str, subject_type: "user" | "group" | "service_account") -> Session
auth.role_assignments.create.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | POST /v1/public/accounts/{account_id}/auth/role-assignments |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
resource_id | str | 是 |
resource_type | "client" | "account" | "workspace" | "domain" | "dns_record" | "mailbox" | "redirect" | "forwarding" | "credential" | "tenant" | "route" | "proxy" | 是 |
role_key | "viewer" | "editor" | "domain_manager" | "manager" | "dns_manager" | "ip_manager" | "billing_viewer" | "billing_admin" | "credential_manager" | 是 |
subject_id | str | 是 |
subject_type | "user" | "group" | "service_account" | 是 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
expanded_capability_keys | [str] | 是 |
id | str | 是 |
resource_id | str | 是 |
resource_type | str | 是 |
role_key | str | 是 |
subject_id | str | 是 |
subject_type | str | 是 |
created_at | str | null | 否 |
revoked_at | str | null | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.role_assignments.create(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", resource_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", resource_type=\"<string>\", role_key=\"<string>\", subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"<string>\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": "<string>"
},
"responses": [
{
"index": 0,
"function": "auth.role_assignments.create",
"status": "completed",
"result": "<string>"
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.role_assignments.create(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", resource_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", resource_type=\"<string>\", role_key=\"<string>\", subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"<string>\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": \"<string>\"\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.role_assignments.create\",\n \"status\": \"completed\",\n \"result\": \"<string>\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.role_assignments.delete
auth.role_assignments.delete(account_id: str, assignment_id: str) -> {}
auth.role_assignments.delete.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | DELETE /v1/public/accounts/{account_id}/auth/role-assignments/{assignment_id} |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
assignment_id | str | 是 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
result | {} | 是 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.role_assignments.delete(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", assignment_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": {}
},
"responses": [
{
"index": 0,
"function": "auth.role_assignments.delete",
"status": "completed",
"result": {}
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.role_assignments.delete(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", assignment_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": {}\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.role_assignments.delete\",\n \"status\": \"completed\",\n \"result\": {}\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.role_assignments.list
auth.role_assignments.list(account_id: str, include_revoked?: bool, role_key?: "viewer" | "editor" | "domain_manager" | "manager" | "dns_manager" | "ip_manager" | "billing_viewer" | "billing_admin" | "credential_manager" | null, subject_id?: str | null, subject_type?: "user" | "group" | "service_account" | null) -> list[Session]
auth.role_assignments.list.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | GET /v1/public/accounts/{account_id}/auth/role-assignments |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
include_revoked | bool | 否 |
role_key | "viewer" | "editor" | "domain_manager" | "manager" | "dns_manager" | "ip_manager" | "billing_viewer" | "billing_admin" | "credential_manager" | null | 否 |
subject_id | str | null | 否 |
subject_type | "user" | "group" | "service_account" | null | 否 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
expanded_capability_keys | [str] | 是 |
id | str | 是 |
resource_id | str | 是 |
resource_type | str | 是 |
role_key | str | 是 |
subject_id | str | 是 |
subject_type | str | 是 |
created_at | str | null | 否 |
revoked_at | str | null | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.role_assignments.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", include_revoked=true, role_key=\"<string>\", subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"<string>\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": "<string>"
},
"responses": [
{
"index": 0,
"function": "auth.role_assignments.list",
"status": "completed",
"result": "<string>"
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.role_assignments.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", include_revoked=true, role_key=\"<string>\", subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"<string>\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": \"<string>\"\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.role_assignments.list\",\n \"status\": \"completed\",\n \"result\": \"<string>\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.service_accounts.create
auth.service_accounts.create(account_id: str, name: str, expires_at?: str | null) -> Session
auth.service_accounts.create.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | POST /v1/public/accounts/{account_id}/auth/service-accounts |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
name | str | 是 |
expires_at | str | null | 否 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
created_at | str | 是 |
id | str | 是 |
name | str | 是 |
token | str | 是 |
token_last4 | str | 是 |
token_prefix | str | 是 |
token_public_id | str | 是 |
updated_at | str | 是 |
created_by_user_id | str | null | 否 |
expires_at | str | null | 否 |
last_used_at | str | null | 否 |
revoked_at | str | null | 否 |
revoked_by_user_id | str | null | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.service_accounts.create(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", name=\"<string>\", expires_at=\"<string>\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": "<string>"
},
"responses": [
{
"index": 0,
"function": "auth.service_accounts.create",
"status": "completed",
"result": "<string>"
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.service_accounts.create(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", name=\"<string>\", expires_at=\"<string>\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": \"<string>\"\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.service_accounts.create\",\n \"status\": \"completed\",\n \"result\": \"<string>\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.service_accounts.list
auth.service_accounts.list(account_id: str, include_revoked?: bool) -> list[Session]
auth.service_accounts.list.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | GET /v1/public/accounts/{account_id}/auth/service-accounts |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
include_revoked | bool | 否 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
created_at | str | 是 |
id | str | 是 |
name | str | 是 |
token_last4 | str | 是 |
token_prefix | str | 是 |
token_public_id | str | 是 |
updated_at | str | 是 |
created_by_user_id | str | null | 否 |
expires_at | str | null | 否 |
last_used_at | str | null | 否 |
revoked_at | str | null | 否 |
revoked_by_user_id | str | null | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.service_accounts.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", include_revoked=true)"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": "<string>"
},
"responses": [
{
"index": 0,
"function": "auth.service_accounts.list",
"status": "completed",
"result": "<string>"
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.service_accounts.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", include_revoked=true)"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": \"<string>\"\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.service_accounts.list\",\n \"status\": \"completed\",\n \"result\": \"<string>\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.service_accounts.revoke
auth.service_accounts.revoke(account_id: str, service_account_id: str) -> {}
auth.service_accounts.revoke.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | DELETE /v1/public/accounts/{account_id}/auth/service-accounts/{service_account_id} |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
service_account_id | str | 是 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
result | {} | 是 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.service_accounts.revoke(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", service_account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": {}
},
"responses": [
{
"index": 0,
"function": "auth.service_accounts.revoke",
"status": "completed",
"result": {}
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.service_accounts.revoke(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", service_account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": {}\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.service_accounts.revoke\",\n \"status\": \"completed\",\n \"result\": {}\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.service_accounts.rotate
auth.service_accounts.rotate(account_id: str, service_account_id: str) -> Session
auth.service_accounts.rotate.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | POST /v1/public/accounts/{account_id}/auth/service-accounts/{service_account_id}/rotate |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
service_account_id | str | 是 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
created_at | str | 是 |
id | str | 是 |
name | str | 是 |
token | str | 是 |
token_last4 | str | 是 |
token_prefix | str | 是 |
token_public_id | str | 是 |
updated_at | str | 是 |
created_by_user_id | str | null | 否 |
expires_at | str | null | 否 |
last_used_at | str | null | 否 |
revoked_at | str | null | 否 |
revoked_by_user_id | str | null | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.service_accounts.rotate(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", service_account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": "<string>"
},
"responses": [
{
"index": 0,
"function": "auth.service_accounts.rotate",
"status": "completed",
"result": "<string>"
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.service_accounts.rotate(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", service_account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": \"<string>\"\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.service_accounts.rotate\",\n \"status\": \"completed\",\n \"result\": \"<string>\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.users.list
auth.users.list(account_id: str, limit?: int, search?: str | null) -> list[Session]
auth.users.list.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | auth.manage | 需要身份验证 | 是 |
| 执行模式 | sync | 能力 | auth.manage |
| 资源类型 | account | 资源 ID 字段 | account_id |
| 公共 API 路由 | GET /v1/public/accounts/{account_id}/auth/users |
参数
参数
| 名称 | 类型 | 必需 |
|---|---|---|
account_id | str | 是 |
limit | int | 否 |
search | str | null | 否 |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
id | str | 是 |
email | str | null | 否 |
first_name | str | null | 否 |
last_name | str | null | 否 |
username | str | null | 否 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.users.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", limit=123, search=\"<string>\")"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": "<string>"
},
"responses": [
{
"index": 0,
"function": "auth.users.list",
"status": "completed",
"result": "<string>"
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.users.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", limit=123, search=\"<string>\")"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": \"<string>\"\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.users.list\",\n \"status\": \"completed\",\n \"result\": \"<string>\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
auth.whoami
auth.whoami() -> Session
auth.whoami.
| 属性 | 值 | 属性 | 值 |
|---|---|---|---|
| 所需权限 | 无 | 需要身份验证 | 否 |
| 执行模式 | sync |
返回值
返回值
| 字段 | 类型 | 必需 |
|---|---|---|
authenticated | bool | 是 |
user_id | str | 否 |
email | str | 否 |
username | str | 否 |
expires_at | str | 是 |
A2A 示例
A2A 示例
请求:响应:
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.whoami()"
}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": true
},
"responses": [
{
"index": 0,
"function": "auth.whoami",
"status": "completed",
"result": true
}
],
"complexity_score": 1
}
MCP 示例
MCP 示例
请求:响应:
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.whoami()"
}
}
}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": true\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"auth.whoami\",\n \"status\": \"completed\",\n \"result\": true\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}