> For the complete documentation index, see [llms.txt](https://docs.adaptria.locaria.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adaptria.locaria.com/internal-api/reference/job-management.md).

# 🧰 Job Management

### Job Management

Browse admin job-management records using the same access model and response shape as the main application job-management APIs. These endpoints are intended for internal/admin API users and return `403` for client-only credentials.

## 🧰 List Job Management Jobs

> List admin job-management records using the same filtering, sorting, and pagination contract as \`GET /api/core/jobs\`. This endpoint is available only to internal/admin API-key users; client users receive \`403\`.

```json
{"openapi":"3.1.0","info":{"title":"Adaptria Public API: Connector","version":"1.0.0"},"tags":[{"name":"🧰 Job Management","description":"## Job Management\n\nBrowse admin job-management records using the same access model and response shape as the main application job-management APIs. These endpoints are intended for internal/admin API users and return `403` for client-only credentials.\n"}],"servers":[{"url":"https://api.adaptria.locaria.com","description":"Production Environment"}],"security":[{"apiKeyAuth":[]}],"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Api-key","description":"## API Key Authentication\n\nStatic API key obtained from the Adaptria Portal or via `POST /api/credentials/api-keys`.\n\n**How to authenticate**:\n1. Generate an API key from the Adaptria Portal (Settings → API Keys) or ask your admin\n2. Include the key in all requests using the `Api-key` header\n\n**Key format**: `lla_live_<32-character-string>`\n\n**No token exchange needed** — the key is used directly in every request. Revoke or rotate keys from the portal."}},"schemas":{"JobManagementListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/JobManagementSummary"}},"pagination":{"type":"object","additionalProperties":{}}},"required":["data","pagination"]},"JobManagementSummary":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"jobNo":{"type":["string","null"]},"name":{"type":["string","null"]},"isArchived":{"type":"boolean"},"service":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}},"required":["id","name"]},"team":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}},"required":["id","name"]},"teams":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}},"required":["id","name"]}},"workInstructions":{"type":"string"},"checklist":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"description":{"type":"string"}},"required":["id","description"]}},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"itemName":{"type":"string"}},"required":["id","itemName"]}},"itemCount":{"type":"integer","minimum":0},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","jobNo","name","service","createdAt"]}}},"paths":{"/api/public/v1/job-management":{"get":{"summary":"🧰 List Job Management Jobs","description":"List admin job-management records using the same filtering, sorting, and pagination contract as `GET /api/core/jobs`. This endpoint is available only to internal/admin API-key users; client users receive `403`.","tags":["🧰 Job Management"],"parameters":[{"schema":{"type":"string","description":"Search by job ID, job number, name, service name, or team name"},"required":false,"description":"Search by job ID, job number, name, service name, or team name","name":"search","in":"query"},{"schema":{"type":"string","format":"uuid","description":"Filter by service UUID"},"required":false,"description":"Filter by service UUID","name":"serviceId","in":"query"},{"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"array","items":{"type":"string","format":"uuid"}}],"description":"Filter by one or more team UUIDs"},"required":false,"description":"Filter by one or more team UUIDs","name":"teamId","in":"query"},{"schema":{"anyOf":[{"type":"boolean"},{"type":"string"}],"description":"Include archived jobs in results"},"required":false,"description":"Include archived jobs in results","name":"showArchived","in":"query"},{"schema":{"type":"string","enum":["jobNo","serviceName","teamName","itemCount"]},"required":false,"name":"sortBy","in":"query"},{"schema":{"type":"string","enum":["asc","desc"]},"required":false,"name":"sortOrder","in":"query"},{"schema":{"anyOf":[{"type":"boolean"},{"type":"string"}],"description":"Enable relevancy-based search and sorting"},"required":false,"description":"Enable relevancy-based search and sorting","name":"relevancy","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":100},"required":false,"name":"perPage","in":"query"}],"responses":{"200":{"description":"Job-management jobs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobManagementListResponse"}}}},"403":{"description":"Forbidden — client users cannot access job management"}}}}}}
```

## 🔍 Get Job Management Details

> Get a single admin job-management record using the same response shape as \`GET /api/core/jobs/{jobId}\`. This endpoint is available only to internal/admin API-key users; client users receive \`403\`.

```json
{"openapi":"3.1.0","info":{"title":"Adaptria Public API: Connector","version":"1.0.0"},"tags":[{"name":"🧰 Job Management","description":"## Job Management\n\nBrowse admin job-management records using the same access model and response shape as the main application job-management APIs. These endpoints are intended for internal/admin API users and return `403` for client-only credentials.\n"}],"servers":[{"url":"https://api.adaptria.locaria.com","description":"Production Environment"}],"security":[{"apiKeyAuth":[]}],"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Api-key","description":"## API Key Authentication\n\nStatic API key obtained from the Adaptria Portal or via `POST /api/credentials/api-keys`.\n\n**How to authenticate**:\n1. Generate an API key from the Adaptria Portal (Settings → API Keys) or ask your admin\n2. Include the key in all requests using the `Api-key` header\n\n**Key format**: `lla_live_<32-character-string>`\n\n**No token exchange needed** — the key is used directly in every request. Revoke or rotate keys from the portal."}},"schemas":{"JobManagementDetailsResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"jobNo":{"type":["string","null"]},"name":{"type":["string","null"]},"isArchived":{"type":"boolean"},"service":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}},"required":["id","name"]},"team":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}},"required":["id","name"]},"teams":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}},"required":["id","name"]}},"workInstructions":{"type":"string"},"checklist":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"description":{"type":"string"}},"required":["id","description"]}},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"itemName":{"type":"string"}},"required":["id","itemName"]}},"itemCount":{"type":"integer","minimum":0},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","jobNo","name","service","createdAt"]}}},"paths":{"/api/public/v1/job-management/{jobId}":{"get":{"summary":"🔍 Get Job Management Details","description":"Get a single admin job-management record using the same response shape as `GET /api/core/jobs/{jobId}`. This endpoint is available only to internal/admin API-key users; client users receive `403`.","tags":["🧰 Job Management"],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"jobId","in":"path"}],"responses":{"200":{"description":"Job-management job details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobManagementDetailsResponse"}}}},"403":{"description":"Forbidden"},"404":{"description":"Job not found"}}}}}}
```