The Platform API

Arrays (Video Collections)

Manage your videos, ask questions, and build applications with the Platform API. Explore the operations below for request details, responses, and examples.

Arrays (Video Collections)

Group multiple videos into reusable collections for batch analysis.

GET/api/v1/projects/:projectId/arraysList arrays

List arrays

Send the request to https://platform.endlessai.com/api/v1/projects/:projectId/arrays using your project key or user token.

POST/api/v1/projects/:projectId/arraysCreate array

Create array

{
  "name": "Weekend Morning",
  "description": "Front camera clips for Saturday/Sunday 8-11am",
  "videoIds": ["VIDEO_ID_1", "VIDEO_ID_2"]
}

GET/api/v1/projects/:projectId/arrays/:arrayIdGet array details

Get array details

Send the request to https://platform.endlessai.com/api/v1/projects/:projectId/arrays/:arrayId using your project key or user token.

PATCH/api/v1/projects/:projectId/arrays/:arrayIdUpdate array

Update array

{ "name": "Updated Name", "videoIds": ["V1", "V2", "V3"] }

DELETE/api/v1/projects/:projectId/arrays/:arrayIdDelete array

Delete array

Send the request to https://platform.endlessai.com/api/v1/projects/:projectId/arrays/:arrayId using your project key or user token.

POST/api/v1/projects/:projectId/arrays/:arrayId/duplicateClone array

Clone array

{ "name": "Weekend Afternoon (copy)" }

GET/api/v1/projects/:projectId/arrays/:arrayId/resolveList the videos an array currently matches

List the videos an array currently matches

Stored videos that no longer exist are listed in missing. A filter-based array whose filter can't be applied matches nothing and returns failed: true with a reason.

{
            "id": "ARRAY_ID",
            "name": "Weekend Morning",
            "kind": "static",
            "videoIds": ["VIDEO_ID_1", "VIDEO_ID_2"],
            "videos": [
              { "id": "VIDEO_ID_1", "name": "Front camera 08:00" },
              { "id": "VIDEO_ID_2", "name": "Front camera 09:00" }
            ],
            "missing": [],
            "failed": false,
            "reason": null
          }