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/derive-to:derive-to-moderation-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: Derive Moderation API
  version: 1.0.0
  description: 'Derive''s HTTP API. Every response shape here is the single source of truth for the web client — generated from the same Zod schemas that back this reference, so the docs never drift from the running API.


    **Auth:** a session cookie (browser) or a bearer token (agents and the CLI). Most write routes are scoped to the caller''s active workspace. The `/v1` paths are the stable product surface; `/openapi.json` serves this spec and `/docs` renders it.'
tags:
- name: Moderation
  description: Abuse reports and takedown / reinstate actions.
paths:
  /v1/artifacts/{shortId}/report:
    post:
      tags:
      - Moderation
      summary: Report an artifact for abuse (public)
      parameters:
      - schema:
          type: string
        required: true
        name: shortId
        in: path
      responses:
        '201':
          description: The report was filed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                required:
                - ok
      operationId: postV1ArtifactsByShortIdReport
      x-operation-id-source: derived
  /v1/reports:
    get:
      tags:
      - Moderation
      summary: The open moderation queue (Admin only)
      responses:
        '200':
          description: Open reports and their count.
          content:
            application/json:
              schema:
                type: object
                properties:
                  reports:
                    type: array
                    items:
                      $ref: '#/components/schemas/Report'
                  open:
                    type: number
                required:
                - reports
                - open
      operationId: getV1Reports
      x-operation-id-source: derived
  /v1/audit:
    get:
      tags:
      - Moderation
      summary: The moderation audit log (Admin only)
      responses:
        '200':
          description: Recent audit-log entries.
          content:
            application/json:
              schema:
                type: object
                properties:
                  audit:
                    type: array
                    items:
                      $ref: '#/components/schemas/AuditEntry'
                required:
                - audit
      operationId: getV1Audit
      x-operation-id-source: derived
  /v1/artifacts/{shortId}/takedown:
    post:
      tags:
      - Moderation
      summary: Take an artifact down (Admin only); its content 410s everywhere
      parameters:
      - schema:
          type: string
        required: true
        name: shortId
        in: path
      responses:
        '200':
          description: The artifact was taken down.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  removed:
                    type: boolean
                required:
                - ok
                - removed
      operationId: postV1ArtifactsByShortIdTakedown
      x-operation-id-source: derived
  /v1/artifacts/{shortId}/reinstate:
    post:
      tags:
      - Moderation
      summary: Reverse an artifact takedown (Admin only)
      parameters:
      - schema:
          type: string
        required: true
        name: shortId
        in: path
      responses:
        '200':
          description: The artifact was reinstated.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  removed:
                    type: boolean
                required:
                - ok
                - removed
      operationId: postV1ArtifactsByShortIdReinstate
      x-operation-id-source: derived
  /v1/reports/{id}/dismiss:
    post:
      tags:
      - Moderation
      summary: Dismiss a report without taking the artifact down (Admin only)
      parameters:
      - schema:
          type: string
        required: true
        name: id
        in: path
      responses:
        '200':
          description: The report was dismissed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                required:
                - ok
      operationId: postV1ReportsByIdDismiss
      x-operation-id-source: derived
components:
  schemas:
    Report:
      type: object
      properties:
        id:
          type: string
        artifact_id:
          type: string
        artifact_short_id:
          type: string
        reason:
          type: string
          description: The reporter's stated reason for the report
        detail:
          type:
          - string
          - 'null'
          description: Optional extra detail from the reporter, or null
        reporter:
          type:
          - string
          - 'null'
          description: The reporter's IP (best-effort), or null; abuse reports are anonymous/public
        state:
          type: string
          enum:
          - open
          - actioned
          - dismissed
          description: open (awaiting review), actioned (taken down), or dismissed (no action)
        created_at:
          type: string
      required:
      - id
      - artifact_id
      - artifact_short_id
      - reason
      - detail
      - reporter
      - state
      - created_at
    AuditEntry:
      type: object
      properties:
        id:
          type: string
        org_id:
          type: string
        action:
          type: string
          enum:
          - report
          - takedown
          - reinstate
          - dismiss
          description: 'What happened: report filed, takedown, reinstate, or dismiss'
        artifact_id:
          type:
          - string
          - 'null'
          description: The artifact acted on, or null if not artifact-specific
        actor:
          type: string
          description: 'Who performed it: a user''s name, or an IP/''anonymous'' for public reports'
        detail:
          type:
          - string
          - 'null'
          description: Context such as the report reason or takedown note, or null
        created_at:
          type: string
      required:
      - id
      - org_id
      - action
      - artifact_id
      - actor
      - detail
      - created_at