# health.hats.answerAsk

> The asked clinician answers: done, after correcting or verifying the record in their own repo, or declined with a reason. Either ends the access the ask opened. Authenticated as the clinician (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.answerAsk)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:uvvhtareovj2oaregs7vsibv/health.hats.answerAsk/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:uvvhtareovj2oaregs7vsibv/health.hats.answerAsk/analytics)

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

Type: procedure · POST

### Input (application/json)

- `answer` (string): Required to decline: the reason, which stays with the record beside the patient's statement.
- `id` (string, required): The ask's id, from listAsks.
- `outcome` (string, required)
  - Constraints: knownValues: done | declined
- `patient` (string · did, required): The patient who asked.

### Output (application/json)

- `status` (string, required)

### Errors

- `AskNotOpen`: No open ask under that id is addressed to the caller.

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "The asked clinician answers: done, after correcting or verifying the record in their own repo, or declined with a reason. Either ends the access the ask opened. Authenticated as the clinician (service auth).",
      "errors": [
        {
          "description": "No open ask under that id is addressed to the caller.",
          "name": "AskNotOpen"
        }
      ],
      "input": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "answer": {
              "description": "Required to decline: the reason, which stays with the record beside the patient's statement.",
              "type": "string"
            },
            "id": {
              "description": "The ask's id, from listAsks.",
              "type": "string"
            },
            "outcome": {
              "knownValues": [
                "done",
                "declined"
              ],
              "type": "string"
            },
            "patient": {
              "description": "The patient who asked.",
              "format": "did",
              "type": "string"
            }
          },
          "required": [
            "patient",
            "id",
            "outcome"
          ],
          "type": "object"
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "status": {
              "type": "string"
            }
          },
          "required": [
            "status"
          ],
          "type": "object"
        }
      },
      "type": "procedure"
    }
  },
  "id": "health.hats.answerAsk",
  "lexicon": 1
}
```