Moesif

Moesif Workspaces API

The Workspaces API from Moesif — 8 operation(s) for workspaces.

GitHub OpenAPI

Operations 14

GET /workspaces/access_token Get new Workspace Token #
GET /workspaces/public/{id} Get a Public Workspace #
POST /~/workspaces Create New Workspace #
GET /~/workspaces Get Workspaces #
GET /~/workspaces/templates Get Workspace Templates #
POST /~/workspaces/{id} Update a Workspace #
GET /~/workspaces/{id} Get a Workspace #
DELETE /~/workspaces/{id} Delete a Workspace #
POST /~/workspaces/{id}/comments Create a New Comment #
GET /~/workspaces/{id}/comments Get all Comments #
POST /~/workspaces/{id}/comments/{commentId} Update Existing Comment #
DELETE /~/workspaces/{id}/comments/{commentId} Delete a Comment #
POST /~/workspaces/{id}/policy/acl Add ACL permission #
DELETE /~/workspaces/{id}/policy/acl Delete ACL permission #

Documentation

📖
Documentation
https://www.moesif.com/docs/api
📖
RateLimits
https://artifacts.apis.io/moesif/rate-limits/moesif-rate-limits.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/moesif/openapi/moesif-workspaces-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/moesif/json-schema/moesif-workspace-document-schema.json
📊
JSONSchema
https://artifacts.apis.io/moesif/json-schema/moesif-workspace-create-item-schema.json
📊
JSONSchema
https://artifacts.apis.io/moesif/json-schema/moesif-workspace-update-item-schema.json
📊
JSONSchema
https://artifacts.apis.io/moesif/json-schema/moesif-signed-token-dto-schema.json
📊
JSONSchema
https://artifacts.apis.io/moesif/json-schema/moesif-comment-item-schema.json

Other Resources

🔗
SpectralRules
https://artifacts.apis.io/moesif/rules/moesif-rules.yml
🔗
Plans
https://artifacts.apis.io/moesif/plans/moesif-plans-pricing.yml
🔗
FinOps
https://artifacts.apis.io/moesif/finops/moesif-finops.yml

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/moesif:moesif-workspaces-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

moesif-workspaces-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: Management API to query data in Moesif. You can use the management API to export data for custom reports or to build custom dashboards.
  contact:
  - email: support@moesif.com
  - email: support@moesif.com
  termsOfService: https://www.moesif.com/terms
  version: '1'
  title: Management Workspaces API
servers:
- url: https://api.moesif.com/v1
  description: Management API V1
- url: https://api.moesif.com/v1
  description: Management API V1
consumes:
- application/json
- application/json
produces:
- application/json
- application/json
tags:
- name: Workspaces
paths:
  /workspaces/access_token:
    get:
      security:
      - managementAPIToken:
        - read:workspaces
      description: Get a new Workspace Access Token
      tags:
      - Workspaces
      operationId: getWorkspaceToken
      summary: Get new Workspace Token
      responses:
        '200':
          description: success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SignedTokenDTO'
  /workspaces/public/{id}:
    get:
      security:
      - managementAPIToken:
        - read:public_workspaces
      tags:
      - Workspaces
      operationId: getPublicWorkspace
      parameters:
      - schema:
          type: string
        in: path
        name: id
        required: true
      summary: Get a Public Workspace
      responses:
        '200':
          description: success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceDocument'
  /~/workspaces:
    post:
      security:
      - managementAPIToken:
        - create:workspaces
        - create:public_workspaces
      tags:
      - Workspaces
      operationId: createWorkspace
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkspaceCreateItem'
      parameters:
      - schema:
          type: string
        in: path
        name: orgId
        required: true
      - schema:
          default: '~'
          type: string
        in: query
        name: app_id
        required: false
      - schema:
          type: string
          format: date-time
        in: query
        name: expiration
        required: false
      summary: Create New Workspace
      responses:
        '201':
          description: success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceDocument'
    get:
      security:
      - managementAPIToken:
        - read:workspaces
      tags:
      - Workspaces
      operationId: getWorkspaces
      parameters:
      - schema:
          type: string
        in: path
        name: orgId
        required: true
      - schema:
          default: '~'
          type: string
        in: query
        name: app_id
        required: false
      - schema:
          format: int32
          type: integer
        in: query
        name: take
        required: true
      - schema:
          default: None
          type: string
        in: query
        name: before_id
        required: false
      - schema:
          default: sequence
          type: string
        in: query
        name: '`type`'
        required: false
      - schema:
          type: array
          items:
            type: string
        in: query
        name: access
        required: true
      summary: Get Workspaces
      responses:
        '200':
          description: success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/WorkspaceDocument'
  /~/workspaces/templates:
    get:
      security:
      - managementAPIToken:
        - read:workspaces
      tags:
      - Workspaces
      operationId: getWorkspaceTemplates
      parameters:
      - schema:
          type: string
        in: path
        name: orgId
        required: true
      - schema:
          default: '~'
          type: string
        in: query
        name: app_id
        required: false
      summary: Get Workspace Templates
      responses:
        '200':
          description: success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/WorkspaceDocument'
  /~/workspaces/{id}:
    post:
      body: null
      security:
      - managementAPIToken:
        - update:workspaces
        - update:public_workspaces
      tags:
      - Workspaces
      operationId: updateWorkspace
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkspaceUpdateItem'
      parameters:
      - schema:
          type: string
        in: path
        name: orgId
        required: true
      - schema:
          default: '~'
          type: string
        in: query
        name: app_id
        required: false
      - schema:
          type: string
        in: path
        name: id
        required: true
      summary: Update a Workspace
      responses:
        '200':
          description: success
    get:
      security:
      - managementAPIToken:
        - read:workspaces
      tags:
      - Workspaces
      operationId: getWorkspace
      parameters:
      - schema:
          type: string
        in: path
        name: orgId
        required: true
      - schema:
          default: '~'
          type: string
        in: query
        name: app_id
        required: false
      - schema:
          type: string
        in: path
        name: id
        required: true
      summary: Get a Workspace
      responses:
        '200':
          description: success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceDocument'
    delete:
      security:
      - managementAPIToken:
        - delete:workspaces
      tags:
      - Workspaces
      operationId: deleteWorkspace
      parameters:
      - schema:
          type: string
        in: path
        name: orgId
        required: true
      - schema:
          default: '~'
          type: string
        in: query
        name: app_id
        required: false
      - schema:
          type: string
        in: path
        name: id
        required: true
      summary: Delete a Workspace
      responses:
        '200':
          description: success
  /~/workspaces/{id}/comments:
    post:
      security:
      - managementAPIToken:
        - update:workspaces
      tags:
      - Workspaces
      operationId: createComment
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CommentItem'
      parameters:
      - schema:
          type: string
        in: path
        name: orgId
        required: true
      - schema:
          default: '~'
          type: string
        in: query
        name: app_id
        required: false
      - schema:
          type: string
        in: path
        name: id
        required: true
      summary: Create a New Comment
      responses:
        '201':
          description: success
    get:
      security:
      - managementAPIToken:
        - read:workspaces
      tags:
      - Workspaces
      operationId: getComments
      parameters:
      - schema:
          type: string
        in: path
        name: orgId
        required: true
      - schema:
          default: '~'
          type: string
        in: query
        name: app_id
        required: false
      - schema:
          type: string
        in: path
        name: id
        required: true
      summary: Get all Comments
      responses:
        '200':
          description: success
  /~/workspaces/{id}/comments/{commentId}:
    post:
      security:
      - managementAPIToken:
        - update:workspaces
      tags:
      - Workspaces
      operationId: updateComment
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CommentItem'
      parameters:
      - schema:
          type: string
        in: path
        name: orgId
        required: true
      - schema:
          default: '~'
          type: string
        in: query
        name: app_id
        required: false
      - schema:
          type: string
        in: path
        name: id
        required: true
      - schema:
          type: string
        in: path
        name: commentId
        required: true
      summary: Update Existing Comment
      responses:
        '201':
          description: success
    delete:
      security:
      - managementAPIToken:
        - update:workspaces
      tags:
      - Workspaces
      operationId: deleteComment
      parameters:
      - schema:
          type: string
        in: path
        name: orgId
        required: true
      - schema:
          default: '~'
          type: string
        in: query
        name: app_id
        required: false
      - schema:
          type: string
        in: path
        name: id
        required: true
      - schema:
          type: string
        in: path
        name: commentId
        required: true
      summary: Delete a Comment
      responses:
        '204':
          description: success
  /~/workspaces/{id}/policy/acl:
    post:
      security:
      - managementAPIToken:
        - create:workspaces
      tags:
      - Workspaces
      operationId: addACLPermissions
      parameters:
      - schema:
          type: string
        in: path
        name: orgId
        required: true
      - schema:
          default: '~'
          type: string
        in: query
        name: app_id
        required: false
      - schema:
          type: string
        in: path
        name: id
        required: true
      - schema:
          type: string
        in: query
        name: grantee
        required: false
      - schema:
          default: None
          type: string
        in: query
        name: permission
        required: false
      summary: Add ACL permission
      responses:
        '200':
          description: success
    delete:
      security:
      - managementAPIToken:
        - delete:workspaces
      tags:
      - Workspaces
      operationId: deleteACLPermissions
      parameters:
      - schema:
          type: string
        in: path
        name: orgId
        required: true
      - schema:
          default: '~'
          type: string
        in: query
        name: app_id
        required: false
      - schema:
          type: string
        in: path
        name: id
        required: true
      - schema:
          type: string
        in: query
        name: grantee
        required: true
      summary: Delete ACL permission
      responses:
        '200':
          description: success
components:
  schemas:
    KeyValuePair:
      properties:
        key:
          type: string
        val:
          type: string
      required:
      - key
      - val
    PolicyItem:
      properties:
        acl:
          type: array
          items:
            $ref: '#/components/schemas/ACLItem'
        resource:
          type: object
        api_scopes:
          type: array
          items:
            type: string
        original_encoded_resource:
          type: string
      required:
      - acl
      - resource
    WorkspaceCreateItem:
      properties:
        name:
          type: string
        is_default:
          type: boolean
        view_count:
          type: integer
          format: int32
        dashboard:
          type: object
        colors:
          type: object
        drawings:
          type: array
          items:
            $ref: '#/components/schemas/DrawingItem'
        chart:
          $ref: '#/components/schemas/ChartItem'
        template:
          $ref: '#/components/schemas/TemplateItem'
        type:
          type: string
        width:
          type: number
          format: double
        sort_order:
          type: number
          format: double
        policy:
          $ref: '#/components/schemas/PolicyItem'
      required:
      - name
      - policy
      - chart
    WorkspaceDocument:
      properties:
        name:
          type: string
        is_default:
          type: boolean
        view_count:
          type: integer
          format: int32
        _id:
          type: string
        is_template:
          type: boolean
        dashboard:
          type: object
        auth_user_id:
          type: string
        colors:
          type: object
        sequence:
          type: array
          items:
            $ref: '#/components/schemas/SequenceItem'
        drawings:
          type: array
          items:
            $ref: '#/components/schemas/DrawingItem'
        chart:
          $ref: '#/components/schemas/ChartItem'
        template:
          $ref: '#/components/schemas/TemplateItem'
        app_id:
          type: string
        type:
          type: string
        width:
          type: number
          format: double
        sort_order:
          type: number
          format: double
        policy:
          $ref: '#/components/schemas/PolicyItem'
        org_id:
          type: string
        migration:
          type: object
        created:
          type: string
          format: date-time
        comments:
          $ref: '#/components/schemas/Comments'
      required:
      - auth_user_id
      - org_id
      - app_id
      - created
      - view_count
    ChartItem:
      properties:
        original_encoded_view_elements:
          type: string
        funnel_query:
          type: object
        url_query:
          type: string
        to:
          type: string
        view_elements:
          type: object
        from:
          type: string
        original_encoded_funnel_query:
          type: string
        es_query:
          type: object
        args:
          type: string
        original_encoded_query:
          type: string
        time_zone:
          type: string
        view:
          type: string
      required:
      - view
      - url_query
    DrawingItem:
      properties:
        name:
          type: string
        direction:
          type: string
        id:
          type: string
        type:
          type: string
        value:
          type: number
          format: double
      required:
      - id
      - name
      - type
      - value
      - direction
    TemplateItem:
      properties:
        dynamic_fields:
          type: array
          items:
            type: string
        dynamic_time:
          type: boolean
      required:
      - dynamic_fields
    ACLItem:
      properties:
        grantee:
          type: string
        permission:
          type: string
      required:
      - grantee
      - permission
    CommentItem:
      properties:
        message:
          type: string
        mentions:
          type: array
          items:
            type: string
    SignedTokenDTO:
      properties:
        _id:
          type: string
        token:
          type: string
        url:
          type: string
      required:
      - _id
      - token
    CreateCommentItem:
      properties:
        auth_user_id:
          type: string
        comment_id:
          type: string
        mentions:
          type: array
          items:
            type: string
        partner_user_id:
          type: string
        message:
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    SubmitData:
      properties:
        body:
          type: object
        url:
          type: string
        params:
          type: array
          items:
            $ref: '#/components/schemas/KeyValuePair'
        verb:
          type: string
        headers:
          type: array
          items:
            $ref: '#/components/schemas/KeyValuePair'
      required:
      - url
      - verb
    Summary:
      properties:
        count:
          type: integer
          format: int32
        latest_comment:
          $ref: '#/components/schemas/CreateCommentItem'
      required:
      - count
    SequenceItem:
      properties:
        delay:
          type: integer
          format: int32
        submit_data:
          $ref: '#/components/schemas/SubmitData'
      required:
      - delay
      - submit_data
    Comments:
      properties:
        summary:
          $ref: '#/components/schemas/Summary'
      required:
      - summary
    WorkspaceUpdateItem:
      properties:
        name:
          type: string
        colors:
          type: object
        drawings:
          type: array
          items:
            $ref: '#/components/schemas/DrawingItem'
        chart:
          $ref: '#/components/schemas/ChartItem'
        template:
          $ref: '#/components/schemas/TemplateItem'
        width:
          type: number
          format: double
        sort_order:
          type: number
          format: double
        policy:
          $ref: '#/components/schemas/PolicyItem'
  securitySchemes:
    managementAPIToken:
      type: oauth2
      description: "Your Management API token must be added to the request _Authorization_ header using the following format:\n\n `Authorization: Bearer YOUR_MANAGEMENT_API_KEY`"
      flows:
        password:
          tokenUrl: https://api.moesif.com/v1/:orgId/oauth/access_tokens
          scopes:
            create:encrypted_keys: Create encrypted Keys for the Moesif secure proxy
            delete:dashboards: Delete existing dashboards
            update:dashboards: Update existing dashboards
            create:dashboards: Create a new team dashboard that can be shared
            read:public_workspaces: Read public workspaces/shared links
            read:virtual_eventtypes: Read existing virtual events/tags
            update:companies: Update existing companies and associated company metadata
            create:companies: Create new companies and associated company metadata
            create:reports: Create a new report such as SmartDiff
            delete:workspaces: Delete existing workspaces
            create:workspaces: Create a new workspace/chart that can be shared
            read:workspaces: Read existing workspaces
            update:virtual_eventtypes: Update existing virtual events/tags
            create:cohorts: Save new customer cohorts
            delete:encrypted_keys: Delete encrypted Keys for the Moesif secure proxy
            read:dashboards: Read existing dashboards
            read:events: Read/query events and associated event metadata
            create:events: Create new events and associated event metadata
            read:cohorts: Read previously saved customer cohorts
            read:encrypted_keys: Read encrypted Keys for the Moesif secure proxy
            update:apps: Update an existing application
            update:encrypted_keys: Update encrypted Keys for the Moesif secure proxy
            update:organizations: Update an existing application
            create:access_tokens: Create new tokens to access the Management API or Collector API
            create:users: Create new users and associated user metadata
            create:apps: Create a new application/project under the organization
            update:workspaces: Update existing workspaces
            delete:cohorts: Delete previously saved customer cohorts
            read:users: Read/query users and associated user metadata
            delete:virtual_eventtypes: Delete existing virtual events/tags
            read:reports: Read reports such as SmartDiff
            delete:reports: Delete existing reports such as SmartDiff
            update:users: Update existing users and associated user metadata
            update:cohorts: Update previously saved customer cohorts
            read:companies: Read/query companies and associated company metadata
            create:virtual_eventtypes: Create virtual events/tags
            delete:apps: Delete an existing application
            delete:companies: Delete existing companies and associated company metadata
            read:apps: Read the organization's applications
            create:eth_abi: Create/upload new Ethereum ABI Entries
            delete:users: Delete existing users and associated user metadata
externalDocs:
  description: Developer Docs
  url: https://moesif.com/docs
x-provenance:
  method: harvested
  publisher: Moesif
  source: https://www.moesif.com/docs/api/openapi/management-api.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)