> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hybridbox.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Authentifizierung
> Die Laufzeitsitzung authentifizieren, beenden und prüfen.
# Authentifizierung
Die Laufzeitsitzung authentifizieren, beenden und prüfen.
Die Beispiele verwenden den A2A-Code-Modus. MCP stellt denselben Code-Modus über sein Tool `execute` bereit.
## Funktionen
### `auth.authorizations.grant`
```text theme={null}
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
```
Authentifizierung: `auth.authorizations.grant`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ----------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `POST /v1/public/accounts/{account_id}/auth/authorizations` | | |
| Name | Typ | Erforderlich |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `account_id` | `str` | ja |
| `grant_kind` | `"capability" \| "account_owner" \| "super_admin"` | ja |
| `subject_id` | `str` | ja |
| `subject_type` | `"user" \| "group" \| "service_account"` | ja |
| `capability_key` | `str \| null` | nein |
| `resource_id` | `str \| null` | nein |
| `resource_type` | `"client" \| "account" \| "workspace" \| "domain" \| "dns_record" \| "mailbox" \| "redirect" \| "forwarding" \| "credential" \| "tenant" \| "route" \| "proxy" \| null` | nein |
| Feld | Typ | Erforderlich |
| ---------------- | ------------- | ------------ |
| `grant_kind` | `str` | ja |
| `id` | `str` | ja |
| `subject_id` | `str` | ja |
| `subject_type` | `str` | ja |
| `capability_key` | `str \| null` | nein |
| `created_at` | `str \| null` | nein |
| `resource_id` | `str \| null` | nein |
| `resource_type` | `str \| null` | nein |
| `revoked_at` | `str \| null` | nein |
Anfrage:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.authorizations.grant(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", grant_kind=\"\", subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"\", capability_key=\"\", resource_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", resource_type=\"\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": ""
},
"responses": [
{
"index": 0,
"function": "auth.authorizations.grant",
"status": "completed",
"result": ""
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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=\"\", subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"\", capability_key=\"\", resource_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", resource_type=\"\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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.grant\",\n \"status\": \"completed\",\n \"result\": \"\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `auth.authorizations.list`
```text theme={null}
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]
```
Authentifizierung: `auth.authorizations.list`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ---------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `GET /v1/public/accounts/{account_id}/auth/authorizations` | | |
| Name | Typ | Erforderlich |
| ----------------- | ---------------------------------------------------------- | ------------ |
| `account_id` | `str` | ja |
| `capability_key` | `str \| null` | nein |
| `grant_kind` | `"capability" \| "account_owner" \| "super_admin" \| null` | nein |
| `include_revoked` | `bool` | nein |
| `subject_id` | `str \| null` | nein |
| `subject_type` | `"user" \| "group" \| "service_account" \| null` | nein |
| Feld | Typ | Erforderlich |
| ---------------- | ------------- | ------------ |
| `grant_kind` | `str` | ja |
| `id` | `str` | ja |
| `subject_id` | `str` | ja |
| `subject_type` | `str` | ja |
| `capability_key` | `str \| null` | nein |
| `created_at` | `str \| null` | nein |
| `resource_id` | `str \| null` | nein |
| `resource_type` | `str \| null` | nein |
| `revoked_at` | `str \| null` | nein |
Anfrage:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.authorizations.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", capability_key=\"\", grant_kind=\"\", include_revoked=true, subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": ""
},
"responses": [
{
"index": 0,
"function": "auth.authorizations.list",
"status": "completed",
"result": ""
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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=\"\", grant_kind=\"\", include_revoked=true, subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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.list\",\n \"status\": \"completed\",\n \"result\": \"\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `auth.authorizations.revoke`
```text theme={null}
auth.authorizations.revoke(account_id: str, grant_id: str) -> {}
```
Authentifizierung: `auth.authorizations.revoke`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------------------------------------------------------------------------ | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `DELETE /v1/public/accounts/{account_id}/auth/authorizations/{grant_id}` | | |
| Name | Typ | Erforderlich |
| ------------ | ----- | ------------ |
| `account_id` | `str` | ja |
| `grant_id` | `str` | ja |
| Feld | Typ | Erforderlich |
| -------- | ---- | ------------ |
| `result` | `{}` | ja |
Anfrage:
```json theme={null}
{
"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\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": {}
},
"responses": [
{
"index": 0,
"function": "auth.authorizations.revoke",
"status": "completed",
"result": {}
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
auth.groups.create(account_id: str, payload: {"account_id": str, "name": str, "attributes"?: {} | null, "description"?: str | null}) -> Session
```
Authentifizierung: `auth.groups.create`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | --------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `POST /v1/public/accounts/{account_id}/auth/groups` | | |
| Name | Typ | Erforderlich |
| ------------- | ------------- | ------------ |
| `account_id` | `str` | ja |
| `name` | `str` | ja |
| `attributes` | `{} \| null` | nein |
| `description` | `str \| null` | nein |
| Feld | Typ | Erforderlich |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `account_id` | `str` | ja |
| `id` | `str` | ja |
| `keycloak_name` | `str` | ja |
| `name` | `str` | ja |
| `attributes` | `{}` | nein |
| `description` | `str \| null` | nein |
| `keycloak_account_id` | `str \| null` | nein |
| `linked_scopes` | `[{"resource_id": str, "resource_type": str}]` | nein |
| `parent_id` | `str \| null` | nein |
| `path` | `str \| null` | nein |
| `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}` | nein |
| `subgroup_ids` | `[str]` | nein |
Anfrage:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.groups.create(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", payload=\"\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": ""
},
"responses": [
{
"index": 0,
"function": "auth.groups.create",
"status": "completed",
"result": ""
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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=\"\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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.create\",\n \"status\": \"completed\",\n \"result\": \"\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `auth.groups.delete`
```text theme={null}
auth.groups.delete(account_id: str, group_id: str) -> {}
```
Authentifizierung: `auth.groups.delete`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ---------------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `DELETE /v1/public/accounts/{account_id}/auth/groups/{group_id}` | | |
| Name | Typ | Erforderlich |
| ------------ | ----- | ------------ |
| `account_id` | `str` | ja |
| `group_id` | `str` | ja |
| Feld | Typ | Erforderlich |
| -------- | ---- | ------------ |
| `result` | `{}` | ja |
Anfrage:
```json theme={null}
{
"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\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": {}
},
"responses": [
{
"index": 0,
"function": "auth.groups.delete",
"status": "completed",
"result": {}
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
auth.groups.get(account_id: str, group_id: str) -> Session
```
Authentifizierung: `auth.groups.get`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `GET /v1/public/accounts/{account_id}/auth/groups/{group_id}` | | |
| Name | Typ | Erforderlich |
| ------------ | ----- | ------------ |
| `account_id` | `str` | ja |
| `group_id` | `str` | ja |
| Feld | Typ | Erforderlich |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `account_id` | `str` | ja |
| `id` | `str` | ja |
| `keycloak_name` | `str` | ja |
| `name` | `str` | ja |
| `attributes` | `{}` | nein |
| `description` | `str \| null` | nein |
| `keycloak_account_id` | `str \| null` | nein |
| `linked_scopes` | `[{"resource_id": str, "resource_type": str}]` | nein |
| `parent_id` | `str \| null` | nein |
| `path` | `str \| null` | nein |
| `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}` | nein |
| `subgroup_ids` | `[str]` | nein |
Anfrage:
```json theme={null}
{
"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\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": ""
},
"responses": [
{
"index": 0,
"function": "auth.groups.get",
"status": "completed",
"result": ""
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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.get\",\n \"status\": \"completed\",\n \"result\": \"\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `auth.groups.invitations.create`
```text theme={null}
auth.groups.invitations.create(account_id: str, group_id: str, email: str, locale?: str | null, note?: str | null) -> Session
```
Authentifizierung: `auth.groups.invitations.create`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | -------------------------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `POST /v1/public/accounts/{account_id}/auth/groups/{group_id}/invitations` | | |
| Name | Typ | Erforderlich |
| ------------ | ------------- | ------------ |
| `account_id` | `str` | ja |
| `group_id` | `str` | ja |
| `email` | `str` | ja |
| `locale` | `str \| null` | nein |
| `note` | `str \| null` | nein |
| Feld | Typ | Erforderlich |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `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}` | ja |
Anfrage:
```json theme={null}
{
"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=\"\", note=\"\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.groups.invitations.create",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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=\"\", note=\"\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
auth.groups.list(account_id: str) -> list[Session]
```
Authentifizierung: `auth.groups.list`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | -------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `GET /v1/public/accounts/{account_id}/auth/groups` | | |
| Name | Typ | Erforderlich |
| ------------ | ----- | ------------ |
| `account_id` | `str` | ja |
| Feld | Typ | Erforderlich |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `account_id` | `str` | ja |
| `id` | `str` | ja |
| `keycloak_name` | `str` | ja |
| `name` | `str` | ja |
| `attributes` | `{}` | nein |
| `description` | `str \| null` | nein |
| `keycloak_account_id` | `str \| null` | nein |
| `linked_scopes` | `[{"resource_id": str, "resource_type": str}]` | nein |
| `parent_id` | `str \| null` | nein |
| `path` | `str \| null` | nein |
| `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}` | nein |
| `subgroup_ids` | `[str]` | nein |
Anfrage:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.groups.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": ""
},
"responses": [
{
"index": 0,
"function": "auth.groups.list",
"status": "completed",
"result": ""
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.groups.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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.list\",\n \"status\": \"completed\",\n \"result\": \"\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `auth.groups.members.add_group`
```text theme={null}
auth.groups.members.add_group(account_id: str, group_id: str, child_group_id: str) -> Session
```
Authentifizierung: `auth.groups.members.add_group`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ----------------------------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `POST /v1/public/accounts/{account_id}/auth/groups/{group_id}/members/groups` | | |
| Name | Typ | Erforderlich |
| ---------------- | ----- | ------------ |
| `account_id` | `str` | ja |
| `group_id` | `str` | ja |
| `child_group_id` | `str` | ja |
| Feld | Typ | Erforderlich |
| ------------- | ------------- | ------------ |
| `group_edges` | `int` | ja |
| `groups_seen` | `int` | ja |
| `total_edges` | `int` | ja |
| `user_edges` | `int` | ja |
| `group_id` | `str \| null` | nein |
Anfrage:
```json theme={null}
{
"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\")"
}
```
Antwort:
```json theme={null}
{
"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
}
```
Anfrage:
```json theme={null}
{
"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\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
auth.groups.members.add_user(account_id: str, group_id: str, user_id: str) -> Session
```
Authentifizierung: `auth.groups.members.add_user`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ---------------------------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `POST /v1/public/accounts/{account_id}/auth/groups/{group_id}/members/users` | | |
| Name | Typ | Erforderlich |
| ------------ | ----- | ------------ |
| `account_id` | `str` | ja |
| `group_id` | `str` | ja |
| `user_id` | `str` | ja |
| Feld | Typ | Erforderlich |
| ------------- | ------------- | ------------ |
| `group_edges` | `int` | ja |
| `groups_seen` | `int` | ja |
| `total_edges` | `int` | ja |
| `user_edges` | `int` | ja |
| `group_id` | `str \| null` | nein |
Anfrage:
```json theme={null}
{
"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\")"
}
```
Antwort:
```json theme={null}
{
"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
}
```
Anfrage:
```json theme={null}
{
"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\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
auth.groups.members.list(account_id: str, group_id: str, page?: int, page_size?: int, search?: str | null) -> Session
```
Authentifizierung: `auth.groups.members.list`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | --------------------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `GET /v1/public/accounts/{account_id}/auth/groups/{group_id}/members` | | |
| Name | Typ | Erforderlich |
| ------------ | ------------- | ------------ |
| `account_id` | `str` | ja |
| `group_id` | `str` | ja |
| `page` | `int` | nein |
| `page_size` | `int` | nein |
| `search` | `str \| null` | nein |
| Feld | Typ | Erforderlich |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `account_id` | `str` | ja |
| `group_id` | `str` | ja |
| `page` | `int` | ja |
| `page_size` | `int` | ja |
| `total` | `int` | ja |
| `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]}]` | nein |
| `linked_scopes` | `[{"resource_id": str, "resource_type": str}]` | nein |
| `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}]` | nein |
| `search` | `str \| null` | nein |
| `users` | `[{"id": str, "email"?: str \| null, "first_name"?: str \| null, "last_name"?: str \| null, "username"?: str \| null}]` | nein |
Anfrage:
```json theme={null}
{
"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=\"\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.groups.members.list",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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=\"\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
auth.groups.members.remove_group(account_id: str, child_group_id: str, group_id: str) -> Session
```
Authentifizierung: `auth.groups.members.remove_group`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `DELETE /v1/public/accounts/{account_id}/auth/groups/{group_id}/members/groups/{child_group_id}` | | |
| Name | Typ | Erforderlich |
| ---------------- | ----- | ------------ |
| `account_id` | `str` | ja |
| `child_group_id` | `str` | ja |
| `group_id` | `str` | ja |
| Feld | Typ | Erforderlich |
| ------------- | ------------- | ------------ |
| `group_edges` | `int` | ja |
| `groups_seen` | `int` | ja |
| `total_edges` | `int` | ja |
| `user_edges` | `int` | ja |
| `group_id` | `str \| null` | nein |
Anfrage:
```json theme={null}
{
"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\")"
}
```
Antwort:
```json theme={null}
{
"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
}
```
Anfrage:
```json theme={null}
{
"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\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
auth.groups.members.remove_user(account_id: str, group_id: str, user_id: str) -> Session
```
Authentifizierung: `auth.groups.members.remove_user`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ---------------------------------------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `DELETE /v1/public/accounts/{account_id}/auth/groups/{group_id}/members/users/{user_id}` | | |
| Name | Typ | Erforderlich |
| ------------ | ----- | ------------ |
| `account_id` | `str` | ja |
| `group_id` | `str` | ja |
| `user_id` | `str` | ja |
| Feld | Typ | Erforderlich |
| ------------- | ------------- | ------------ |
| `group_edges` | `int` | ja |
| `groups_seen` | `int` | ja |
| `total_edges` | `int` | ja |
| `user_edges` | `int` | ja |
| `group_id` | `str \| null` | nein |
Anfrage:
```json theme={null}
{
"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\")"
}
```
Antwort:
```json theme={null}
{
"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
}
```
Anfrage:
```json theme={null}
{
"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\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
auth.groups.update(account_id: str, group_id: str, attributes?: {} | null, description?: str | null, name?: str | null) -> Session
```
Authentifizierung: `auth.groups.update`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | --------------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `PATCH /v1/public/accounts/{account_id}/auth/groups/{group_id}` | | |
| Name | Typ | Erforderlich |
| ------------- | ------------- | ------------ |
| `account_id` | `str` | ja |
| `group_id` | `str` | ja |
| `attributes` | `{} \| null` | nein |
| `description` | `str \| null` | nein |
| `name` | `str \| null` | nein |
| Feld | Typ | Erforderlich |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `account_id` | `str` | ja |
| `id` | `str` | ja |
| `keycloak_name` | `str` | ja |
| `name` | `str` | ja |
| `attributes` | `{}` | nein |
| `description` | `str \| null` | nein |
| `keycloak_account_id` | `str \| null` | nein |
| `linked_scopes` | `[{"resource_id": str, "resource_type": str}]` | nein |
| `parent_id` | `str \| null` | nein |
| `path` | `str \| null` | nein |
| `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}` | nein |
| `subgroup_ids` | `[str]` | nein |
Anfrage:
```json theme={null}
{
"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=\"\", description=\"\", name=\"\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": ""
},
"responses": [
{
"index": 0,
"function": "auth.groups.update",
"status": "completed",
"result": ""
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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=\"\", description=\"\", name=\"\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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.update\",\n \"status\": \"completed\",\n \"result\": \"\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `auth.invitations.create`
```text theme={null}
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
```
Authentifizierung: `auth.invitations.create`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | -------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `POST /v1/public/accounts/{account_id}/auth/invitations` | | |
| Name | Typ | Erforderlich |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `account_id` | `str` | ja |
| `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}]` | ja |
| `email` | `str` | ja |
| `locale` | `str \| null` | nein |
| `note` | `str \| null` | nein |
| Feld | Typ | Erforderlich |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `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}` | ja |
Anfrage:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.invitations.create(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", assignments=\"\", email=\"user@example.com\", locale=\"\", note=\"\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.invitations.create",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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=\"\", email=\"user@example.com\", locale=\"\", note=\"\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
auth.invitations.delete(account_id: str, invitation_id: str) -> {}
```
Authentifizierung: `auth.invitations.delete`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | -------------------------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `DELETE /v1/public/accounts/{account_id}/auth/invitations/{invitation_id}` | | |
| Name | Typ | Erforderlich |
| --------------- | ----- | ------------ |
| `account_id` | `str` | ja |
| `invitation_id` | `str` | ja |
| Feld | Typ | Erforderlich |
| -------- | ---- | ------------ |
| `result` | `{}` | ja |
Anfrage:
```json theme={null}
{
"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\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": {}
},
"responses": [
{
"index": 0,
"function": "auth.invitations.delete",
"status": "completed",
"result": {}
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
auth.invitations.list(account_id: str, email?: str | null, status?: str | null) -> list[Session]
```
Authentifizierung: `auth.invitations.list`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `GET /v1/public/accounts/{account_id}/auth/invitations` | | |
| Name | Typ | Erforderlich |
| ------------ | ------------- | ------------ |
| `account_id` | `str` | ja |
| `email` | `str \| null` | nein |
| `status` | `str \| null` | nein |
| Feld | Typ | Erforderlich |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `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}]` | ja |
| `email` | `str` | ja |
| `id` | `str` | ja |
| `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}` | ja |
| `status` | `str` | ja |
| `accepted_at` | `str \| null` | nein |
| `accepted_subject_id` | `str \| null` | nein |
| `created_at` | `str \| null` | nein |
| `expires_at` | `str \| null` | nein |
| `note` | `str \| null` | nein |
Anfrage:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.invitations.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", email=\"user@example.com\", status=\"\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.invitations.list",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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=\"\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
auth.invitations.resend(account_id: str, invitation_id: str, payload?: {"locale"?: str | null} | null) -> Session
```
Authentifizierung: `auth.invitations.resend`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------------------------------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `POST /v1/public/accounts/{account_id}/auth/invitations/{invitation_id}/resend` | | |
| Name | Typ | Erforderlich |
| --------------- | ---------------------------------- | ------------ |
| `account_id` | `str` | ja |
| `invitation_id` | `str` | ja |
| `payload` | `{"locale"?: str \| null} \| null` | ja |
| Feld | Typ | Erforderlich |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `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}]` | ja |
| `email` | `str` | ja |
| `id` | `str` | ja |
| `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}` | ja |
| `status` | `str` | ja |
| `accepted_at` | `str \| null` | nein |
| `accepted_subject_id` | `str \| null` | nein |
| `created_at` | `str \| null` | nein |
| `expires_at` | `str \| null` | nein |
| `note` | `str \| null` | nein |
Anfrage:
```json theme={null}
{
"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=\"\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.invitations.resend",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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=\"\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
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
```
Authentifizierung: `auth.invitations.update`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------------------------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `PATCH /v1/public/accounts/{account_id}/auth/invitations/{invitation_id}` | | |
| Name | Typ | Erforderlich |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `account_id` | `str` | ja |
| `invitation_id` | `str` | ja |
| `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}]` | ja |
| `note` | `str \| null` | nein |
| Feld | Typ | Erforderlich |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `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}]` | ja |
| `email` | `str` | ja |
| `id` | `str` | ja |
| `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}` | ja |
| `status` | `str` | ja |
| `accepted_at` | `str \| null` | nein |
| `accepted_subject_id` | `str \| null` | nein |
| `created_at` | `str \| null` | nein |
| `expires_at` | `str \| null` | nein |
| `note` | `str \| null` | nein |
Anfrage:
```json theme={null}
{
"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=\"\", note=\"\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "auth.invitations.update",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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=\"\", note=\"\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
auth.login(identifier?: str, email?: str, username?: str, password?: str, service_account_token?: str) -> Session
```
Authentifizierung: `auth.login`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------- | ------------------------------ | ------ |
| Erforderliche Berechtigung | `Keine` | Authentifizierung erforderlich | `nein` |
| Ausführungsmodus | `sync` | | |
| Name | Typ | Erforderlich |
| ----------------------- | ----- | ------------ |
| `identifier` | `str` | nein |
| `email` | `str` | nein |
| `username` | `str` | nein |
| `password` | `str` | nein |
| `service_account_token` | `str` | nein |
| Feld | Typ | Erforderlich |
| -------------------- | ------ | ------------ |
| `authenticated` | `bool` | ja |
| `principal_type` | `str` | ja |
| `user_id` | `str` | nein |
| `service_account_id` | `str` | nein |
| `email` | `str` | nein |
| `username` | `str` | nein |
| `expires_at` | `str` | ja |
Anfrage:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.login(identifier=\"\", email=\"user@example.com\", username=\"\", password=\"\", service_account_token=\"\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": true
},
"responses": [
{
"index": 0,
"function": "auth.login",
"status": "completed",
"result": true
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.login(identifier=\"\", email=\"user@example.com\", username=\"\", password=\"\", service_account_token=\"\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
auth.logout() -> Session
```
Authentifizierung: `auth.logout`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------- | ------------------------------ | ------ |
| Erforderliche Berechtigung | `Keine` | Authentifizierung erforderlich | `nein` |
| Ausführungsmodus | `sync` | | |
| Feld | Typ | Erforderlich |
| ------------ | ------ | ------------ |
| `logged_out` | `bool` | ja |
Anfrage:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.logout()"
}
```
Antwort:
```json theme={null}
{
"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
}
```
Anfrage:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.logout()"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
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
```
Authentifizierung: `auth.role_assignments.create`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `POST /v1/public/accounts/{account_id}/auth/role-assignments` | | |
| Name | Typ | Erforderlich |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `account_id` | `str` | ja |
| `resource_id` | `str` | ja |
| `resource_type` | `"client" \| "account" \| "workspace" \| "domain" \| "dns_record" \| "mailbox" \| "redirect" \| "forwarding" \| "credential" \| "tenant" \| "route" \| "proxy"` | ja |
| `role_key` | `"viewer" \| "editor" \| "domain_manager" \| "manager" \| "dns_manager" \| "ip_manager" \| "billing_viewer" \| "billing_admin" \| "credential_manager"` | ja |
| `subject_id` | `str` | ja |
| `subject_type` | `"user" \| "group" \| "service_account"` | ja |
| Feld | Typ | Erforderlich |
| -------------------------- | ------------- | ------------ |
| `expanded_capability_keys` | `[str]` | ja |
| `id` | `str` | ja |
| `resource_id` | `str` | ja |
| `resource_type` | `str` | ja |
| `role_key` | `str` | ja |
| `subject_id` | `str` | ja |
| `subject_type` | `str` | ja |
| `created_at` | `str \| null` | nein |
| `revoked_at` | `str \| null` | nein |
Anfrage:
```json theme={null}
{
"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=\"\", role_key=\"\", subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": ""
},
"responses": [
{
"index": 0,
"function": "auth.role_assignments.create",
"status": "completed",
"result": ""
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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=\"\", role_key=\"\", subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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.create\",\n \"status\": \"completed\",\n \"result\": \"\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `auth.role_assignments.delete`
```text theme={null}
auth.role_assignments.delete(account_id: str, assignment_id: str) -> {}
```
Authentifizierung: `auth.role_assignments.delete`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------------------------------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `DELETE /v1/public/accounts/{account_id}/auth/role-assignments/{assignment_id}` | | |
| Name | Typ | Erforderlich |
| --------------- | ----- | ------------ |
| `account_id` | `str` | ja |
| `assignment_id` | `str` | ja |
| Feld | Typ | Erforderlich |
| -------- | ---- | ------------ |
| `result` | `{}` | ja |
Anfrage:
```json theme={null}
{
"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\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": {}
},
"responses": [
{
"index": 0,
"function": "auth.role_assignments.delete",
"status": "completed",
"result": {}
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
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]
```
Authentifizierung: `auth.role_assignments.list`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------------------------------------------------------------ | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `GET /v1/public/accounts/{account_id}/auth/role-assignments` | | |
| Name | Typ | Erforderlich |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `account_id` | `str` | ja |
| `include_revoked` | `bool` | nein |
| `role_key` | `"viewer" \| "editor" \| "domain_manager" \| "manager" \| "dns_manager" \| "ip_manager" \| "billing_viewer" \| "billing_admin" \| "credential_manager" \| null` | nein |
| `subject_id` | `str \| null` | nein |
| `subject_type` | `"user" \| "group" \| "service_account" \| null` | nein |
| Feld | Typ | Erforderlich |
| -------------------------- | ------------- | ------------ |
| `expanded_capability_keys` | `[str]` | ja |
| `id` | `str` | ja |
| `resource_id` | `str` | ja |
| `resource_type` | `str` | ja |
| `role_key` | `str` | ja |
| `subject_id` | `str` | ja |
| `subject_type` | `str` | ja |
| `created_at` | `str \| null` | nein |
| `revoked_at` | `str \| null` | nein |
Anfrage:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.role_assignments.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", include_revoked=true, role_key=\"\", subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": ""
},
"responses": [
{
"index": 0,
"function": "auth.role_assignments.list",
"status": "completed",
"result": ""
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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=\"\", subject_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", subject_type=\"\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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.list\",\n \"status\": \"completed\",\n \"result\": \"\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `auth.service_accounts.create`
```text theme={null}
auth.service_accounts.create(account_id: str, name: str, expires_at?: str | null) -> Session
```
Authentifizierung: `auth.service_accounts.create`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `POST /v1/public/accounts/{account_id}/auth/service-accounts` | | |
| Name | Typ | Erforderlich |
| ------------ | ------------- | ------------ |
| `account_id` | `str` | ja |
| `name` | `str` | ja |
| `expires_at` | `str \| null` | nein |
| Feld | Typ | Erforderlich |
| -------------------- | ------------- | ------------ |
| `account_id` | `str` | ja |
| `created_at` | `str` | ja |
| `id` | `str` | ja |
| `name` | `str` | ja |
| `token` | `str` | ja |
| `token_last4` | `str` | ja |
| `token_prefix` | `str` | ja |
| `token_public_id` | `str` | ja |
| `updated_at` | `str` | ja |
| `created_by_user_id` | `str \| null` | nein |
| `expires_at` | `str \| null` | nein |
| `last_used_at` | `str \| null` | nein |
| `revoked_at` | `str \| null` | nein |
| `revoked_by_user_id` | `str \| null` | nein |
Anfrage:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.service_accounts.create(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", name=\"\", expires_at=\"\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": ""
},
"responses": [
{
"index": 0,
"function": "auth.service_accounts.create",
"status": "completed",
"result": ""
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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=\"\", expires_at=\"\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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.create\",\n \"status\": \"completed\",\n \"result\": \"\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `auth.service_accounts.list`
```text theme={null}
auth.service_accounts.list(account_id: str, include_revoked?: bool) -> list[Session]
```
Authentifizierung: `auth.service_accounts.list`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------------------------------------------------------------ | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `GET /v1/public/accounts/{account_id}/auth/service-accounts` | | |
| Name | Typ | Erforderlich |
| ----------------- | ------ | ------------ |
| `account_id` | `str` | ja |
| `include_revoked` | `bool` | nein |
| Feld | Typ | Erforderlich |
| -------------------- | ------------- | ------------ |
| `account_id` | `str` | ja |
| `created_at` | `str` | ja |
| `id` | `str` | ja |
| `name` | `str` | ja |
| `token_last4` | `str` | ja |
| `token_prefix` | `str` | ja |
| `token_public_id` | `str` | ja |
| `updated_at` | `str` | ja |
| `created_by_user_id` | `str \| null` | nein |
| `expires_at` | `str \| null` | nein |
| `last_used_at` | `str \| null` | nein |
| `revoked_at` | `str \| null` | nein |
| `revoked_by_user_id` | `str \| null` | nein |
Anfrage:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.service_accounts.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", include_revoked=true)"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": ""
},
"responses": [
{
"index": 0,
"function": "auth.service_accounts.list",
"status": "completed",
"result": ""
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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)"
}
}
}
```
Antwort:
```json theme={null}
{
"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.list\",\n \"status\": \"completed\",\n \"result\": \"\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `auth.service_accounts.revoke`
```text theme={null}
auth.service_accounts.revoke(account_id: str, service_account_id: str) -> {}
```
Authentifizierung: `auth.service_accounts.revoke`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------------------------------------------------------------------------------------ | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `DELETE /v1/public/accounts/{account_id}/auth/service-accounts/{service_account_id}` | | |
| Name | Typ | Erforderlich |
| -------------------- | ----- | ------------ |
| `account_id` | `str` | ja |
| `service_account_id` | `str` | ja |
| Feld | Typ | Erforderlich |
| -------- | ---- | ------------ |
| `result` | `{}` | ja |
Anfrage:
```json theme={null}
{
"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\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": {}
},
"responses": [
{
"index": 0,
"function": "auth.service_accounts.revoke",
"status": "completed",
"result": {}
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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`
```text theme={null}
auth.service_accounts.rotate(account_id: str, service_account_id: str) -> Session
```
Authentifizierung: `auth.service_accounts.rotate`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `POST /v1/public/accounts/{account_id}/auth/service-accounts/{service_account_id}/rotate` | | |
| Name | Typ | Erforderlich |
| -------------------- | ----- | ------------ |
| `account_id` | `str` | ja |
| `service_account_id` | `str` | ja |
| Feld | Typ | Erforderlich |
| -------------------- | ------------- | ------------ |
| `account_id` | `str` | ja |
| `created_at` | `str` | ja |
| `id` | `str` | ja |
| `name` | `str` | ja |
| `token` | `str` | ja |
| `token_last4` | `str` | ja |
| `token_prefix` | `str` | ja |
| `token_public_id` | `str` | ja |
| `updated_at` | `str` | ja |
| `created_by_user_id` | `str \| null` | nein |
| `expires_at` | `str \| null` | nein |
| `last_used_at` | `str \| null` | nein |
| `revoked_at` | `str \| null` | nein |
| `revoked_by_user_id` | `str \| null` | nein |
Anfrage:
```json theme={null}
{
"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\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": ""
},
"responses": [
{
"index": 0,
"function": "auth.service_accounts.rotate",
"status": "completed",
"result": ""
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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.rotate\",\n \"status\": \"completed\",\n \"result\": \"\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `auth.users.list`
```text theme={null}
auth.users.list(account_id: str, limit?: int, search?: str | null) -> list[Session]
```
Authentifizierung: `auth.users.list`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------------------------------------------------- | ------------------------------ | ------------- |
| Erforderliche Berechtigung | `auth.manage` | Authentifizierung erforderlich | `ja` |
| Ausführungsmodus | `sync` | Fähigkeit | `auth.manage` |
| Ressourcentyp | `account` | Ressourcen-ID-Feld | `account_id` |
| Öffentliche API-Route | `GET /v1/public/accounts/{account_id}/auth/users` | | |
| Name | Typ | Erforderlich |
| ------------ | ------------- | ------------ |
| `account_id` | `str` | ja |
| `limit` | `int` | nein |
| `search` | `str \| null` | nein |
| Feld | Typ | Erforderlich |
| ------------ | ------------- | ------------ |
| `id` | `str` | ja |
| `email` | `str \| null` | nein |
| `first_name` | `str \| null` | nein |
| `last_name` | `str \| null` | nein |
| `username` | `str \| null` | nein |
Anfrage:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.users.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", limit=123, search=\"\")"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": ""
},
"responses": [
{
"index": 0,
"function": "auth.users.list",
"status": "completed",
"result": ""
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"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=\"\")"
}
}
}
```
Antwort:
```json theme={null}
{
"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.users.list\",\n \"status\": \"completed\",\n \"result\": \"\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `auth.whoami`
```text theme={null}
auth.whoami() -> Session
```
Authentifizierung: `auth.whoami`.
| Eigenschaft | Wert | Eigenschaft | Wert |
| -------------------------- | ------- | ------------------------------ | ------ |
| Erforderliche Berechtigung | `Keine` | Authentifizierung erforderlich | `nein` |
| Ausführungsmodus | `sync` | | |
| Feld | Typ | Erforderlich |
| --------------- | ------ | ------------ |
| `authenticated` | `bool` | ja |
| `user_id` | `str` | nein |
| `email` | `str` | nein |
| `username` | `str` | nein |
| `expires_at` | `str` | ja |
Anfrage:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "auth.whoami()"
}
```
Antwort:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": true
},
"responses": [
{
"index": 0,
"function": "auth.whoami",
"status": "completed",
"result": true
}
],
"complexity_score": 1
}
```
Anfrage:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "auth.whoami()"
}
}
}
```
Antwort:
```json theme={null}
{
"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
}
}
```