docs: added docs for new "Run Job" API (#726)

Co-authored-by: Nabeel Saabna <48175656+nabeelsaabna@users.noreply.github.com>

Author: justo-mend

docs/README.md

@@ -31,6 +31,6 @@ The following platforms are supported by Mend Renovate Community Edition and Ent
 5. Migration ([Renovate On-Premises to Renovate Community](./migrating-to-renovate-ce.md))
 6. API Documentation
    - [Admin APIs](./api.md)
-   - [Job Logs APIs](./job-logs-apis.md)
+   - [Job APIs](./job-apis.md)
    - [Reporting APIs](./reporting-apis.md)
 7. [Advanced topics](./advanced.md)

docs/job-logs-apis.md docs/job-apis.mddocs/job-logs-apis.md renamed to docs/job-apis.md

@@ -1,14 +1,17 @@
-# Job Logs APIs
+# Job APIs
 
 Job Logs APIs provide a summary of and content for the Job Logs generated by the Renovate CLI.
 
-## Available Job Logs APIs
+The Run Job API schedules a Renovate job to run against a given repository.
+
+## Available Job APIs
 
 The list below describes the available Job Logs APIs. Follow the links on the API names for full details.
 
 - [List Jobs by Repo](#list-jobs-by-repo) ← Lists all jobs for a given repo
 - [Get Job Logs by Repo](#get-job-logs-by-repo) ← Fetch job logs for a given repo (latest, or by JobID)
 - [Get Job Logs by JobID](#get-job-logs-by-jobid) ← Fetch job logs by Job ID
+- [Run Job on a Repo](#run-job-on-a-repo) ← Run a Renovate job against a given repo
 
 ## Enable Job Logs APIs
 
@@ -35,6 +38,7 @@ See the table below for a list of Job Logs API URL formats.
 | [List Jobs by Repo](#list-jobs-by-repo)         | [GET] /api/repos/{org}/{repo}/-/jobs                   | limit (default=100, max=10,000) |
 | [Get Job Logs by Repo](#get-job-logs-by-repo)   | [GET] /api/repos/{org}/{repo}/-/jobs/<latest\|{jobId}> |                                 |
 | [Get Job Logs by JobID](#get-job-logs-by-jobid) | [GET] /api/job/logs/{jobId}                            |                                 |
+| [Run Job on a Repo](#run-job-on-a-repo)         | [POST] /api/repos/{org}/{repo}/-/jobs/run                           |                                 |
 
 ## Details of Job Logs APIs
 
@@ -142,3 +146,9 @@ Note: This returns the same as [Get Job Logs by Repo](#get-job-logs-by-repo) wit
 {"name":"renovate","hostname":"271939e11491","pid":21,"level":20,"logContext":"5a3572bf-49fe-42bb-a066-ff1146fe83d1","msg":"Verifying and cleaning cache: /tmp/renovate/cache/renovate/renovate-cache-v1","time":"2024-05-13T12:42:29.521Z","v":0}
 {"name":"renovate","hostname":"271939e11491","pid":21,"level":20,"logContext":"5a3572bf-49fe-42bb-a066-ff1146fe83d1","msg":"Deleted 0 of 29 file cached entries in 840ms","time":"2024-05-13T12:42:30.193Z","v":0}
 ```
+
+### Run Job on a Repo
+
+API: [POST] /api/repos/{org}/{repo}/-/jobs/run
+
+**Description:** Schedules a job to run Renovate on the given repository