Eshway Organizations API

The Organizations API from Eshway — 8 operation(s) for organizations.

GitHub OpenAPI

Operations 9

POST /v1/organizations/create Create Organization #
GET /v1/organizations/my-organizations List User Organizations #
GET /v1/organizations/{organization_id}/members Get Organization Members #
POST /v1/organizations/upload-logo Upload Logo #
DELETE /v1/organizations/{organization_id} Delete Organization #
PUT /v1/organizations/{organization_id} Update Organization #
GET /v1/organizations/my-organizations/members/count Get Total Members Count #
GET /v1/organizations/{organization_id}/members/count Get Organization Members Count #
POST /v1/organizations/{organization_id}/import-members Import Members #

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/eshway-com:eshway-com-organizations-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.

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

OpenAPI Specification

eshway-com-organizations-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Fast Organizations API
  version: 0.1.0
tags:
- name: Organizations
paths:
  /v1/organizations/create:
    post:
      tags:
      - Organizations
      summary: Create Organization
      operationId: create_organization_v1_organizations_create_post
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_create_organization_v1_organizations_create_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - OAuth2PasswordBearer: []
  /v1/organizations/my-organizations:
    get:
      tags:
      - Organizations
      summary: List User Organizations
      operationId: list_user_organizations_v1_organizations_my_organizations_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/OrganizationResponse'
                type: array
                title: Response List User Organizations V1 Organizations My Organizations Get
      security:
      - OAuth2PasswordBearer: []
  /v1/organizations/{organization_id}/members:
    get:
      tags:
      - Organizations
      summary: Get Organization Members
      description: Get all members of an organization.
      operationId: get_organization_members_v1_organizations__organization_id__members_get
      security:
      - OAuth2PasswordBearer: []
      parameters:
      - name: organization_id
        in: path
        required: true
        schema:
          type: integer
          title: Organization Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OrganizationMemberResponse'
                title: Response Get Organization Members V1 Organizations  Organization Id  Members Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/organizations/upload-logo:
    post:
      tags:
      - Organizations
      summary: Upload Logo
      operationId: upload_logo_v1_organizations_upload_logo_post
      security:
      - OAuth2PasswordBearer: []
      parameters:
      - name: organization_id
        in: query
        required: false
        schema:
          type: integer
          title: Organization Id
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_upload_logo_v1_organizations_upload_logo_post'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/organizations/{organization_id}:
    delete:
      tags:
      - Organizations
      summary: Delete Organization
      description: 'Delete an organization and all associated data.

        Only organization admins/super_admins can perform this action.


        Performs cascading bulk deletion of all dependent resources in the

        correct foreign-key dependency order within a single transaction.'
      operationId: delete_organization_v1_organizations__organization_id__delete
      security:
      - OAuth2PasswordBearer: []
      parameters:
      - name: organization_id
        in: path
        required: true
        schema:
          type: integer
          title: Organization Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    put:
      tags:
      - Organizations
      summary: Update Organization
      description: Update an organization's details. Only organization admins can perform this action.
      operationId: update_organization_v1_organizations__organization_id__put
      security:
      - OAuth2PasswordBearer: []
      parameters:
      - name: organization_id
        in: path
        required: true
        schema:
          type: integer
          title: Organization Id
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_update_organization_v1_organizations__organization_id__put'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/organizations/my-organizations/members/count:
    get:
      tags:
      - Organizations
      summary: Get Total Members Count
      operationId: get_total_members_count_v1_organizations_my_organizations_members_count_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - OAuth2PasswordBearer: []
  /v1/organizations/{organization_id}/members/count:
    get:
      tags:
      - Organizations
      summary: Get Organization Members Count
      description: Get the member count for a specific organization.
      operationId: get_organization_members_count_v1_organizations__organization_id__members_count_get
      security:
      - OAuth2PasswordBearer: []
      parameters:
      - name: organization_id
        in: path
        required: true
        schema:
          type: integer
          title: Organization Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/organizations/{organization_id}/import-members:
    post:
      tags:
      - Organizations
      summary: Import Members
      operationId: import_members_v1_organizations__organization_id__import_members_post
      security:
      - OAuth2PasswordBearer: []
      parameters:
      - name: organization_id
        in: path
        required: true
        schema:
          type: integer
          title: Organization Id
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_import_members_v1_organizations__organization_id__import_members_post'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    PlanFeature:
      properties:
        name:
          type: string
          title: Name
        included:
          type: boolean
          title: Included
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        value:
          anyOf:
          - type: string
          - type: integer
          - type: 'null'
          title: Value
      type: object
      required:
      - name
      - included
      title: PlanFeature
    OrganizationLogoUrls:
      properties:
        original:
          type: string
          title: Original
        thumbnail:
          type: string
          title: Thumbnail
        small:
          type: string
          title: Small
        medium:
          type: string
          title: Medium
        format:
          type: string
          title: Format
      type: object
      required:
      - original
      - thumbnail
      - small
      - medium
      - format
      title: OrganizationLogoUrls
    Body_create_organization_v1_organizations_create_post:
      properties:
        name:
          type: string
          title: Name
        address:
          type: string
          title: Address
        industry:
          type: string
          title: Industry
        plan:
          type: string
          title: Plan
          default: Free
        logo:
          type: string
          format: binary
          title: Logo
      type: object
      required:
      - name
      title: Body_create_organization_v1_organizations_create_post
    Body_update_organization_v1_organizations__organization_id__put:
      properties:
        name:
          type: string
          title: Name
        address:
          type: string
          title: Address
        industry:
          type: string
          title: Industry
        plan:
          type: string
          title: Plan
        new_project_access_policy:
          type: string
          title: New Project Access Policy
        logo:
          type: string
          format: binary
          title: Logo
        remove_logo:
          type: boolean
          title: Remove Logo
          default: false
      type: object
      title: Body_update_organization_v1_organizations__organization_id__put
    OrganizationMemberResponse:
      properties:
        user_id:
          type: integer
          title: User Id
        email:
          type: string
          title: Email
        full_name:
          type: string
          title: Full Name
        role:
          type: string
          title: Role
        joined_at:
          type: string
          format: date-time
          title: Joined At
      type: object
      required:
      - user_id
      - email
      - full_name
      - role
      - joined_at
      title: OrganizationMemberResponse
    OrgSubscriptionSchema:
      properties:
        id:
          type: integer
          title: Id
        plan:
          $ref: '#/components/schemas/SubscriptionPlanSchema'
        org_id:
          type: integer
          title: Org Id
        admin_id:
          type: integer
          title: Admin Id
        razorpay_subscription_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Razorpay Subscription Id
        status:
          type: string
          title: Status
        current_period_start:
          type: string
          format: date-time
          title: Current Period Start
        current_period_end:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Current Period End
        grace_period_end:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Grace Period End
        trial_end:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Trial End
        cancel_at_period_end:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Cancel At Period End
        days_until_expiration:
          anyOf:
          - type: integer
          - type: 'null'
          title: Days Until Expiration
        is_active:
          type: boolean
          title: Is Active
        members_cap:
          type: integer
          title: Members Cap
        monthly_bill:
          type: number
          title: Monthly Bill
        currency:
          type: string
          title: Currency
      type: object
      required:
      - id
      - plan
      - org_id
      - admin_id
      - status
      - current_period_start
      - current_period_end
      - trial_end
      - cancel_at_period_end
      - days_until_expiration
      - is_active
      - members_cap
      - monthly_bill
      - currency
      title: OrgSubscriptionSchema
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SubscriptionPlanSchema:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        price:
          type: integer
          title: Price
        interval:
          type: string
          title: Interval
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        duration:
          type: integer
          title: Duration
        features:
          items:
            $ref: '#/components/schemas/PlanFeature'
          type: array
          title: Features
        popular:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Popular
          default: false
        limitations:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Limitations
          default: []
      type: object
      required:
      - id
      - name
      - price
      - interval
      - description
      - duration
      - features
      title: SubscriptionPlanSchema
    Body_upload_logo_v1_organizations_upload_logo_post:
      properties:
        file:
          type: string
          format: binary
          title: File
      type: object
      required:
      - file
      title: Body_upload_logo_v1_organizations_upload_logo_post
    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
    OrganizationResponse:
      properties:
        id:
          type: integer
          title: Id
        name:
          type: string
          title: Name
        address:
          anyOf:
          - type: string
          - type: 'null'
          title: Address
        industry:
          anyOf:
          - type: string
          - type: 'null'
          title: Industry
        subscription:
          anyOf:
          - items:
              $ref: '#/components/schemas/OrgSubscriptionSchema'
            type: array
          - type: 'null'
          title: Subscription
        plan:
          anyOf:
          - type: string
          - type: 'null'
          title: Plan
          default: Free
        logo:
          anyOf:
          - $ref: '#/components/schemas/OrganizationLogoUrls'
          - type: 'null'
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        can_manage:
          type: boolean
          title: Can Manage
          default: false
        member_count:
          type: integer
          title: Member Count
        new_project_access_policy:
          type: string
          enum:
          - creator_only
          - admins_managers
          - all_members
          title: New Project Access Policy
          default: creator_only
      type: object
      required:
      - id
      - name
      - created_at
      - updated_at
      - member_count
      title: OrganizationResponse
    Body_import_members_v1_organizations__organization_id__import_members_post:
      properties:
        file:
          type: string
          format: binary
          title: File
      type: object
      required:
      - file
      title: Body_import_members_v1_organizations__organization_id__import_members_post
  securitySchemes:
    OAuth2PasswordBearer:
      type: oauth2
      flows:
        password:
          scopes: {}
          tokenUrl: token