---
title: "Get Operation status"
method: GET
path: "/v1/Webhooks/Operations/{operationId}"
tags: ["Operations"]
---

# Get Operation status

`GET /v1/Webhooks/Operations/{operationId}`

## Request

- Base URL: `https://webhooks.twilio.com`
- URL: `https://webhooks.twilio.com/v1/Webhooks/Operations/{operationId}`
- Auth: HTTP basic

Check status of an async Rule operation.

### Operation Lifecycle

Operations transition from `PENDING` to `COMPLETED` status within 30-60 seconds of a Rule mutation being accepted (202 Accepted with `Operation-Id` header).

## Response `200`

Operation status

- Operation: Tracks status of async Rule operations
  - `id` string, required: Unique operation identifier (TypeID/TTID format)
  - `statusUrl` string, uri, required: URL to poll for operation status (same as Location header in 202 response)
  - `status` 'PENDING' | 'RUNNING' | 'COMPLETED' | 'CANCELLED' | 'FAILED', required: Current state of the operation: - PENDING: Accepted, not yet started - RUNNING: Propagating to all regions (typically 30-60 seconds) - COMPLETED: Rule active globally - CANCELLED: Operation was cancelled before completion - FAILED: Operation could not complete; see error field for details
  - `error` OperationError
    - `type` string, uri, required: URI identifying the problem type
    - `title` string, required: Short human-readable summary of the problem type
    - `code` integer, required: Twilio-specific numeric error code
    - `detail` string, required: Human-readable explanation specific to this occurrence
  - `resourceId` string: ID of the affected resource
  - `createdAt` string, date-time, required
  - `completedAt` string, date-time
  - `retentionPeriod` string, duration, required: ISO-8601 duration for how long this Operation record is retained after creation (fixed at 7 days)

## Other responses

- `401`: Authentication failed
- `403`: Authenticated account does not have permission to perform this operation
- `404`: Operation not found
- `429`: Rate limit exceeded
- `500`: An unexpected server error occurred

---

[API](https://skmtc.dev/twilio/apis/webhooks-v1.md) - [All operations](https://skmtc.dev/twilio/apis/webhooks-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/webhooks-v1/revisions/629b4cc3a029?raw)
