Platform Discovery CLI

Inspect platform metadata, pricing, and active API-key health from the CLI.

tutorflow platform manifest

Read the public agent discovery manifest:

tutorflow platform manifest

The manifest is useful for agents that need to discover supported platform capabilities before deciding which command or API workflow to run.

Example JSON response:

{
  "schema": "https://tutorflow.io/agent-manifest/v2",
  "name": "TutorFlow Agent Platform",
  "description": "AI-powered teaching content and evaluation APIs for education technology",
  "baseUrl": "https://api.tutorflow.io/v1/platform",
  "auth": {
    "type": "bearer",
    "prefix": "tf_platform_",
    "header": "Authorization"
  },
  "registration": {
    "endpoint": "/v1/platform/agent/register",
    "method": "POST",
    "requiredFields": [
      "name",
      "slug"
    ],
    "optionalFields": [
      "email",
      "agentIdentity"
    ]
  },
  "services": [
    "evaluation",
    "course",
    "module",
    "test",
    "slide",
    "video"
  ],
  "capabilities": {
    "evaluation": {
      "endpoint": "/v1/platform/evaluations",
      "unit": "request",
      "unitPriceUsd": 0.02,
      "description": "Grade open-ended, rubric, or exact-match answers"
    },
    "slide": {
      "endpoint": "/v1/platform/slides",
      "unit": "slide",
      "unitPriceUsd": 0.03,
      "description": "Generate a TipTap-based slide deck with PPTX export. Billed per slide."
    }
  },
  "trial": {
    "creditsUsd": 1,
    "emailVerificationRequiredForTrial": false,
    "emailVerificationRequiredForBilling": true
  },
  "pricing": {
    "endpoint": "/v1/platform/pricing-catalog",
    "currency": "USD",
    "model": "per_unit"
  },
  "docs": "https://tutorflow.io/agent-platform/docs",
  "health": "/v1/platform/health"
}

tutorflow platform pricing

Read the public platform pricing catalog:

tutorflow platform pricing

Use this before generating content or submitting evaluations when an agent needs to estimate cost or present pricing context to an operator.

Example JSON response:

[
  {
    "category": "evaluation",
    "catalogKey": "evaluation.default",
    "tier": "default",
    "amountUsd": 0.02,
    "unit": "request",
    "currency": "USD",
    "source": "platform_pricing_catalog_v2",
    "stripeLookupKey": "platform-evaluation-usd-monthly-metered-v2",
    "stripeMeterEventName": "platform_evaluation_request_v2"
  },
  {
    "category": "slide",
    "catalogKey": "slide.default",
    "tier": "default",
    "amountUsd": 0.03,
    "unit": "slide",
    "currency": "USD",
    "source": "platform_pricing_catalog_v2",
    "stripeLookupKey": "platform-slide-usd-monthly-metered-v2",
    "stripeMeterEventName": "platform_slide_v2"
  }
]

tutorflow platform health

Check whether the active Platform API key is valid:

tutorflow platform health

This command requires authentication. It is the fastest smoke test after setting TUTORFLOW_API_KEY or running tutorflow auth login.

Example JSON response:

{
  "status": "ok",
  "organizationId": "org_2d8b1a3f"
}

Agent-Friendly Smoke Test

For CI or agent bootstrapping, combine JSON mode with platform health:

TUTORFLOW_API_KEY="tf_platform_..." tutorflow --json platform health

A successful command exits with status 0. Authentication and network failures exit non-zero and write structured error output to stderr in JSON mode.