> For the complete documentation index, see [llms.txt](https://docs.toomuchmedia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toomuchmedia.com/api/api-endpoints/cms/api-cms-transcode-take.md).

# /api/cms/transcode‑take

## POST /api/cms/transcode-take

> Reserve a transcoding job from the queue

```json
{"openapi":"3.0.2","info":{"title":"API Specification","version":"v1"},"tags":[{"name":"/api/cms/transcode-take"}],"security":[{"api-key":[],"api-username":[]}],"components":{"securitySchemes":{"api-key":{"type":"apiKey","in":"header","name":"api-key"}},"schemas":{"post_cms_transcode-take":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["worker_id","worker_path","worker_version","pid"]}}},"paths":{"/api/cms/transcode-take":{"post":{"description":"Reserve a transcoding job from the queue","tags":["/api/cms/transcode-take"],"parameters":[{"name":"worker_id","in":"query","schema":{"type":"string"},"required":true},{"name":"worker_path","in":"query","schema":{"type":"string"},"required":true},{"name":"worker_version","in":"query","schema":{"type":"string"},"required":true},{"name":"type","in":"query","schema":{"default":"--notset--","type":"string"},"required":false},{"name":"pid","in":"query","schema":{"type":"integer"},"required":true},{"name":"errors","in":"query","schema":{"type":"string"},"required":false}],"responses":{"200":{"description":"success","content":{"text/php":{"schema":{"$ref":"#/components/schemas/post_cms_transcode-take"}},"application/json":{"schema":{"$ref":"#/components/schemas/post_cms_transcode-take"}},"application/xml":{"schema":{"$ref":"#/components/schemas/post_cms_transcode-take"}}}}}}}}}
```