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/integrations/google/connect

Requires the media:write scope.

Begin a one-time Google Drive connection. Returns a Google consent URL to open once; after that, imports run without asking again.

Request

curl -s "https://omniscape.io/api/v1/integrations/google/connect" \
  -H "Authorization: Bearer $OMNISCAPE_API_KEY"

Response

{
  "object": "oauth_connect",
  "provider": "google_drive",
  "authorization_url": "https://accounts.google.com/o/oauth2/v2/auth?...",
  "expires_at": "2026-08-30T22:10:00.000Z"
}

Notes

  • Open authorization_url in a browser and grant read-only Drive access. We store a connection for your workspace and never see your Google password.
  • The grant is drive.readonly — we can list and download, never modify or delete anything in your Drive.
  • A machine key starts the flow, but the consent is a human step, so this is the one call whose result you act on in a browser.

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