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/geniusdecision-app:geniusdecision-app-jobs-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

openapi: 3.2.0
info:
  title: Genius Decision — agent integration Jobs API
  version: 0.2.0
  description: 'Genius bounded beta: HTTP agent integration subset. Public discovery; no-human-registration synthetic demo; automatic machine registration for synthetic/non-personal data; separate existing human-account keys. Machine Bearer keys are scoped, revocable and expire after 7 days (demo: 1 hour). Rotation only retains/reduces scopes. Human keys retain full account permissions. No MCP or OAuth. HTTP acceptance is distinct from formal admission and empirical evidence. Body limit 128 KiB; input limit 110000 JSON bytes. Declared choice profile: /static/decisions.html; explicit review and confirmation required. No general narrative solver or real-world CAG/PVS claim.'
servers:
- url: /
security:
- AccountBearer: []
tags:
- name: Jobs
paths:
  /api/jobs/{job_id}:
    parameters:
    - name: job_id
      in: path
      required: true
      schema:
        type: string
        pattern: ^[a-f0-9]{32}$
    get:
      operationId: readGeniusJob
      summary: Read execution state and bounded result
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobEnvelope'
        default:
          description: HTTP failure, not a motor result. 400 invalid input, 401 unauthorized, 403 origin/CSRF, 404 unavailable, 409 conflict/retry required, 413 size limit, 415 content type, 429 quota, 503 suspended/backup/storage unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: Poll with pauses. completed is an execution state, not conclusive evidence. Preserve result_json and all layers of result.response.
      x-required-agent-scope: cases:read
      tags:
      - Jobs
  /api/jobs/{job_id}/cancel:
    parameters:
    - name: job_id
      in: path
      required: true
      schema:
        type: string
        pattern: ^[a-f0-9]{32}$
    post:
      operationId: cancelGeniusJob
      summary: Request cancellation of an owned job
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobEnvelope'
        default:
          description: HTTP failure, not a motor result. 400 invalid input, 401 unauthorized, 403 origin/CSRF, 404 unavailable, 409 conflict/retry required, 413 size limit, 415 content type, 429 quota, 503 suspended/backup/storage unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              maxProperties: 0
      description: A running job may remain running until the worker processes cancellation. Cancellation is not mathematical infeasibility.
      x-required-agent-scope: jobs:run
      tags:
      - Jobs
  /api/jobs/{job_id}/artifacts:
    parameters:
    - name: job_id
      in: path
      required: true
      schema:
        type: string
        pattern: ^[a-f0-9]{32}$
    get:
      operationId: downloadGeniusArtifacts
      summary: Download private verification artifacts
      responses:
        '200':
          description: ZIP archive belonging to the account. Handle as private data.
          headers:
            X-Artifact-SHA256:
              schema:
                type: string
              description: SHA-256 of the archive.
          content:
            application/zip:
              schema:
                type: string
                format: binary
        default:
          description: HTTP failure, not a motor result. 400 invalid input, 401 unauthorized, 403 origin/CSRF, 404 unavailable, 409 conflict/retry required, 413 size limit, 415 content type, 429 quota, 503 suspended/backup/storage unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-required-agent-scope: cases:read
      tags:
      - Jobs
components:
  schemas:
    Job:
      type: object
      properties:
        id:
          type: string
        case_id:
          type: string
        revision:
          type: integer
        status:
          enum:
          - queued
          - running
          - completed
          - failed
          - cancelled
          - interrupted
        error:
          type:
          - string
          - 'null'
        created_at:
          type: integer
        started_at:
          type:
          - integer
          - 'null'
        finished_at:
          type:
          - integer
          - 'null'
        result:
          type:
          - object
          - 'null'
          description: Preserve the complete response envelope. See full documentation for RC01 semantics.
        result_json:
          type:
          - string
          - 'null'
          description: Original result JSON text; preserve exactly to avoid numeric rounding.
        admission:
          type:
          - object
          - 'null'
        artifacts:
          type:
          - object
          - 'null'
          properties:
            url:
              type: string
            sha256:
              type: string
            size:
              type: integer
      required:
      - id
      - case_id
      - revision
      - status
      - result
      - result_json
    JobEnvelope:
      type: object
      properties:
        job:
          $ref: '#/components/schemas/Job'
      required:
      - job
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
          required:
          - code
          - message
      required:
      - error
  securitySchemes:
    AccountBearer:
      type: http
      scheme: bearer
      description: HTTPS Authorization Bearer only. ga_ machine credentials carry enforced scopes and expiry for their own isolated space. gb_ human-account API keys retain full-account access. Neither is a JWT. No key in a query string.
externalDocs:
  description: Full API contract and limitations
  url: https://geniusdecision.app/static/api.html
x-genius-mcp-available: true
x-genius-credential-scope:
  human: full-account
  automatic_agent: enforced-scopes-and-expiry
x-genius-client-safety:
  human_consent_never_inferred: true
  automatic_agent_data_policy: synthetic_or_non_personal_only
  synthetic_examples_are_not_empirical_evidence: true
  no_automatic_write_retries: true
x-genius-mcp:
  url: /mcp
  transport: streamable-http
  protocol_versions:
  - '2026-07-28'
  - '2025-11-25'
  - '2025-06-18'
  - '2025-03-26'
  public_tools:
  - get_capabilities
  - read_demo_result
  - run_demo
  private_authentication: scoped-machine-bearer-header
  oauth: false
x-genius-saved-demo:
  json: /static/demo-result.json
  html: /static/demo.html
  live_execution_on_get: false
  evidence_origin: synthetic