> ## Documentation Index
> Fetch the complete documentation index at: https://api.docs.dealmachine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Manage Driving assignments, targets, tags, and notes through the Driving API

The Driving API exposes the core Driving workspace through public API endpoints. Use it to assign driving work, save target properties, manage property tags, list tagged properties, and capture notes from the field.

<Warning>
  **Driving API must be enabled.** All endpoints under `/v1/driving` require the Driving app to be enabled for your organization. If not enabled, endpoints return a `403` with error code `driving_not_enabled`.
</Warning>

## Base URL

```text theme={null}
https://api.v2.dealmachine.com/v1/driving
```

## Authentication

Driving endpoints use the same Bearer token as the rest of the API:

```bash theme={null}
curl https://api.v2.dealmachine.com/v1/driving/targets \
  -H "Authorization: Bearer dm_sk_live_xxx"
```

Driving writes require an API key that was created by a DealMachine user. That user is recorded as the creator for targets, tags, notes, and assignments.

## Resources

| Resource                                                  | Description                                                                       |
| --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| [Assignments](/driving/assignments/list-assignments)      | View assignment queues, create assignments, reassign work, and cancel assignments |
| [Targets](/driving/targets/list-targets)                  | Save properties as Driving targets and list target history                        |
| [Tags](/driving/tags/list-tags)                           | Manage Driving tag definitions and apply tags to properties                       |
| [Tagged properties](/driving/tags/list-tagged-properties) | Find properties by Driving tags and tagging activity                              |
| [Notes](/driving/notes/list-property-notes)               | Capture property notes and general Driving notes                                  |

## Resource Hierarchy

```text theme={null}
/v1/driving/assignments
/v1/driving/targets
/v1/driving/tags
/v1/driving/tagged-properties
/v1/driving/properties/{propertyId}/tags
/v1/driving/notes
/v1/driving/general-notes
```

## Common Error Codes

| Code                           | Status | Description                                                       |
| ------------------------------ | ------ | ----------------------------------------------------------------- |
| `driving_not_enabled`          | 403    | Driving is not enabled for the organization                       |
| `driving_assignment_not_found` | 404    | Assignment does not exist or is not available to the organization |
| `driving_target_not_found`     | 404    | Target does not exist or is not available to the organization     |
| `driving_tag_not_found`        | 404    | Tag does not exist or is not available to the organization        |
| `driving_note_not_found`       | 404    | Note does not exist or is not available to the organization       |