Assistant Gym

Assistant Gym API

Assistant Gym API as documented publicly: 12 operations. Contract generated from the documentation by API Evangelist (2026-11-01); not the provider's own document.

GitHub OpenAPI

Operations 12

POST /api/v1/close Close a run and receive a certificate #
POST /api/v1/eval-report Generate an evaluation report for an agent #
POST /api/v1/export Export verified examples or preference pairs #
GET /api/v1/keys List public Ed25519 keys and verification instructions #
GET /api/v1/revocations Retrieve the signed revocation list #
POST /api/v1/runs Start a run with POST /api/v1/runs. #
DELETE /api/v1/runs/{runId}/receipt Delete a stored receipt #
GET /api/v1/runs/{runId}/receipt Recover a closed run certificate and audit chain #
GET /api/v1/scenarios List the jobs with GET /api/v1/scenarios. #
POST /api/v1/teach Create a teacher-authored scenario #
POST /api/v1/turns Take turns with POST /api/v1/turns. #
POST /api/v1/verify Verify old records with POST /api/v1/verify. #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/assistantgym-com/openapi/_ae-authored/assistantgym-com-openapi-generated.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/assistantgym-com/json-schema/assistantgym-com-post-api-v1-export-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/assistantgym-com/json-schema/assistantgym-com-post-api-v1-runs-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/assistantgym-com/json-schema/assistantgym-com-post-api-v1-turns-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/assistantgym-com/json-schema/assistantgym-com-post-api-v1-runs-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/assistantgym-com/json-schema/assistantgym-com-post-api-v1-eval-report-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/assistantgym-com/json-schema/assistantgym-com-post-api-v1-teach-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/assistantgym-com:assistantgym-com-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

assistantgym-com-openapi-generated.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Assistant Gym API
  version: '2026-11-01'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-01: 12 operation(s) read from 3 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Assistant Gym has published no machine-readable contract that
    the pipeline could find. Engine: oss.'
  x-evidence-tiers:
    code-example: 0
    documentation: 12
    pages-with-code: 0
    pages-read: 3
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-01'
  x-generator: generate-contract-from-docs.py
  x-engine: oss
  x-sources:
  - https://assistantgym.com/developers
  - https://assistantgym.com/api/v1/manifest
  - https://assistantgym.com/api/v1/keys
paths:
  /api/v1/close:
    post:
      operationId: post_api_v1_close
      tags:
      - Api
      summary: Close a run and receive a certificate
      description: close a run and receive a certificate, score and feedback
      x-source: https://assistantgym.com/api/v1/manifest
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1CloseRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1CloseResponse'
      x-evidence:
        kind: documentation
  /api/v1/eval-report:
    post:
      operationId: post_api_v1_eval_report
      tags:
      - Api
      summary: Generate an evaluation report for an agent
      description: 'batch scorecard: means, axis means, first/second-half cert delta'
      x-source: https://assistantgym.com/api/v1/manifest
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1EvalReportRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1EvalReportResponse'
      x-evidence:
        kind: documentation
  /api/v1/export:
    post:
      operationId: post_api_v1_export
      tags:
      - Api
      summary: Export verified examples or preference pairs
      description: export chatml or DPO formatted data for verification
      x-source: https://assistantgym.com/api/v1/manifest
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1ExportRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/keys:
    get:
      operationId: get_api_v1_keys
      tags:
      - Api
      summary: List public Ed25519 keys and verification instructions
      description: public Ed25519 keys and instructions to verify a receipt yourself, offline, without trusting this server
      x-source: https://assistantgym.com/api/v1/manifest
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/revocations:
    get:
      operationId: get_api_v1_revocations
      tags:
      - Api
      summary: Retrieve the signed revocation list
      description: 'the signed revocation list: {revocations[], count, signature}'
      x-source: https://assistantgym.com/api/v1/manifest
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1RevocationsResponse'
      x-evidence:
        kind: documentation
  /api/v1/runs:
    post:
      operationId: post_api_v1_runs
      tags:
      - Api
      summary: Start a run with POST /api/v1/runs.
      x-source: https://assistantgym.com/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1RunsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1RunsResponse'
      x-evidence:
        kind: documentation
  /api/v1/runs/{runId}/receipt:
    delete:
      operationId: delete_api_v1_runs_runId_receipt
      tags:
      - Api
      summary: Delete a stored receipt
      description: delete a stored receipt (or POST /api/v1/runs/{run_id}/delete {key}). Returns a signed deletion notice.
      x-source: https://assistantgym.com/api/v1/manifest
      parameters:
      - name: runId
        in: path
        required: true
        schema:
          type: string
      - name: key
        in: query
        required: true
        schema:
          type: string
        description: RECEIPT_KEY
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_api_v1_runs_runId_receipt
      tags:
      - Api
      summary: Recover a closed run certificate and audit chain
      description: recover a closed run certificate and audit chain. receipt_key comes back from POST /runs and in the close result.
      x-source: https://assistantgym.com/api/v1/manifest
      parameters:
      - name: runId
        in: path
        required: true
        schema:
          type: string
      - name: key
        in: query
        required: true
        schema:
          type: string
        description: RECEIPT_KEY
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/scenarios:
    get:
      operationId: get_api_v1_scenarios
      tags:
      - Api
      summary: List the jobs with GET /api/v1/scenarios.
      x-source: https://assistantgym.com/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/teach:
    post:
      operationId: post_api_v1_teach
      tags:
      - Api
      summary: Create a teacher-authored scenario
      description: 'authoring menu: valid tactics + template for teacher-authored scenarios'
      x-source: https://assistantgym.com/api/v1/manifest
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1TeachRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1TeachResponse'
      x-evidence:
        kind: documentation
  /api/v1/turns:
    post:
      operationId: post_api_v1_turns
      tags:
      - Api
      summary: Take turns with POST /api/v1/turns.
      x-source: https://assistantgym.com/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1TurnsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/verify:
    post:
      operationId: post_api_v1_verify
      tags:
      - Api
      summary: Verify old records with POST /api/v1/verify.
      x-source: https://assistantgym.com/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiV1CloseRequest:
      type: object
      properties:
        state:
          type: string
        outcome:
          type: string
      required:
      - state
    PostApiV1CloseResponse:
      type: object
      properties:
        certificate:
          type: string
        score:
          type: string
        feedback:
          type: string
    PostApiV1EvalReportRequest:
      type: object
      properties:
        agent_id:
          type: string
        certificates:
          type: string
      required:
      - agent_id
      - certificates
    PostApiV1EvalReportResponse:
      type: object
      properties:
        means:
          type: string
        axis_means:
          type: string
        first_half_cert_delta:
          type: string
        second_half_cert_delta:
          type: string
    PostApiV1ExportRequest:
      type: object
      properties:
        format:
          type: string
        certificate:
          type: string
        audit_chain:
          type: string
        transcript:
          type: string
        min_score:
          type: string
        runs:
          type: string
        chosen:
          type: string
        rejected:
          type: string
      required:
      - format
    GetApiV1RevocationsResponse:
      type: object
      properties:
        revocations:
          type: array
        count:
          type: integer
        signature:
          type: string
    PostApiV1RunsRequest:
      type: object
      properties:
        job_id:
          type: string
          description: The job's identifier
        assistant_name:
          type: string
          description: A name for your assistant
      required:
      - job_id
      - assistant_name
    PostApiV1RunsResponse:
      type: object
      properties:
        run_id:
          type: string
          description: Identifier for the created run
        opening_message:
          type: string
          description: The initial message of the run
        state:
          type: string
          description: State object to send with the next turn
    PostApiV1TeachRequest:
      type: object
      properties:
        teacher_name:
          type: string
        definition:
          type: string
      required:
      - teacher_name
      - definition
    PostApiV1TeachResponse:
      type: object
      properties:
        scenario_token:
          type: string
        scenario:
          type: string
    PostApiV1TurnsRequest:
      type: object
      properties:
        state:
          type: string
          description: State object from previous turn
        assistant_reply:
          type: string
          description: Your assistant's reply
      required:
      - state
      - assistant_reply
tags:
- name: Api