# Rkvst

DataTrails provides an evidence management platform that delivers a reliable chain of custody for supply chain data, ensuring data authenticity and transparency.

- **Category:** security & identity tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 26
- **Triggers:** 0
- **Slug:** `RKVST`
- **Version:** 20260227_00

## Tools

### Download Event Attachment

**Slug:** `RKVST_DOWNLOAD_EVENT_ATTACHMENT`

Tool to download an attachment from a specified Event on an Asset. Use when you have asset_uuid, event_uuid, and attachment uuid, and want the raw binary content.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the attachment (omit the 'blobs/' prefix). |
| `asset_uuid` | string | Yes | UUID of the asset containing the event. |
| `event_uuid` | string | Yes | UUID of the event to which the attachment belongs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get App Registration

**Slug:** `RKVST_GET_APP_REGISTRATION`

Tool to retrieve details for a given App Registration ID. Use after obtaining the application's UUID to inspect its configuration and credentials.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_registration_id` | string | Yes | UUID of the App Registration to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Asset

**Slug:** `RKVST_GET_ASSET`

Tool to retrieve details for a given Asset. Use after you have its UUID; set `at_time` to get historical state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `at_time` | string | No | Optional ISO 8601 timestamp to retrieve the Asset's state at a past time |
| `asset_uuid` | string | Yes | UUID of the Asset to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Blob

**Slug:** `RKVST_GET_BLOB`

Tool to retrieve details of a Blob by ID. Use after confirming the Blob ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `blob_id` | string | Yes | UUID of the Blob to retrieve (accepts 'blobs/{uuid}' as well). |
| `asset_uuid` | string | No | Optional public asset UUID to use when retrieving public attachment metadata without Authorization. If provided, the tool will call the public attachments info endpoint to retrieve the blob metadata. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event

**Slug:** `RKVST_GET_EVENT`

Tool to retrieve details of a specified Event. Use when you need full metadata, attributes, and associated trails of an existing event in DataTrails.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_uuid` | string | Yes | UUID of the event to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get IAM Subject

**Slug:** `RKVST_GET_IAM_SUBJECT`

Tool to retrieve IAM subject details. Use when you need to fetch details for a specific IAM subject by its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `subject_id` | string | Yes | Unique identifier (UUID) of the IAM subject to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Member

**Slug:** `RKVST_GET_MEMBER`

Tool to retrieve details for a given Member ID. Use after obtaining a valid member UUID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `member_id` | string | Yes | UUID of the Member to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Public Asset

**Slug:** `RKVST_GET_PUBLIC_ASSET`

Tool to retrieve details for a public asset. Use when you have a public asset UUID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the public asset to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Public Asset Event

**Slug:** `RKVST_GET_PUBLIC_ASSET_EVENT`

Tool to retrieve a specific public asset event. Use when you have public asset and event UUIDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the event to retrieve |
| `asset_uuid` | string | Yes | UUID of the public asset |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tenancy

**Slug:** `RKVST_GET_TENANCY`

Tool to retrieve details for a specific tenancy. Use after you have a tenancy ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tenancy_id` | string | Yes | Unique identifier of the tenancy. Accepts either raw UUID or the full identity string in the format 'tenant/{UUID}'. Leading/trailing whitespace is ignored. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List App Registrations

**Slug:** `RKVST_LIST_APP_REGISTRATIONS`

Tool to list all App Registrations. Use after acquiring a valid auth token to retrieve the applications registered under the tenant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_token` | string | No | Pagination token from a previous call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Asset Events

**Slug:** `RKVST_LIST_ASSET_EVENTS`

Tool to list events for a specified asset. Use after confirming you have the asset UUID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order_by` | string | No | Order results for certain schemas (e.g., SIMPLEHASHV1) |
| `page_size` | integer | No | Maximum number of results per page, must be >= 1 |
| `asset_uuid` | string | Yes | UUID of the Asset to list events for |
| `minimum_trust` | string | No | Return events with confirmation status at or above this level (e.g., COMMITTED, CONFIRMED) |
| `asset_attributes` | object | No | Filter by asset attribute equality; key->value. Use '*' for presence or '!=*' for absence. |
| `event_attributes` | object | No | Filter by event attribute equality; key->value. Use '*' for presence or '!=*' for absence. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Assets

**Slug:** `RKVST_LIST_ASSETS`

Tool to list all Assets with optional pagination and filters. Use when you need to retrieve asset metadata in batches via page_size and next_page_token.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum number of assets to return. |
| `next_page_token` | string | No | Token to retrieve the next page of assets. |
| `proof_mechanism` | string | No | Filter by proof mechanism (e.g., 'MERKLE_LOG'). |
| `request_total_count` | boolean | No | If true, includes 'x-total-count' header in the response. |
| `attributes.arc_display_name` | string | No | Filter by asset display name. Use '=' for exact match, '*' for presence, '!=*' for missing. |
| `attributes.arc_display_type` | string | No | Filter by asset type (e.g., 'Traffic light'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List IAM Subjects

**Slug:** `RKVST_LIST_IAM_SUBJECTS`

Tool to list IAM subjects. Use when you need to retrieve provider-managed subjects, optionally filtering by display name. Use after authenticating the tenant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order_by` | string | No | Specify sort order for results. |
| `page_size` | integer | No | Maximum entries per page. |
| `page_token` | string | No | Token to retrieve the next page of results. |
| `display_name` | string | No | Filter subjects by friendly display name. |
| `wallet_address` | string | No | Filter subjects by wallet address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Members

**Slug:** `RKVST_LIST_MEMBERS`

Tool to list all tenant Members. Use when you need an overview of all users in your tenant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `member_state` | string ("MEMBER_STATE_ACTIVE" | "MEMBER_STATE_INACTIVE" | "MEMBER_STATE_BOTH") | No | Filter by member state. Use MEMBER_STATE_ACTIVE to include only active members, MEMBER_STATE_INACTIVE for only inactive members, or MEMBER_STATE_BOTH to include both. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Public Asset Events

**Slug:** `RKVST_LIST_PUBLIC_ASSET_EVENTS`

Tool to list events for a specific public asset. Use when you need to retrieve the event history of a public asset after confirming its public availability.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the public Asset to list events for |
| `page_token` | string | No | Pagination token from a previous call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Public Assets

**Slug:** `RKVST_LIST_PUBLIC_ASSETS`

Tool to list all Public Assets. Use when you need to retrieve all assets made public.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Optional page size to limit number of public events fetched (used as proxy for assets). |
| `page_token` | string | No | Pagination token from a previous call to public events; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tenancies

**Slug:** `RKVST_LIST_TENANCIES`

Tool to list all tenancies. Use after authenticating to retrieve the tenancy records available to the current tenant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_token` | string | No | Pagination token from a previous call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Promote Member

**Slug:** `RKVST_PROMOTE_MEMBER`

Tool to promote a tenant member to OWNER role. Use when you need to elevate permissions after verifying the member identity.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `member_id` | string | Yes | UUID of the Member to promote. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve asset attachment metadata

**Slug:** `RKVST_RETRIEVE_ASSET_ATTACHMENT_METADATA`

Tool to retrieve metadata for an attachment on a specified Asset. Use after obtaining asset and attachment UUIDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the attachment (no 'blobs/' prefix) |
| `asset_uuid` | string | Yes | UUID of the asset owning the attachment |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve Caps

**Slug:** `RKVST_RETRIEVE_CAPS`

Tool to retrieve resource limit quotas for a specified service. Use when checking quota availability before provisioning resources.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `service` | string ("access_policies" | "applications" | "assets" | "blobs" | "locations" | "members") | Yes | Resource type to return caps for. Allowed values: access_policies, applications, assets, blobs, locations, members. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve Event Attachment Metadata

**Slug:** `RKVST_RETRIEVE_EVENT_ATTACHMENT_METADATA`

Tool to retrieve metadata for an attachment on a specified Event. Use when you have asset_uuid, event_uuid, and attachment uuid and need details like size, hash, and scan status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the attachment (omit the 'blobs/' prefix). |
| `asset_uuid` | string | Yes | UUID of the asset containing the event. |
| `event_uuid` | string | Yes | UUID of the event to which the attachment belongs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Events

**Slug:** `RKVST_SEARCH_EVENTS`

Tool to search events matching filter criteria with pagination. Use when retrieving events by OData filter and paging through large result sets.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Max number of results to return (1-50). |
| `skip` | integer | No | Number of results to skip before returning the page. |
| `filter` | string | No | OData filter expression. Filterable fields: trails, event_type, origin_tenant, created_by, created_at, ledger_entry/index, ledger_entry/idtimestamp, ledger_entry/content_hash. Example: "trails/any(t: t eq 'Clouseau') and event_type eq 'CREATED'" |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update App Registration

**Slug:** `RKVST_UPDATE_APP_REGISTRATION`

Tool to update an application's display name or custom claims. Use after retrieving an App Registration to apply partial updates to its configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `display_name` | string | No | New human-readable display name for the Application. |
| `custom_claims` | object | No | Custom claims to set on the Application for use in access policies. |
| `app_registration_id` | string | Yes | UUID of the App Registration to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
