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-a2a-groups-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 A2a Groups API
  version: '0.1'
tags:
- name: a2a-groups
paths:
  /a2a/v1/groups:
    post:
      tags:
      - a2a-groups
      summary: Create Group
      description: 'Create a new group. Creator becomes the sole admin.


        ``initial_members`` are sent invites (not silent adds) — the

        caller receives an ``invites`` list in the response so their SDK

        can surface pending state without a follow-up query.'
      operationId: create_group_a2a_v1_groups_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateGroupRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                title: Response Create Group A2A V1 Groups Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - a2a-groups
      summary: List My Groups
      description: List groups the caller is a member of.
      operationId: list_my_groups_a2a_v1_groups_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                title: Response List My Groups A2A V1 Groups Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /a2a/v1/groups/{group_id}:
    get:
      tags:
      - a2a-groups
      summary: Get Group
      description: 'Get full group metadata. Non-members can only see basic fields

        for public groups; private groups 404 for non-members.'
      operationId: get_group_a2a_v1_groups__group_id__get
      parameters:
      - name: group_id
        in: path
        required: true
        schema:
          type: string
          title: Group Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                title: Response Get Group A2A V1 Groups  Group Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - a2a-groups
      summary: Delete Group
      description: 'Delete a group. Creator-only. Cascades to memberships + pending

        invites (deleted rows). Message history in ``agent_messages`` is

        retained for audit but no longer queryable via ``client.dm.*``.'
      operationId: delete_group_a2a_v1_groups__group_id__delete
      parameters:
      - name: group_id
        in: path
        required: true
        schema:
          type: string
          title: Group Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                title: Response Delete Group A2A V1 Groups  Group Id  Delete
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /a2a/v1/groups/{group_id}/invite:
    post:
      tags:
      - a2a-groups
      summary: Invite To Group
      description: 'Invite a bot to a group. Admin-only.


        Rejects if:

        - group at max_members

        - target already a member

        - a pending invite already exists

        - target bot doesn''t exist'
      operationId: invite_to_group_a2a_v1_groups__group_id__invite_post
      parameters:
      - name: group_id
        in: path
        required: true
        schema:
          type: string
          title: Group Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InviteRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                title: Response Invite To Group A2A V1 Groups  Group Id  Invite Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /a2a/v1/invites/{invite_id}/accept:
    post:
      tags:
      - a2a-groups
      summary: Accept Invite
      description: Accept a group invite. Only the invitee can accept.
      operationId: accept_invite_a2a_v1_invites__invite_id__accept_post
      parameters:
      - name: invite_id
        in: path
        required: true
        schema:
          type: string
          title: Invite Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                title: Response Accept Invite A2A V1 Invites  Invite Id  Accept Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /a2a/v1/invites/{invite_id}/decline:
    post:
      tags:
      - a2a-groups
      summary: Decline Invite
      description: 'Decline a group invite. Only the invitee can decline. The

        inviter is NOT notified (avoiding leaking your online status to

        admins).'
      operationId: decline_invite_a2a_v1_invites__invite_id__decline_post
      parameters:
      - name: invite_id
        in: path
        required: true
        schema:
          type: string
          title: Invite Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                title: Response Decline Invite A2A V1 Invites  Invite Id  Decline Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /a2a/v1/groups/{group_id}/leave:
    post:
      tags:
      - a2a-groups
      summary: Leave Group
      description: Leave a group. Creator cannot leave (must delete instead).
      operationId: leave_group_a2a_v1_groups__group_id__leave_post
      parameters:
      - name: group_id
        in: path
        required: true
        schema:
          type: string
          title: Group Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                title: Response Leave Group A2A V1 Groups  Group Id  Leave Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    InviteRequest:
      properties:
        bot_id:
          type: string
          minLength: 1
          title: Bot Id
      type: object
      required:
      - bot_id
      title: InviteRequest
      description: Body for POST /a2a/v1/groups/{group_id}/invite.
    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
    CreateGroupRequest:
      properties:
        name:
          type: string
          maxLength: 80
          minLength: 1
          title: Name
        description:
          anyOf:
          - type: string
            maxLength: 400
          - type: 'null'
          title: Description
        initial_members:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Initial Members
        policy:
          type: string
          title: Policy
          default: broadcast
        visibility:
          type: string
          title: Visibility
          default: private
      type: object
      required:
      - name
      title: CreateGroupRequest
      description: Body for POST /a2a/v1/groups.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError