# health.hats.ask

> A patient asks one named clinician to correct a record they wrote, or to verify one the patient wrote. Asking is consent: the clinician may read and write that record's section, and record those reads in the audit log, under PATRQT until they answer or the ask is due, 60 days on (45 CFR 164.526(b)(2)). Authenticated as the patient (service auth).

- Kind: procedure
- Authority: hats.health
- Lexicon: 1
- Published by [hats.health](https://lexicon.garden/identity/did:plc:uvvhtareovj2oaregs7vsibv), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:uvvhtareovj2oaregs7vsibv/health.hats.ask)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:uvvhtareovj2oaregs7vsibv/health.hats.ask/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:uvvhtareovj2oaregs7vsibv/health.hats.ask/analytics)

## Procedure (`health.hats.ask`)

Type: procedure · POST

### Input (application/json)

- `clinician` (string · did, required)
- `kind` (string, required)
  - Constraints: knownValues: correct | verify
- `target` (string · at-uri, required): The record it's about, in one of the patient's own record sections.
- `task` (string · at-uri, required): The patient's FHIR Task asking, in the same section: code change for a correction, approve for a verification.

### Output (application/json)

- `dueAt` (string · datetime, required)
- `id` (string, required)

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A patient asks one named clinician to correct a record they wrote, or to verify one the patient wrote. Asking is consent: the clinician may read and write that record's section, and record those reads in the audit log, under PATRQT until they answer or the ask is due, 60 days on (45 CFR 164.526(b)(2)). Authenticated as the patient (service auth).",
      "input": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "clinician": {
              "format": "did",
              "type": "string"
            },
            "kind": {
              "knownValues": [
                "correct",
                "verify"
              ],
              "type": "string"
            },
            "target": {
              "description": "The record it's about, in one of the patient's own record sections.",
              "format": "at-uri",
              "type": "string"
            },
            "task": {
              "description": "The patient's FHIR Task asking, in the same section: code change for a correction, approve for a verification.",
              "format": "at-uri",
              "type": "string"
            }
          },
          "required": [
            "clinician",
            "kind",
            "target",
            "task"
          ],
          "type": "object"
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "dueAt": {
              "format": "datetime",
              "type": "string"
            },
            "id": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "dueAt"
          ],
          "type": "object"
        }
      },
      "type": "procedure"
    }
  },
  "id": "health.hats.ask",
  "lexicon": 1
}
```