Skip to content
OmniscapeRenders API
All pages
  1. Overview
  2. Quick start
  3. Authentication
  4. API reference
    1. GET /media
    2. POST /media
    3. GET /media/{id}/preview
    4. GET /integrations/google/connect
    5. GET /integrations/google
    6. DELETE /integrations/google
    7. GET /integrations/google/folders
    8. POST /media/import
    9. GET /media/imports/{id}
    10. POST /renders
    11. GET /renders/{id}
    12. GET /renders/{id}/download
    13. GET /usage
  5. Code examples
  6. Error handling
  7. Rate limits & quotas
  8. Troubleshooting
  9. Changelog

Reference

GET

/api/v1/media/imports/{id}

Requires the media:read scope.

The progress and result of one bulk import: counts, and a per-file breakdown.

Request

curl -s "https://omniscape.io/api/v1/media/imports/imp_9f2a1c3b7e40" \
  -H "Authorization: Bearer $OMNISCAPE_API_KEY"

Response

{
  "object": "media_import",
  "id": "imp_9f2a1c3b7e40",
  "status": "completed",
  "provider": "google_drive",
  "folder_id": "1AbC...",
  "counts": { "discovered": 42, "imported": 40, "skipped": 1, "failed": 1 },
  "stopped_reason": null,
  "items": [
    { "source_ref": "drive-file-1", "name": "a.jpg", "status": "imported", "media_id": "c35c..." },
    { "source_ref": "drive-file-2", "name": "b.svg", "status": "skipped", "reason": "unsupported_media_type" }
  ],
  "created_at": "2026-08-30T21:05:00.000Z",
  "completed_at": "2026-08-30T21:06:30.000Z"
}

Notes

  • Poll until status is completed, partial, or failed. partial means some files imported and some did not — a failure, or a cap was hit (see stopped_reason).
  • Each imported media_id renders like any other library photo. A foreign or unknown id is 404 import_not_found, never 403.

Codes this call can return are on Error handling. If something is behaving unexpectedly, Troubleshooting is organised by symptom.