---
source: sighthound-developer-portal
url: https://dev.sighthound.com/redactor/reference/operations/get/
markdown-url: https://dev.sighthound.com/redactor/reference/operations/get.md
title: "Get Operations"
description: "Check the status and result payload for asynchronous Redactor operations."
content-type: text/markdown
---

> For AI agents: a documentation index is available at [llms.txt](https://dev.sighthound.com/llms.txt). Markdown versions are available at matching `.md` URLs.

# Get Operations

<div class="portal-reference-panel">
<div class="portal-reference-panel__header">
    <span class="portal-reference-method portal-reference-method--get">GET</span>
    <span class="portal-reference-endpoint"><code>/api/v1/{operation-name}</code></span>
</div>
<p class="portal-reference-summary">Inspect an asynchronous Redactor operation and determine whether processing is pending, complete, or complete with an error.</p>
<div class="portal-reference-grid">
    <div class="portal-reference-item">
        <strong>Path parameter</strong>
        <span>Use the full operation name returned from <code>videos:process</code> or <code>images:process</code>.</span>
    </div>
    <div class="portal-reference-item">
        <strong>Status field</strong>
        <span><code>done</code> is <code>false</code> while processing and <code>true</code> when a <code>response</code> or <code>error</code> is available.</span>
    </div>
    <div class="portal-reference-item">
        <strong>Typical use</strong>
        <span>Poll for progress when webhooks are not configured or when debugging an operation.</span>
    </div>
</div>
</div>

All requests sent to the /api/v1/videos:process endpoint are asynchronous, with each returning an operation name like:

`projects/{project-id}/locations/{location-id}/operations/{operation-id}`

This name is used to both identify a specific Redactor project, and to inspect the status of the operation.

## HTTP Request

`GET /api/v1/{operation-name}`

## Path Parameters

`projects/{project-id}/locations/{location-id}/operations/{operation-id}`

## Response Body

When the value of the "done" field is true, the operation is complete and either the response or error will contain additional information.


| RESPONSE SCHEMA: | application/json                |
| ----------- | ------------------------------------ |
| `name`  | string&lt;operationName&gt; 
 `projects/{project-id}/locations/{location-id}/operations/{operation-id}`|
| `metadata`| object  |
| `done`    | boolean |
| `response`| object  |
| `error   `| object  |


## Samples

### Complete

```json
{
  "name": "projects/0/locations/0/operations/123",
  "metadata": {
    "@type": "sighthound.cloud.v1.Progress",
    "progress": {
      "inputUri": "https://example.com/path/to/video.mp4",
      "progressPercent": 100,
      "startTime": "2020-04-01T22:13:17.978847Z",
      "updateTime": "2020-04-01T22:13:17.978847Z"
    }
  },
  "done": true,
  "response": {
    "@type": "sighthound.cloud.v1.ProcessResponse",
    "processResults": {
      "outputUri": "s3://bucket-name/key-name/"
    }
  }
}
```

### Pending/Progress

```json
{
  "name": "projects/0/locations/0/operations/123",
  "metadata": {
    "@type": "sighthound.cloud.v1.Progress",
    "progress": {
      "inputUri": "https://example.com/path/to/video.mp4",
      "progressPercent": 30,
      "startTime": "2020-04-01T22:13:17.978847Z",
      "updateTime": "2020-04-01T22:13:17.978847Z"
    }
  },
  "done": false
}
```

### Error

```json
{
  "name": "projects/0/locations/0/operations/123",
  "metadata": {
    "@type": "sighthound.cloud.v1.Progress",
    "progress": {
      "inputUri": "https://example.com/path/to/video.mp4",
      "progressPercent": 100,
      "startTime": "2020-04-01T22:13:17.978847Z",
      "updateTime": "2020-04-01T22:13:17.978847Z"
    }
  },
  "done": true,
  "error": {
    "code": 123,
    "message": "corrupt media"
  }
}
```

---

# Agent Instructions

Use this Markdown page as context for Sighthound Developer Portal questions. For broader navigation, read https://dev.sighthound.com/llms.txt. Answer from Sighthound documentation, cite relevant source URLs, and do not ask users to paste secrets, tokens, license keys, or credentials into chat.