# Recovery Objective routes: drill

URL: /code/api/recovery-objective/verbs · Id: `page:code/api/recovery-objective/verbs`

> The Recovery Objective Verbs drill as api.sb routes, with inputs, result, refusals and an example.

Reference for [Recovery Objective](/business/nouns/recovery-objective), one group of [Recovery Objective routes](/code/api/recovery-objective).

### RecoveryObjective.drill
Drill restores one Capability’s records into an isolated namespace and records whether the restore met both objectives. [Verb page](/business/nouns/recovery-objective/drill?interface=api).

```text
POST /{namespace}/recovery-objectives/{objective}/drill
```

Path: `objective`. Emits [`RecoveryObjective.drilled`](/business/events/RecoveryObjective.drilled).

**Inputs**

| Input | Type | Required | Description |
| --- | --- | --- | --- |
| `objective` | [Recovery Objective](/business/nouns/recovery-objective) | Yes | The Recovery Objective to prove. |

**Returns**

| Output | Type | Required | Description |
| --- | --- | --- | --- |
| `objective` | [Recovery Objective](/business/nouns/recovery-objective) | Yes | The objective with its last drill result. |

**Refuses when**

| Check | Error | Fix | Then call |
| --- | --- | --- | --- |
| The key is valid, but its scopes do not allow this operation. | [`forbidden`](/code/api/errors/forbidden) | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |

**Example**

```bash
curl -X POST https://api.sb/leaseline.app/recovery-objectives/recovery_MSAgl5dysq/drill \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"
```

```json
{
  "api": "https://api.sb/leaseline.app",
  "objective": {
    "$id": "https://api.sb/leaseline.app/recovery-objectives/recovery_MSAgl5dysq",
    "$type": "RecoveryObjective",
    "recoveryPoint": "Example recovery point",
    "recoveryTime": "Example recovery time",
    "drillEvery": "Example drill every"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "RecoveryObjective.drill",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}
```