---
title: "Send the result of the caption file request."
method: PATCH
path: "/caption_file_requests/{caption_file_request_id}"
tags: ["Professional captioning"]
---

# Send the result of the caption file request.

`PATCH /caption_file_requests/{caption_file_request_id}`

This endpoint should be used to update a pending caption file request. Each request can be updated once with either fulfilled or failed status.

## Path parameters

- `caption_file_request_id` integer, required

## Request body

- object
  - `status` 'processing' | 'fulfilled' | 'failed', required — Result of the file request.
  - `message` string — In case the caption creation was not successful you can provide some detail why it could not be completed.
  - `caption_file` string — The file to be uploaded. The supported file extension is .srt!

## Response `202`

The results are successfully saved.

## Other responses

- `400` — One ore more required parameters are missing from the request.
- `401` — Authorization information is missing or invalid.
- `403` — If a user without proper permissions tries to call this endpoint, the call is rejected with 403 Forbidden.
- `422` — Invalid parameters.

---

[API](https://skmtc.net/instructure/apis/studio-public-api.md) · [All operations](https://skmtc.net/instructure/apis/studio-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instructure/studio-public-api/revisions/4838a5113869/schema)