# ServiceTrade API Documentation

This is the complete API documentation for connecting to the ServiceTrade API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **ServiceTrade connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/serviceTrade/actions/{actionSlug}/run
```

## ServiceTrade actions

- POST `create-asset` Create Asset
- POST `create-job` Create Job
- POST `create-location` Create Location
- POST `create-quote` Create Quote
- POST `create-service-request` Create Service Request
- GET `get-asset-by-id` Get Asset by ID
- GET `get-company-by-id` Get Company by ID
- GET `get-contact-by-id` Get Contact by ID
- GET `get-job-by-id` Get Job by ID
- GET `get-location-by-id` Get Location by ID
- GET `get-oauth2-userinfo` Get OAuth2 Userinfo
- GET `get-quote-by-id` Get Quote by ID
- GET `get-service-request-by-id` Get Service Request by ID
- GET `list-assets` List Assets
- GET `list-companies` List Companies
- GET `list-contacts` List Contacts
- GET `list-jobs` List Jobs
- GET `list-locations` List Locations
- GET `list-quotes` List Quotes
- GET `list-service-requests` List Service Requests
- PUT `update-asset` Update Asset
- PUT `update-job` Update Job
- PUT `update-location` Update Location
- PUT `update-quote` Update Quote
- PUT `update-service-request` Update Service Request