API reference

The Platform API is a versioned, JSON-over-HTTPS contract. Protected operations require a short-lived bearer token and return a correlated request ID.

Contract

Download OpenAPI 3.1

Version policy

Vision Core base URL: https://vision.ivisionstudios.com

Exchange a credential

Name
POST /oauth/token
Type
OAuth 2.0
Description
Exchange a current client credential for a token lasting no more than 300 seconds.

Content type: application/x-www-form-urlencoded

List installed Apps

Name
GET /platform/v1/apps
Type
vision.apps:read
Description
Return the installed Apps visible to the client.

Read organization context

Name
GET /platform/v1/organization
Type
vision.organization.basic:read
Description
Return bounded organization and installation context.

Read a publication

Name
GET /platform/v1/publications/{appId}/{resourceType}/{sourceRecordId}
Type
platform.publications:read
Description
Return one active allowlisted projection. Platform and source-App entitlements are also required.

Error envelope

{
  "error": {
    "code": "insufficient_scope",
    "message": "The access token does not grant this operation.",
    "requestId": "req_...",
    "retryable": false
  }
}