---
title: "run.fill-grant@1 · OpenVibe.Services"
canonical: "https://openvibe.services/docs/contracts/run.fill-grant"
updated: null
---

# run.fill-grant@1 · OpenVibe.Services

HTML: [run.fill-grant@1 · OpenVibe.Services](https://openvibe.services/docs/contracts/run.fill-grant)

# RunFillGrant `run.fill-grant@1`

Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.161.0).

- Version: 1.0.0
- Owner: run
- Visibility: public
- Status: active
- Compatibility: backward
- Schema: [`https://openvibe.network/contracts/run/fill-grant.v1.json`](/docs/contracts/run.fill-grant.json)

Single-use encrypted grant posted by the Companion. Plaintext is never sent to Run.

## Fields

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| `request_id` | string | yes |  | - `pattern ^fr_[A-Za-z0-9_-]{16,64}$` |
| `envelope` | string | yes |  | - `pattern ^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$`<br>- `minLength 12`<br>- `maxLength 16384` |

## Examples

From the contract's own test fixtures: valid ones validate, rejected ones must fail.

 Valid: example

~~~~
{
  "request_id": "fr_01JD2C3D4E5F6G7H8J9K0MNPQR",
  "envelope": "T1ZMSwAAAAAAAAA="
}
~~~~

Rejected: object-envelope

~~~~
{
  "request_id": "fr_01JD2C3D4E5F6G7H8J9K0MNPQR",
  "envelope": {
    "ciphertext": "T1ZMSwAAAAAAAAA="
  }
}
~~~~

Rejected: plaintext-json

~~~~
{
  "request_id": "fr_01JD2C3D4E5F6G7H8J9K0MNPQR",
  "envelope": "{\"password\":\"must-not-be-here\"}"
}
~~~~

Rejected: plaintext

~~~~
{
  "request_id": "fill_01",
  "envelope": "T1ZMSwAAAAAAAAA=",
  "username": "alice",
  "password": "must-not-be-here"
}
~~~~

## Validate

~~~~
const contracts = require('openvibe-contracts');
contracts.validate('run.fill-grant@1', value);   // { valid, errors: [{ path, message }] }
~~~~