Get Current Install

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"
      ]
    }
  }
}

GET

api

partner

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

object

The current install.

Show Install fields

string

Install ID. Also delivered as opentrain_install_id on the consent return redirect.

string

ACTIVE or REVOKED. A revoked install’s tokens stop authenticating, so in practice you only ever see ACTIVE here.

string[]

The scopes the customer granted — see the scope table.

Whether the customer checked the explicit Work Email consent box. participants:email only takes effect when this is true.

string | null

The granting employer’s organization ID.

string

ISO 8601 timestamp of the grant.

object

Your app: {id, slug, name}.

object

The token used for this request: {id, name, scopes}.

Errors

Status	`code`	Meaning
`401`	`UNAUTHORIZED`	Missing, invalid, or revoked token
`403`	`FORBIDDEN`	Install 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"
      ]
    }
  }
}

Platform API Reference Overview

List Project Links

⌘I

Getting started

Connect your agent

Core concepts

Guides

API reference

CLI

MCP server

Annotation platforms

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors