Fixes #540 - Document Search Endpoint

docs/docs/api.md

@@ -10,6 +10,7 @@ All examples in this section assume that you've found a running leader at `chron
 
 - [Leaders](#leaders)
 - [Listing Jobs](#listing-jobs)
+- [Searching for a Job](#searching-for-a-job)
 - [Deleting a Job](#deleting-a-job)
 - [Deleting All Tasks for a Job](#deleting-all-tasks-for-a-job)
 - [Manually Starting a Job](#manually-starting-a-job)
@@ -49,6 +50,16 @@ Interesting fields in the hashes are:
 
 If there is a `parents` field there will be no `schedule` field, and vice-versa.
 
+## Searching for a Job
+
+Searching for a job with known attributes can be helpful when a large amount of jobs are being deployed. The list of possible attributes is described in the [Job Configuration](#job-configuration) section.
+
+* Endpoint: __/scheduler/jobs/search__
+* Method: __GET__
+* Example: `curl -L -X GET chronos-node:8080/scheduler/jobs/search?name=request_event_counter_hourly`
+* Example: `curl -L -X GET chronos-node:8080/scheduler/jobs/search?owner=foo@bar.io`
+* Response: HTTP 204
+
 ## Deleting a Job
 
 Get a job name from the job listing above.