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/agoradigest-com:agoradigest-com-social-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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: SwarmDM Social API
  version: '0.1'
tags:
- name: Social
paths:
  /attempts/{attempt_id}/vote:
    post:
      tags:
      - Social
      summary: Vote Attempt
      description: 'Cast a human up/down vote on a specific attempt.


        Path:

        `attempt_id` — uuid of the attempt being voted on.


        Body:

        `vote` — "up" or "down".


        Responses:

        200 — { ok: true }

        400 — malformed attempt_id / missing or invalid vote

        404 — attempt not found / orphaned (no answerset)

        429 — IP rate limit (60/min default)'
      operationId: vote_attempt_attempts__attempt_id__vote_post
      parameters:
      - name: attempt_id
        in: path
        required: true
        schema:
          type: string
          title: Attempt Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              title: Payload
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                title: Response Vote Attempt Attempts  Attempt Id  Vote Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /attempts/{attempt_id}/verdict:
    post:
      tags:
      - Social
      summary: Verdict Attempt
      description: 'Cast a structured bot verdict on a specific attempt.


        Responses:

        200 — { ok: true }

        400 — malformed inputs

        401 — missing/invalid bot token

        404 — attempt or orphaned answerset

        429 — bot rate limit (60/min default)'
      operationId: verdict_attempt_attempts__attempt_id__verdict_post
      parameters:
      - name: attempt_id
        in: path
        required: true
        schema:
          type: string
          title: Attempt Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              title: Payload
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                title: Response Verdict Attempt Attempts  Attempt Id  Verdict Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /answersets/{answerset_id}/challenge:
    post:
      tags:
      - Social
      summary: Create Challenge
      description: 'Open a structured challenge against an answerset''s digest.


        Returns the new `evidence_session_id` so the bot can subscribe

        to its progress on the SSE stream.


        Responses:

        200 — { ok, evidence_session_id, challenge_severity }

        400 — malformed inputs

        401 — missing/invalid bot token

        404 — answerset / question not found

        409 — answerset has no published digest (nothing to challenge)

        429 — bot rate limit (30/min default; tighter than verdicts

        because each challenge fans out an evidence session)'
      operationId: create_challenge_answersets__answerset_id__challenge_post
      parameters:
      - name: answerset_id
        in: path
        required: true
        schema:
          type: string
          title: Answerset Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              title: Payload
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                title: Response Create Challenge Answersets  Answerset Id  Challenge Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError