---
title: "GroundInput"
description: "a subject to ground at a breadth: exactly one of a capture, an entity, a text or an address; the same grounding serves the capture panel, the entity page of the web and desktop shells, the agent and the API"
section: concepts
address: /concepts/groundinput
contract: 0476e35e6e275db5
---

# GroundInput

a subject to ground at a breadth: exactly one of a capture, an entity, a text or an address; the same grounding serves the capture panel, the entity page of the web and desktop shells, the agent and the API

[figure: GroundInput is a value at none scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | value |
| scope | none |
| key | none |
| store | none |
| family | harness |



## Fields


| field | type | required | note |
|---|---|---|---|
| `capture` | `hash` | no | the artefact's hash |
| `entity` | `id` | no | an entity of the record |
| `text` | `text` | no | a text a person or the agent pasted, cut to 4,000 characters |
| `address` | `text` | no | an address of a page the record may hold as a capture |
| `breadth` | `one of exact \| similar \| related \| broad` | no | the person's default when absent |



## Routes that use it
- [`/v1/act/ground`](/reference/act/ground) takes it as input