# AngelCam clip API

**Canonical:** https://apis.io/apis/angelcam/angelcam-clip-api/  
**Provider:** AngelCam — https://apis.io/providers/angelcam/  
**Base URL:** https://api.angelcam.com/v1  
**Documentation:** https://developers.angelcam.com/

AngelCam clip API is one of 29 APIs that [AngelCam](https://apis.io/providers/angelcam/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Clip. The published artifact set on APIs.io includes an OpenAPI specification, authentication docs, and rate-limit docs.

A clip is a permanent, downloadable excerpt of recorded footage. Unlike a recording stream — which is a temporary playback session — a clip is processed into a file that can be downloaded or shared with others. **Prerequisite:** The camera must have the Cloud Recording service active. If not, recording endpoints return 404. ## Creating a clip 1. **Check available footage.** Use [`recording/{recording_id}/timeline/`](#operation/my-cameras-recording-timeline) to confirm that footage exists for the time range you want. 2. **Submit the clip request** via [`POST cameras/{camera_id}/clips/`](#operation/my-cameras-clips-create) with a `name`, `start`, and `end`. The maximum clip length is **3 hours**. 3. **Poll for completion.** Clip processing is asynchronous. Status progresses from `PENDING` → `BUILDING` → `READY` (or `ERROR`). Poll [`cameras/{camera_id}/clips/{clip_id}/`](#operation/my-cameras-clips-detail) until the status is `READY`. 4. **Download or share.** A `READY` clip includes a `download_url` (a time-limited direct download link) and a `sharing_token` for unauthenticated sharing via the clip share endpoint.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/cameras/{camera_id}/clips/` | Retrieve camera clips list |
| POST | `/cameras/{camera_id}/clips/` | Create clip |
| GET | `/cameras/{camera_id}/clips/{clip_id}/` | Retrieve a single clip |
| POST | `/cameras/{camera_id}/clips/{clip_id}/share/` | Share a clip via email |
| GET | `/cameras/{camera_id}/clips/{clip_id}/stream/` | Retrieve a clip stream |

## Machine-readable artifacts (13)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/openapi/angelcam-clip-api-openapi.yml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/authentication/angelcam-authentication.yml
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/scopes/angelcam-scopes.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/conventions/angelcam-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/errors/angelcam-problem-types.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/rate-limits/angelcam-rate-limits.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/lifecycle/angelcam-lifecycle.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/data-model/angelcam-data-model.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/conformance/angelcam-conformance.yml
- **AgenticAccess** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/agentic-access/angelcam-agentic-access.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/asyncapi/angelcam-webhooks.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/arazzo/angelcam-watch-live-camera.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/arazzo/angelcam-create-and-share-clip.yml

## Other AngelCam APIs (12)

- [AngelCam active-service API](https://apis.io/apis/angelcam/angelcam-active-service-api/)
- [AngelCam angelcameras API](https://apis.io/apis/angelcam/angelcam-angelcameras-api/)
- [AngelCam arrow-clients API](https://apis.io/apis/angelcam/angelcam-arrow-clients-api/)
- [AngelCam audio-message API](https://apis.io/apis/angelcam/angelcam-audio-message-api/)
- [AngelCam broadcasting API](https://apis.io/apis/angelcam/angelcam-broadcasting-api/)
- [AngelCam camera API](https://apis.io/apis/angelcam/angelcam-camera-api/)
- [AngelCam camera-guest API](https://apis.io/apis/angelcam/angelcam-camera-guest-api/)
- [AngelCam camera-stream-detection API](https://apis.io/apis/angelcam/angelcam-camera-stream-detection-api/)
- [AngelCam client API](https://apis.io/apis/angelcam/angelcam-client-api/)
- [AngelCam event API](https://apis.io/apis/angelcam/angelcam-event-api/)
- [AngelCam incidents API](https://apis.io/apis/angelcam/angelcam-incidents-api/)
- [AngelCam location API](https://apis.io/apis/angelcam/angelcam-location-api/)

## Tags

Clip

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/angelcam/angelcam-clip-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/angelcam/.