### list_tenant_skills

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Lists installed skills for a tenant, grouped by category.

```APIDOC
## list_tenant_skills

### Description
Lists installed skills for a tenant, grouped by category.

### Method
POST

### Endpoint
/list_tenant_skills

### Parameters
#### Request Body
- **tenant_id** (string) - Required - The ID of the tenant.

### Request Example
{
  "tenant_id": "tenant_123"
}
```

--------------------------------

### Download Artifact Example

Source: https://bewize.ai/docs/hermes-hub/agent-environment

When creating a downloadable artifact, place the final file under `~/workspace` and reference that path. The Hub can convert these references into signed download links.

```text
Download: ~/workspace/report.pdf
```

--------------------------------

### Get Tenant Skill File

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Reads a specific tenant skill file. Use this to retrieve the content of a file associated with a tenant's skill.

```json
{
  "tenant_id": "tenant_123",
  "path": "content/writer/SKILL.md"
}
```

--------------------------------

### Tenant Lifecycle Management

Source: https://bewize.ai/llms-full.txt

Endpoints for managing the lifecycle of tenant agents, including starting, stopping, and restarting.

```APIDOC
## Tenant Lifecycle Management

### Description
Controls the lifecycle of tenant agents.

### Endpoints
- `GET /v1/tenants/{tenantId}/agent`: Retrieves the status of the tenant agent.
- `POST /v1/tenants/{tenantId}/agent/start`: Starts the tenant agent.
- `POST /v1/tenants/{tenantId}/agent/stop`: Stops the tenant agent.
- `POST /v1/tenants/{tenantId}/agent/restart`: Restarts the tenant agent.
- `GET /v1/tenants/{tenantId}/agent-card`: Retrieves the agent card for the tenant.
```

--------------------------------

### Flavors

Source: https://bewize.ai/docs/hermes-hub/external-api

Endpoints for managing flavor catalog, installing flavors, and managing flavor versions and their evaluations.

```APIDOC
## GET /v1/flavors

### Description
List flavor catalog.

### Method
GET

### Endpoint
/v1/flavors

## POST /v1/flavors

### Description
Install a flavor package.

### Method
POST

### Endpoint
/v1/flavors

## GET /v1/flavors/{flavorId}

### Description
Get one flavor catalog entry.

### Method
GET

### Endpoint
/v1/flavors/{flavorId}

#### Path Parameters
- **flavorId** (string) - Required - The ID of the flavor to retrieve.

## GET /v1/flavors/{flavorId}/versions/{flavorVersion}

### Description
Get one flavor version.

### Method
GET

### Endpoint
/v1/flavors/{flavorId}/versions/{flavorVersion}

#### Path Parameters
- **flavorId** (string) - Required - The ID of the flavor.
- **flavorVersion** (string) - Required - The version of the flavor.

## DELETE /v1/flavors/{flavorId}/versions/{flavorVersion}

### Description
Delete an unused flavor version.

### Method
DELETE

### Endpoint
/v1/flavors/{flavorId}/versions/{flavorVersion}

#### Path Parameters
- **flavorId** (string) - Required - The ID of the flavor.
- **flavorVersion** (string) - Required - The version of the flavor to delete.

## GET /v1/flavors/{flavorId}/versions/{flavorVersion}/contents

### Description
Return renderable flavor contents.

### Method
GET

### Endpoint
/v1/flavors/{flavorId}/versions/{flavorVersion}/contents

#### Path Parameters
- **flavorId** (string) - Required - The ID of the flavor.
- **flavorVersion** (string) - Required - The version of the flavor.

## GET /v1/flavors/{flavorId}/versions/{flavorVersion}/eval-suites

### Description
List flavor eval suites.

### Method
GET

### Endpoint
/v1/flavors/{flavorId}/versions/{flavorVersion}/eval-suites

#### Path Parameters
- **flavorId** (string) - Required - The ID of the flavor.
- **flavorVersion** (string) - Required - The version of the flavor.

## POST /v1/flavors/{flavorId}/versions/{flavorVersion}/eval-runs

### Description
Start an eval run.

### Method
POST

### Endpoint
/v1/flavors/{flavorId}/versions/{flavorVersion}/eval-runs

#### Path Parameters
- **flavorId** (string) - Required - The ID of the flavor.
- **flavorVersion** (string) - Required - The version of the flavor.

## POST /v1/flavors/{flavorId}/versions/{flavorVersion}:deprecate

### Description
Deprecate a flavor version.

### Method
POST

### Endpoint
/v1/flavors/{flavorId}/versions/{flavorVersion}:deprecate

#### Path Parameters
- **flavorId** (string) - Required - The ID of the flavor.
- **flavorVersion** (string) - Required - The version of the flavor to deprecate.
```

--------------------------------

### Get Tenant Impact Configuration

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Retrieves the tenant-impacting Hub configuration. Input is an empty JSON object.

```json
{}
```

--------------------------------

### get_tenant_impact_config

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Gets the tenant-impacting Hub configuration view. No input required.

```APIDOC
## get_tenant_impact_config

### Description
Gets the tenant-impacting Hub configuration view.

### Input
`{}`.
```

--------------------------------

### get_agent_specialization

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Gets hosted-agent specialization text and status. No input required.

```APIDOC
## get_agent_specialization

### Description
Gets hosted-agent specialization text and status.

### Input
`{}`.
```

--------------------------------

### Skills Endpoints

Source: https://bewize.ai/docs/hermes-hub/external-api

Endpoints for managing tenant skills, including listing installed skills, listing skill files, reading skill files, and setting skill states.

```APIDOC
## GET /v1/tenants/{tenantId}/skills

### Description
Lists installed skills for a tenant.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}/skills

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

```APIDOC
## GET /v1/tenants/{tenantId}/skills/{category}/{skill}/files

### Description
Lists files for a specific skill within a category.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}/skills/{category}/{skill}/files

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
- **category** (string) - Required - The category of the skill.
- **skill** (string) - Required - The name of the skill.
```

```APIDOC
## GET /v1/tenants/{tenantId}/skill-files/{skillPath}

### Description
Reads a specific skill file.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}/skill-files/{skillPath}

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
- **skillPath** (string) - Required - The path to the skill file.
```

```APIDOC
## PUT /v1/tenants/{tenantId}/skills/{skillName}/state

### Description
Sets the enabled or disabled state for a skill.

### Method
PUT

### Endpoint
/v1/tenants/{tenantId}/skills/{skillName}/state

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
- **skillName** (string) - Required - The name of the skill.
```

--------------------------------

### get_agent_policy

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Gets the hub-wide agent policy. No input required.

```APIDOC
## get_agent_policy

### Description
Gets the hub-wide agent policy.

### Input
`{}`.
```

--------------------------------

### get_tenant_cron

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Gets a specific cron job for a tenant. Requires tenant ID and job ID.

```APIDOC
## get_tenant_cron

### Description
Gets one cron job.

### Input
```json
{
  "tenant_id": "tenant_123",
  "job_id": "job_123"
}
```
```

--------------------------------

### Tenant Agent Lifecycle Endpoints

Source: https://bewize.ai/docs/hermes-hub/external-api

Endpoints for managing the lifecycle of a tenant's agent, including starting, stopping, restarting, and retrieving its state and public card.

```APIDOC
## GET /v1/tenants/{tenantId}/agent

### Description
Retrieves the current state of the tenant agent.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}/agent

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

```APIDOC
## POST /v1/tenants/{tenantId}/agent/start

### Description
Starts or wakes the tenant agent.

### Method
POST

### Endpoint
/v1/tenants/{tenantId}/agent/start

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

```APIDOC
## POST /v1/tenants/{tenantId}/agent/stop

### Description
Stops the tenant agent.

### Method
POST

### Endpoint
/v1/tenants/{tenantId}/agent/stop

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

```APIDOC
## POST /v1/tenants/{tenantId}/agent/restart

### Description
Restarts the tenant agent.

### Method
POST

### Endpoint
/v1/tenants/{tenantId}/agent/restart

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

```APIDOC
## GET /v1/tenants/{tenantId}/agent-card

### Description
Returns the public A2A agent card for the tenant.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}/agent-card

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

--------------------------------

### Agent Releases

Source: https://bewize.ai/docs/hermes-hub/external-api

Endpoints for managing agent releases, including listing, installing, retrieving, deleting, and promoting releases.

```APIDOC
## GET /v1/hermes-agent/releases

### Description
List installed agent releases.

### Method
GET

### Endpoint
/v1/hermes-agent/releases

## POST /v1/hermes-agent/releases

### Description
Register or install a release.

### Method
POST

### Endpoint
/v1/hermes-agent/releases

## GET /v1/hermes-agent/releases/{releaseId}

### Description
Get one release.

### Method
GET

### Endpoint
/v1/hermes-agent/releases/{releaseId}

#### Path Parameters
- **releaseId** (string) - Required - The ID of the release to retrieve.

## DELETE /v1/hermes-agent/releases/{releaseId}

### Description
Delete an inactive unused release.

### Method
DELETE

### Endpoint
/v1/hermes-agent/releases/{releaseId}

#### Path Parameters
- **releaseId** (string) - Required - The ID of the release to delete.

## POST /v1/hermes-agent/releases/{releaseId}:activate

### Description
Promote a release.

### Method
POST

### Endpoint
/v1/hermes-agent/releases/{releaseId}:activate

#### Path Parameters
- **releaseId** (string) - Required - The ID of the release to promote.
```

--------------------------------

### Runs and Events Endpoints

Source: https://bewize.ai/docs/hermes-hub/external-api

Endpoints for managing agent runs, including starting, stopping, retrieving status, streaming events, and handling approvals.

```APIDOC
## POST /v1/tenants/{tenantId}/runs

### Description
Starts a new Hermes Agent run.

### Method
POST

### Endpoint
/v1/tenants/{tenantId}/runs

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

```APIDOC
## GET /v1/tenants/{tenantId}/runs/{runId}

### Description
Retrieves the status and metadata of a specific run.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}/runs/{runId}

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
- **runId** (string) - Required - The unique identifier of the run.
```

```APIDOC
## GET /v1/tenants/{tenantId}/runs/{runId}/events

### Description
Streams events for a specific run. This is a long-lived response.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}/runs/{runId}/events

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
- **runId** (string) - Required - The unique identifier of the run.
```

```APIDOC
## POST /v1/tenants/{tenantId}/runs/{runId}/stop

### Description
Stops a currently running run.

### Method
POST

### Endpoint
/v1/tenants/{tenantId}/runs/{runId}/stop

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
- **runId** (string) - Required - The unique identifier of the run.
```

```APIDOC
## POST /v1/tenants/{tenantId}/runs/{runId}/approval

### Description
Resolves a pending approval for a run.

### Method
POST

### Endpoint
/v1/tenants/{tenantId}/runs/{runId}/approval

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
- **runId** (string) - Required - The unique identifier of the run.
```

--------------------------------

### Get Tenant API Credentials

Source: https://bewize.ai/docs/hermes-hub/external-api

Retrieves the API credentials scoped to a specific tenant. These are used for authenticating with the Hub API.

```http
GET /v1/tenants/{tenantId}/api-credentials
```

--------------------------------

### Get Single Peer

Source: https://bewize.ai/docs/hermes-hub/external-api

Retrieves details for a specific A2A peer introduced to a tenant. Use this to inspect a particular connected participant.

```http
GET /v1/tenants/{tenantId}/a2a-peers/{peerId}
```

--------------------------------

### Make Share Directory

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Creates a directory within a share. Requires write access.

```json
{
  "tenant_id": "tenant_123",
  "group_id": "division1",
  "path": "notes"
}
```

--------------------------------

### List Tenant Skill Files

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Lists files belonging to a specific skill within a tenant. Useful for inspecting the contents of a skill.

```json
{
  "tenant_id": "tenant_123",
  "category": "content",
  "skill": "writer"
}
```

--------------------------------

### Introduce Peer

Source: https://bewize.ai/docs/hermes-hub/external-api

Introduces a new peer to a tenant's A2A network. This endpoint is used to establish connections with other A2A participants.

```http
POST /v1/tenants/{tenantId}/a2a-peers
```

--------------------------------

### Context Sync Tool

Source: https://bewize.ai/llms-full.txt

Tool for synchronizing tenant context to a destination reachable by the MCP server.

```APIDOC
## Context Sync Tool

### `sync_context`

#### Description
Copies tenant context to a destination reachable by the MCP server.

#### Input
`tenant_id`, `destination`, `dry_run`, `delete`
```

--------------------------------

### Settings Tools

Source: https://bewize.ai/llms-full.txt

Tools for managing various settings and configurations, including tenant impact configuration, agent policies, and agent specializations.

```APIDOC
## Settings Tools

### `get_tenant_impact_config`

#### Description
Retrieves the tenant impact configuration.

### `patch_tenant_impact_config`

#### Description
Updates (patches) the tenant impact configuration.

### `get_agent_policy`

#### Description
Retrieves the agent policy.

### `put_agent_policy`

#### Description
Replaces the agent policy.

### `get_agent_specialization`

#### Description
Retrieves the agent specialization.

### `put_agent_specialization`

#### Description
Replaces the agent specialization.
```

--------------------------------

### get_tenant_skill_file

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Reads one tenant skill file.

```APIDOC
## get_tenant_skill_file

### Description
Reads one tenant skill file.

### Method
POST

### Endpoint
/get_tenant_skill_file

### Parameters
#### Request Body
- **tenant_id** (string) - Required - The ID of the tenant.
- **path** (string) - Required - The path to the tenant skill file.

### Request Example
{
  "tenant_id": "tenant_123",
  "path": "content/writer/SKILL.md"
}
```

--------------------------------

### list_tenant_skill_files

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Lists files belonging to one skill.

```APIDOC
## list_tenant_skill_files

### Description
Lists files belonging to one skill.

### Method
POST

### Endpoint
/list_tenant_skill_files

### Parameters
#### Request Body
- **tenant_id** (string) - Required - The ID of the tenant.
- **category** (string) - Required - The category of the skill.
- **skill** (string) - Required - The name of the skill.

### Request Example
{
  "tenant_id": "tenant_123",
  "category": "content",
  "skill": "writer"
}
```

--------------------------------

### Get Tenant A2A Credentials

Source: https://bewize.ai/docs/hermes-hub/external-api

Retrieves the A2A credentials for a specific tenant. These are used for authenticating A2A communications.

```http
GET /v1/tenants/{tenantId}/a2a-credentials
```

--------------------------------

### create_tenant

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Creates a new tenant. The input body must conform to the REST CreateTenantRequest shape.

```APIDOC
## create_tenant

### Description
Creates a tenant. The input body follows the REST `CreateTenantRequest` shape.

### Method
POST

### Endpoint
/mcp

### Parameters
#### Request Body
- **method** (string) - Required - The name of the method to call, which is "create_tenant".
- **params** (object) - Required - An object containing the tenant creation details.
  - **id** (string) - Required - The ID for the new tenant.
  - **displayName** (string) - Required - The display name for the new tenant.
  - **agent** (object) - Optional - Agent configuration.
  - **storage** (object) - Optional - Storage configuration.
  - **browser** (object) - Optional - Browser configuration.
  - **flavor** (string) - Optional - The tenant flavor.

### Request Example
```json
{
  "method": "create_tenant",
  "params": {
    "id": "new_tenant_456",
    "displayName": "New Tenant",
    "agent": {},
    "storage": {},
    "browser": {},
    "flavor": "premium"
  }
}
```

### Response
#### Success Response (200)
- **result** (object) - Indicates successful creation.
  - **ok** (boolean) - True if the tenant was created successfully.

#### Response Example
```json
{
  "result": {
    "ok": true
  }
}
```
```

--------------------------------

### Get Managed Secret Metadata

Source: https://bewize.ai/docs/hermes-hub/external-api

Retrieves metadata for a specific managed secret. This endpoint provides information about the secret, not its value.

```http
GET /v1/secrets/{secretId}
```

--------------------------------

### Input for get_tenant Tool

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

To retrieve a specific tenant's details, provide the tenant_id in the input JSON.

```json
{"tenant_id": "tenant_123"}
```

--------------------------------

### Sync Context Tool Input

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

This JSON object represents the input for the `sync_context` tool, specifying the tenant ID, destination path, and operational flags like dry run and delete.

```json
{
  "tenant_id": "tenant_123",
  "destination": "/sync/tenant_123",
  "dry_run": true,
  "delete": false
}
```

--------------------------------

### resume_tenant_cron

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Resumes a specific cron job for a tenant. Requires tenant ID and job ID.

```APIDOC
## resume_tenant_cron

### Description
Resumes one cron job.

### Input
```json
{
  "tenant_id": "tenant_123",
  "job_id": "job_123"
}
```
```

--------------------------------

### Share Filesystem Tools

Source: https://bewize.ai/llms-full.txt

Tools for interacting with a shared filesystem, including listing shares and files, reading, writing, and managing files and directories.

```APIDOC
## Share Filesystem Tools

### `list_shares`

#### Description
Lists all available shares for a tenant.

#### Input
`{"tenant_id":"tenant_123"}`

### `list_share_files`

#### Description
Lists files within a specific path in a share.

#### Input
`tenant_id`, `group_id`, `path`

### `read_share_file`

#### Description
Reads content from a file in a share, with optional offset and limit.

#### Input
`tenant_id`, `group_id`, `path`, optional `offset`, optional `limit`

### `stat_share_path`

#### Description
Retrieves status information for a path within a share.

#### Input
`tenant_id`, `group_id`, `path`

### `grep_share`

#### Description
Searches for a pattern within files in a share, with optional max results and case sensitivity flag.

#### Input
`tenant_id`, `group_id`, `path`, `pattern`, optional `max`, optional `ignore_case`

### `find_share_files`

#### Description
Finds files within a share based on optional name and max results.

#### Input
`tenant_id`, `group_id`, `path`, optional `name`, optional `max`

### `write_share_file`

#### Description
Writes content to a file in a share, with optional mode (overwrite or append). Requires write access.

#### Input
`tenant_id`, `group_id`, `path`, `content`, optional `mode` (`overwrite` or `append`)

### `make_share_dir`

#### Description
Creates a new directory in a share. Requires write access.

#### Input
`tenant_id`, `group_id`, `path`

### `move_share_path`

#### Description
Moves a file or directory within a share. Requires write access.

#### Input
`tenant_id`, `group_id`, `from`, `to`

### `remove_share_path`

#### Description
Removes a file or directory from a share, with optional recursive flag. Requires write access.

#### Input
`tenant_id`, `group_id`, `path`, optional `recursive`
```

--------------------------------

### Get Single Share Group

Source: https://bewize.ai/docs/hermes-hub/external-api

Retrieves details for a specific share group identified by its ID. Use this to view the configuration and members of a share group.

```http
GET /v1/share-groups/{groupId}
```

--------------------------------

### create_tenant_cron

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Creates a new agent cron job for a tenant. Requires tenant ID and job details including name, schedule, and prompt.

```APIDOC
## create_tenant_cron

### Description
Creates an agent cron job. The `job` object follows the active Hermes Agent
cron schema.

### Input
```json
{
  "tenant_id": "tenant_123",
  "job": {
    "name": "Daily summary",
    "schedule": "0 9 * * *",
    "prompt": "Summarize yesterday's updates"
  }
}
```
```

--------------------------------

### Skill Tools

Source: https://bewize.ai/llms-full.txt

Tools for managing skills within a tenant, including listing tenants' skills, skill files, and specific skill files.

```APIDOC
## Skill Tools

### `list_tenant_skills`

#### Description
Lists all skills for a given tenant.

#### Input
`{"tenant_id":"tenant_123"}`

### `list_tenant_skill_files`

#### Description
Lists files for a specific skill within a tenant.

#### Input
`{"tenant_id":"tenant_123","category":"content","skill":"writer"}`

### `get_tenant_skill_file`

#### Description
Retrieves the content of a specific skill file for a tenant.

#### Input
`{"tenant_id":"tenant_123","path":"content/writer/SKILL.md"}`
```

--------------------------------

### Patch Tenant Impact Configuration

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Patches the tenant-impacting configuration. The patch shape is defined by the Hub configuration schema. Example shows enabling a feature.

```json
{"patch": {"feature": {"enabled": true}}}
```

--------------------------------

### Get Specific Tenant Cron Job

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Retrieves a single agent cron job by its ID for a given tenant. Requires both tenant ID and job ID.

```json
{
  "tenant_id": "tenant_123",
  "job_id": "job_123"
}
```

--------------------------------

### Set Agent Specialization

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Sets the text for hosted-agent specialization. The input includes the content string.

```json
{"content": "Default hosted-agent instructions."}
```

--------------------------------

### make_share_dir

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Creates a directory. Requires write access.

```APIDOC
## make_share_dir

### Description
Creates a directory. Requires write access.

### Method
POST

### Endpoint
/make_share_dir

### Parameters
#### Request Body
- **tenant_id** (string) - Required - The ID of the tenant.
- **group_id** (string) - Required - The ID of the group (share).
- **path** (string) - Required - The path of the directory to create within the share.

### Request Example
{
  "tenant_id": "tenant_123",
  "group_id": "division1",
  "path": "notes"
}
```

--------------------------------

### List Introduced Peers

Source: https://bewize.ai/docs/hermes-hub/external-api

Lists all peers that have been introduced to a tenant's A2A network. Use this to see connected A2A participants.

```http
GET /v1/tenants/{tenantId}/a2a-peers
```

--------------------------------

### Tenant Tools

Source: https://bewize.ai/llms-full.txt

Tools for managing tenant resources, including listing, retrieving, creating, updating, and deleting tenants, as well as setting tenant access.

```APIDOC
## Tenant Tools

### `list_tenants`

#### Description
Lists all available tenants.

#### Input
`{}`

### `get_tenant`

#### Description
Retrieves information about a specific tenant.

#### Input
`{"tenant_id":"tenant_123"}`

### `create_tenant`

#### Description
Creates a new tenant. The input follows the REST create tenant request structure.

#### Input
Follows REST create tenant request structure.

### `update_tenant`

#### Description
Updates an existing tenant. Requires `tenant_id` and the fields to be updated.

#### Input
Includes `tenant_id` plus update fields.

### `delete_tenant`

#### Description
Deletes a specific tenant.

#### Input
`{"tenant_id":"tenant_123"}`

### `set_tenant_access`

#### Description
Sets the access status for a tenant, with optional message and reason.

#### Input
Includes `tenant_id`, access status, optional message, and optional reason.
```

--------------------------------

### Get Single Agent Cron Job

Source: https://bewize.ai/docs/hermes-hub/external-api

Retrieves details for a specific agent cron job identified by its ID within a tenant. Use this to inspect a particular scheduled task.

```http
GET /v1/tenants/{tenantId}/agent-cron/{jobId}
```

--------------------------------

### List Share Files

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Lists files within a specified share and path. Requires read access to the share.

```json
{
  "tenant_id": "tenant_123",
  "group_id": "division1",
  "path": ""
}
```

--------------------------------

### Tenant Environment Key Management

Source: https://bewize.ai/llms-full.txt

Endpoints for managing environment keys for a tenant.

```APIDOC
## Tenant Environment Key Management

### Description
Manages environment keys for tenant configurations.

### Endpoints
- `GET /v1/tenants/{tenantId}/env`: Retrieves environment keys for a tenant.
- `PUT /v1/tenants/{tenantId}/env/{name}`: Updates or adds an environment key.
- `DELETE /v1/tenants/{tenantId}/env/{name}`: Deletes an environment key.
```

--------------------------------

### Flavors, Releases, and Evaluations

Source: https://bewize.ai/llms-full.txt

Endpoints for managing LLM flavors, releases, and evaluation suites.

```APIDOC
## Flavors, Releases, and Evaluations

### Description
Manages LLM flavors, their catalog, versions, and evaluation processes.

### Endpoints
- Release management endpoints.
- Flavor catalog and version management endpoints.
- Flavor evaluation suites and runs management endpoints.
```

--------------------------------

### Tenant Files Endpoints

Source: https://bewize.ai/docs/hermes-hub/external-api

Endpoints for accessing tenant-visible files, including listing directories, reading content, and downloading files.

```APIDOC
## GET /v1/tenants/{tenantId}/files

### Description
Lists tenant-visible file roots and directories.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}/files

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

```APIDOC
## GET /v1/tenants/{tenantId}/files/content

### Description
Reads the content of a text-previewable file.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}/files/content

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

```APIDOC
## GET /v1/tenants/{tenantId}/files/download

### Description
Downloads a tenant-visible file.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}/files/download

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

--------------------------------

### Tenant Environment Keys Endpoints

Source: https://bewize.ai/docs/hermes-hub/external-api

Endpoints for managing tenant-scoped environment keys, including listing, setting, and deleting keys.

```APIDOC
## GET /v1/tenants/{tenantId}/env

### Description
Lists tenant-scoped environment key names and metadata.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}/env

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

```APIDOC
## PUT /v1/tenants/{tenantId}/env/{name}

### Description
Sets an accepted tenant-scoped environment key.

### Method
PUT

### Endpoint
/v1/tenants/{tenantId}/env/{name}

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
- **name** (string) - Required - The name of the environment key.
```

```APIDOC
## DELETE /v1/tenants/{tenantId}/env/{name}

### Description
Removes a tenant-scoped environment key.

### Method
DELETE

### Endpoint
/v1/tenants/{tenantId}/env/{name}

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
- **name** (string) - Required - The name of the environment key.
```

--------------------------------

### Cron Tools

Source: https://bewize.ai/llms-full.txt

Tools for managing cron jobs within a tenant, including listing, retrieving, creating, updating, deleting, pausing, resuming, and running cron jobs.

```APIDOC
## Cron Tools

### `list_tenant_crons`

#### Description
Lists all cron jobs for a tenant.

### `get_tenant_cron`

#### Description
Retrieves details of a specific cron job for a tenant.

### `create_tenant_cron`

#### Description
Creates a new cron job for a tenant. Input follows the active Hermes Agent cron schema.

### `update_tenant_cron`

#### Description
Updates an existing cron job for a tenant. Input follows the active Hermes Agent cron schema.

### `delete_tenant_cron`

#### Description
Deletes a specific cron job for a tenant.

### `pause_tenant_cron`

#### Description
Pauses a specific cron job for a tenant.

### `resume_tenant_cron`

#### Description
Resumes a paused cron job for a tenant.

### `run_tenant_cron`

#### Description
Manually runs a specific cron job for a tenant.

**Note:** Cron tools use `tenant_id`; job-specific tools also use `job_id`. Create and update bodies follow the active Hermes Agent cron schema.
```

--------------------------------

### Policy and Configuration Management

Source: https://bewize.ai/llms-full.txt

Endpoints for managing agent policies, features, and tenant configurations.

```APIDOC
## Policy and Configuration Management

### Description
Manages agent policies, known features, specializations, and tenant-specific configurations.

### Endpoints
- Agent policy management endpoints.
- Known features and specialization endpoints.
- Tenant policy override endpoints.
- Tenant-impacting configuration endpoints.
```

--------------------------------

### Metrics and Business Keys

Source: https://bewize.ai/llms-full.txt

Endpoints for retrieving metrics and managing business keys.

```APIDOC
## Metrics and Business Keys

### Description
Provides access to operational metrics and manages business key lifecycles.

### Endpoints
- Run metrics retrieval endpoints.
- Schedule metrics retrieval endpoints.
- Aggregate usage data endpoints.
- Business key lifecycle management endpoints.
```

--------------------------------

### Grep Share

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Searches a share using a Go regular expression. Requires read access.

```json
{
  "tenant_id": "tenant_123",
  "group_id": "division1",
  "path": "notes",
  "pattern": "invoice|receipt",
  "max": 50,
  "ignore_case": true
}
```

--------------------------------

### get_tenant

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Retrieves details for a specific tenant using its tenant ID.

```APIDOC
## get_tenant

### Description
Gets one tenant by its ID.

### Method
POST

### Endpoint
/mcp

### Parameters
#### Request Body
- **method** (string) - Required - The name of the method to call, which is "get_tenant".
- **params** (object) - Required - An object containing the tenant ID.
  - **tenant_id** (string) - Required - The ID of the tenant to retrieve.

### Request Example
```json
{
  "method": "get_tenant",
  "params": {"tenant_id": "tenant_123"}
}
```

### Response
#### Success Response (200)
- **result** (object) - Contains the tenant details.
  - **tenant** (object) - The tenant object.
    - **id** (string) - The tenant ID.
    - **displayName** (string) - The display name of the tenant.
    - **agent** (object) - Agent configuration.
    - **storage** (object) - Storage configuration.
    - **browser** (object) - Browser configuration.
    - **flavor** (string) - The tenant flavor.

#### Response Example
```json
{
  "result": {
    "tenant": {
      "id": "tenant_123",
      "displayName": "Example Tenant",
      "agent": {},
      "storage": {},
      "browser": {},
      "flavor": "default"
    }
  }
}
```
```

--------------------------------

### list_share_files

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Lists files in a share.

```APIDOC
## list_share_files

### Description
Lists files in a share.

### Method
POST

### Endpoint
/list_share_files

### Parameters
#### Request Body
- **tenant_id** (string) - Required - The ID of the tenant.
- **group_id** (string) - Required - The ID of the group (share).
- **path** (string) - Required - The path within the share.

### Request Example
{
  "tenant_id": "tenant_123",
  "group_id": "division1",
  "path": ""
}
```

--------------------------------

### List Tenant Visible Shares

Source: https://bewize.ai/docs/hermes-hub/external-api

Lists all shares that are visible to a specific tenant. This endpoint helps in discovering accessible shared resources.

```http
GET /v1/tenants/{tenantId}/shares
```

--------------------------------

### run_tenant_cron

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Triggers a specific cron job immediately for a tenant. Requires tenant ID and job ID.

```APIDOC
## run_tenant_cron

### Description
Triggers one cron job immediately.

### Input
```json
{
  "tenant_id": "tenant_123",
  "job_id": "job_123"
}
```
```

--------------------------------

### Policy and Configuration

Source: https://bewize.ai/docs/hermes-hub/external-api

Endpoints for managing agent policies and configurations at hub-wide and tenant-specific levels.

```APIDOC
## GET /v1/agent-policy

### Description
Return hub-wide agent policy.

### Method
GET

### Endpoint
/v1/agent-policy

## PUT /v1/agent-policy

### Description
Replace hub-wide agent policy.

### Method
PUT

### Endpoint
/v1/agent-policy

## GET /v1/agent-features

### Description
List known agent features.

### Method
GET

### Endpoint
/v1/agent-features

## GET /v1/agent-specialization

### Description
Get default hosted-agent specialization.

### Method
GET

### Endpoint
/v1/agent-specialization

## PUT /v1/agent-specialization

### Description
Replace default specialization.

### Method
PUT

### Endpoint
/v1/agent-specialization

## DELETE /v1/agent-specialization

### Description
Disable default specialization.

### Method
DELETE

### Endpoint
/v1/agent-specialization

## GET /v1/tenants/{tenantId}/agent-policy

### Description
Get tenant effective policy and override.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}/agent-policy

#### Path Parameters
- **tenantId** (string) - Required - The ID of the tenant.

## PUT /v1/tenants/{tenantId}/agent-policy

### Description
Replace tenant policy override.

### Method
PUT

### Endpoint
/v1/tenants/{tenantId}/agent-policy

#### Path Parameters
- **tenantId** (string) - Required - The ID of the tenant.

## DELETE /v1/tenants/{tenantId}/agent-policy

### Description
Delete tenant policy override.

### Method
DELETE

### Endpoint
/v1/tenants/{tenantId}/agent-policy

#### Path Parameters
- **tenantId** (string) - Required - The ID of the tenant.

## GET /v1/config/tenant-impact

### Description
Return tenant-impacting config view.

### Method
GET

### Endpoint
/v1/config/tenant-impact

## PATCH /v1/config/tenant-impact

### Description
Stage tenant-impacting config changes.

### Method
PATCH

### Endpoint
/v1/config/tenant-impact

## POST /v1/config/tenant-impact:apply

### Description
Apply staged config changes.

### Method
POST

### Endpoint
/v1/config/tenant-impact:apply
```

--------------------------------

### grep_share

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Searches a share with a Go regular expression.

```APIDOC
## grep_share

### Description
Searches a share with a Go regular expression.

### Method
POST

### Endpoint
/grep_share

### Parameters
#### Request Body
- **tenant_id** (string) - Required - The ID of the tenant.
- **group_id** (string) - Required - The ID of the group (share).
- **path** (string) - Required - The path within the share to search.
- **pattern** (string) - Required - The Go regular expression pattern to search for.
- **max** (integer) - Optional - The maximum number of matches to return.
- **ignore_case** (boolean) - Optional - Whether to ignore case during the search.

### Request Example
{
  "tenant_id": "tenant_123",
  "group_id": "division1",
  "path": "notes",
  "pattern": "invoice|receipt",
  "max": 50,
  "ignore_case": true
}
```

--------------------------------

### File Management Endpoints

Source: https://bewize.ai/llms-full.txt

Endpoints for managing files within a tenant's storage.

```APIDOC
## File Management Endpoints

### Description
Manages files associated with a tenant.

### Endpoints
- `GET /v1/tenants/{tenantId}/files`: Lists files for a tenant.
- `GET /v1/tenants/{tenantId}/files/content`: Retrieves the content of files.
- `GET /v1/tenants/{tenantId}/files/download`: Downloads files.
```

--------------------------------

### Credentials and Secrets API

Source: https://bewize.ai/docs/hermes-hub/external-api

Manage tenant credentials and secrets.

```APIDOC
## GET /v1/tenants/{tenantId}/a2a-credentials

### Description
Return tenant A2A credentials.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}/a2a-credentials

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The ID of the tenant.
```

```APIDOC
## GET /v1/tenants/{tenantId}/api-credentials

### Description
Return tenant-scoped API credentials.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}/api-credentials

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The ID of the tenant.
```

```APIDOC
## POST /v1/tenants/{tenantId}/api-credentials/rotate

### Description
Rotate tenant-scoped API credentials.

### Method
POST

### Endpoint
/v1/tenants/{tenantId}/api-credentials/rotate

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The ID of the tenant.
```

```APIDOC
## GET /v1/secrets

### Description
List managed secret metadata.

### Method
GET

### Endpoint
/v1/secrets
```

```APIDOC
## POST /v1/secrets

### Description
Register a managed secret without returning material.

### Method
POST

### Endpoint
/v1/secrets
```

```APIDOC
## GET /v1/secrets/{secretId}

### Description
Return managed secret metadata.

### Method
GET

### Endpoint
/v1/secrets/{secretId}

### Parameters
#### Path Parameters
- **secretId** (string) - Required - The ID of the secret.
```

```APIDOC
## DELETE /v1/secrets/{secretId}

### Description
Delete managed secret metadata and material.

### Method
DELETE

### Endpoint
/v1/secrets/{secretId}

### Parameters
#### Path Parameters
- **secretId** (string) - Required - The ID of the secret.
```

```APIDOC
## POST /v1/secrets/{secretId}:replace-material

### Description
Replace write-only secret material.

### Method
POST

### Endpoint
/v1/secrets/{secretId}:replace-material

### Parameters
#### Path Parameters
- **secretId** (string) - Required - The ID of the secret.
```

```APIDOC
## POST /v1/secrets/{secretId}:refresh

### Description
Refresh one OAuth2 secret.

### Method
POST

### Endpoint
/v1/secrets/{secretId}:refresh

### Parameters
#### Path Parameters
- **secretId** (string) - Required - The ID of the secret.
```

```APIDOC
## POST /v1/secrets/{secretId}:rotate

### Description
Rotate one managed API-key secret.

### Method
POST

### Endpoint
/v1/secrets/{secretId}:rotate

### Parameters
#### Path Parameters
- **secretId** (string) - Required - The ID of the secret.
```

```APIDOC
## POST /v1/secrets:refresh-due

### Description
Refresh all due OAuth2 secrets.

### Method
POST

### Endpoint
/v1/secrets:refresh-due
```

--------------------------------

### Webhooks

Source: https://bewize.ai/docs/hermes-hub/external-api

Endpoints for handling webhook events from Meta WhatsApp and Telegram.

```APIDOC
## GET /webhooks/whatsapp

### Description
Meta WhatsApp webhook verification.

### Method
GET

### Endpoint
/webhooks/whatsapp

## POST /webhooks/whatsapp

### Description
Meta WhatsApp message events.

### Method
POST

### Endpoint
/webhooks/whatsapp

## POST /webhooks/telegram

### Description
Telegram Bot API message events.

### Method
POST

### Endpoint
/webhooks/telegram

### Request Body
Webhook bodies are provider-defined.
```

--------------------------------

### Tenant Management Endpoints

Source: https://bewize.ai/docs/hermes-hub/external-api

Endpoints for managing tenants, including listing, creating, retrieving, updating, and deleting tenants, as well as managing their access state.

```APIDOC
## GET /v1/tenants

### Description
Lists all tenants.

### Method
GET

### Endpoint
/v1/tenants
```

```APIDOC
## POST /v1/tenants

### Description
Creates and provisions a new tenant.

### Method
POST

### Endpoint
/v1/tenants
```

```APIDOC
## GET /v1/tenants/{tenantId}

### Description
Retrieves a specific tenant by its ID.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

```APIDOC
## PATCH /v1/tenants/{tenantId}

### Description
Updates tenant metadata and desired settings.

### Method
PATCH

### Endpoint
/v1/tenants/{tenantId}

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

```APIDOC
## DELETE /v1/tenants/{tenantId}

### Description
Deletes a specific tenant by its ID.

### Method
DELETE

### Endpoint
/v1/tenants/{tenantId}

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

```APIDOC
## GET /v1/tenants/{tenantId}/access

### Description
Reads the access state of a specific tenant.

### Method
GET

### Endpoint
/v1/tenants/{tenantId}/access

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

```APIDOC
## PUT /v1/tenants/{tenantId}/access

### Description
Sets the access state of a specific tenant.

### Method
PUT

### Endpoint
/v1/tenants/{tenantId}/access

### Parameters
#### Path Parameters
- **tenantId** (string) - Required - The unique identifier of the tenant.
```

--------------------------------

### put_agent_specialization

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Sets hosted-agent specialization text. Requires content string.

```APIDOC
## put_agent_specialization

### Description
Sets hosted-agent specialization text.

### Input
```json
{"content": "Default hosted-agent instructions."}
```
```

--------------------------------

### list_tenant_crons

Source: https://bewize.ai/docs/hermes-hub/mcp-contract

Lists tenant agent cron jobs. Requires a tenant ID.

```APIDOC
## list_tenant_crons

### Description
Lists tenant agent cron jobs.

### Input
```json
{
  "tenant_id": "tenant_123"
}
```
```