Skip to main content
GET
/
api
/
partner
/
v1
/
installs
/
current
curl -sS https://app.opentrain.ai/api/partner/v1/installs/current \
  -H "Authorization: Bearer $OT_PARTNER_TOKEN"

{
  "install": {
    "id": "<INSTALL_ID>",
    "status": "ACTIVE",
    "scopes": [
      "project-links:read",
      "project-links:write",
      "contracts:read",
      "participants:read",
      "participants:email",
      "webhooks:manage"
    ],
    "piiConsent": true,
    "organizationId": "<ORG_ID>",
    "createdAt": "2026-06-12T10:00:00.000Z",
    "partnerApp": {
      "id": "<APP_ID>",
      "slug": "your-app",
      "name": "Your App"
    },
    "token": {
      "id": "<TOKEN_ID>",
      "name": "Your App connection",
      "scopes": [
        "project-links:read",
        "project-links:write",
        "contracts:read",
        "participants:read",
        "participants:email",
        "webhooks:manage"
      ]
    }
  }
}
Returns the install the calling token belongs to. Use it as a connectivity check after the customer pastes in their token, and to confirm which scopes and PII consent you actually hold before relying on them. Requirements: any valid platform token — no specific scope. (Like every Platform API call, it still requires a live token, an ACTIVE install, an ACTIVE platform app, and the annotation-platform feature on the granting employer.)

​
Request

No parameters.

​
Response

​
install
object
The current install.

​
Errors

StatuscodeMeaning
401UNAUTHORIZEDMissing, invalid, or revoked token
403FORBIDDENInstall or platform app no longer active, or annotation-platform feature disabled for the granting employer
curl -sS https://app.opentrain.ai/api/partner/v1/installs/current \
  -H "Authorization: Bearer $OT_PARTNER_TOKEN"

{
  "install": {
    "id": "<INSTALL_ID>",
    "status": "ACTIVE",
    "scopes": [
      "project-links:read",
      "project-links:write",
      "contracts:read",
      "participants:read",
      "participants:email",
      "webhooks:manage"
    ],
    "piiConsent": true,
    "organizationId": "<ORG_ID>",
    "createdAt": "2026-06-12T10:00:00.000Z",
    "partnerApp": {
      "id": "<APP_ID>",
      "slug": "your-app",
      "name": "Your App"
    },
    "token": {
      "id": "<TOKEN_ID>",
      "name": "Your App connection",
      "scopes": [
        "project-links:read",
        "project-links:write",
        "contracts:read",
        "participants:read",
        "participants:email",
        "webhooks:manage"
      ]
    }
  }
}