LogoLogo
What's new?StatusMSquared
  • Morpheus Platform Documentation
  • What is Morpheus Platform?
    • Glossary
    • Interoperability
    • Support
    • EULA
  • Firewall Problems
  • CREATION
    • Unreal Development
      • Get Started
        • Download the Editor
        • Upload Content
        • Creating your Own Map
        • Morpheus Base Project
        • Differences from Unreal
          • Character Configuration
        • Morpheus Networking
          • Introduction to Morpheus Networking
          • Network Levels
          • Replicated Properties
          • RPCs
          • Morpheus Render Targets
          • Morpheus Array
          • Networking FAQ
          • Replicating Sublevels
      • Editor Versions
      • Performance Guarantees
      • Features & Guides
        • Example Plugin
          • Nameplates
          • In-Game Roles
          • Resizing
        • Actor Pooling
        • Audio
        • Avatars
          • Creating an Avatar
          • Attachments
            • MML Attachments
          • Custom Animation Variables
          • Importing an NFT Collection
          • Capsules and Mesh Transforms
        • Bots
        • Chat
          • Unreal Text Chat
        • Control Panels
          • Control Panel Configuration
          • DJ Booth Mission Control
          • Observer Controls
        • Crowd Audio
        • Crowd Rendering
          • Legacy Animated Crowd
            • Animated Crowd Console Commands
            • Attaching static meshes to crowd members
          • Crowd Materials
          • Performance Parameters
          • Live Config Settings
          • Crowd Animation
            • Crowd Anim Blueprint
              • User Guide - Crowd Anim Blueprint
              • Reference Guide - ABP Nodes
                • Animation Playback
                • States and State Machines
                • Variables
                • Transitions
                • Special
                • Blends
                • Additional Notes
        • Helpers & Extras
          • "Instanced Objects" in Blueprints
          • Objects with "world context"
          • Making DataAsset classes
          • Duplicate Objects
          • The Bootflow Subsystem
          • The "Wait For Condition" System
          • Advanced Graphics Settings
          • Listening to Inputs on UObjects
          • Morpheus UserID
          • World Services
          • M2Extras: Skins System
        • Loading Screen
        • Live Config
          • Editing for a World
          • Editing Locally
          • Default Settings
          • Accessing via Blueprint
          • Adding New Settings
          • Overriding Defaults
          • Using Arrays
        • MML
        • Motion Capture
        • Networking
        • Notifications
        • Raycastable Crowd
        • Singletons
        • Streaming & Multiplatform
          • GFN on Mobile
        • UI
          • "UI Mode"
        • User Collections
          • Creating a New Object Definition
          • Accessing from Unreal
            • Creating Objects Definitions
            • Transfer Objects
            • User Collection Views
            • Receiving Updates
        • Video Players
          • Embedded Video Player
          • Millicast video streaming
            • How to Setup an In-Game Video Stream
            • Picture-in-Picture mode
          • Streaming Video Player
            • How to Setup a URL Video Player
            • Picture-in-Picture mode
        • Visual Debugging
          • Inspector
        • Web UI
        • Online Services
          • KV Store Service
        • Web Requests
          • Http Requests
            • Legacy HTTP Nodes
          • JSON Handling
          • WebSockets
          • Identity Validation
          • Allowed External URLs
          • Walkthrough Example
            • Example Counter Service
        • World Travel
          • World Travel in the Editor
        • Avatar Physics Assets
        • Action Gameplay Helper Components
      • Workflows
        • Upgrade the Editor
        • Editing Project Settings
        • Profiling
        • Marketplace Importing
        • Extra Workflows
          • Setup Play-in-Editor
          • Setup Local Asset Validation
          • Adding Gameplay Tags
          • Validating Game Assets
          • Custom Connection Modes
          • Connect Editor to a World
          • Common Issues
      • Best Practices
    • Worlds
      • Invite Players
        • Setting Role Groups
      • Persistent Worlds
      • Always on Worlds
    • Running Events
      • Large Scale Events - Checklist
      • Anti-Cheat (EAC)
      • Player Entry
        • React Native
        • Steam
        • Hardware Requirements
      • Broadcast
        • OBS Integration
      • Failover
      • Capacity and Queue Management
  • ADMINS
    • Access Control
      • Add Metaverse Contributors
      • Create a New Project
    • Pricing
      • Development Support
      • Included Usage & Overages
      • Cloud Streaming
      • Access Modes
      • War Room Support
      • Platform SLA
    • Settings
      • Projects
  • APIs and Tooling
    • API Reference
      • Accounts
      • Events
      • Key/Value Store
      • Organizations
      • Realtime
      • User Profile
      • World Builder
      • Worlds
    • Template Web App
      • Moderation
    • Pixel Streaming
    • Launcher
  • Integrations
    • Analytics
      • Send Events from Web
      • Send Events from Unreal
    • Chat
      • Integrate Pubnub with your Unreal Project
      • Add Moderation to Chat
Powered by GitBook
On this page

Was this helpful?

  1. APIs and Tooling
  2. API Reference

Organizations

Manage your organization's configuration, including associated resources such as Projects. This service helps structure how different teams and services operate within your SaaS environment.

PreviousKey/Value StoreNextRealtime

Last updated 13 hours ago

Was this helpful?

Get api keys

get

Retrieves the api keys of an organization.

Authorizations
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

Responses
200
Response body for listing all API keys
application/json
get
GET /api/organizations/apiKeys/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
Accept: */*
200

Response body for listing all API keys

[
  {
    "documentId": "text",
    "displayName": "text",
    "isActive": true,
    "isManagedByTerraform": true,
    "organizationId": "text",
    "claims": {
      "ANY_ADDITIONAL_PROPERTY": true
    },
    "permissions": [
      "text"
    ],
    "keyString": "text"
  }
]

Delete api key

delete

Deletes an existing api key for an organization.

Authorizations
Path parameters
apiKeyIdstringRequired
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

Responses
204
Default Response
application/json
Responseany
delete
DELETE /api/organizations/apiKeys/{apiKeyId}/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
Accept: */*
204

Default Response

No content

Get organization detail

get

Fetches the details of a specific organization by its organizationId. If the organization exists, the data is returned.

Header parameters
x-m2-organization-idstringRequired

The ID of an organization

Responses
200
The details for an organization
application/json
get
GET /api/organizations/current/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-m2-organization-id: text
Accept: */*
200

The details for an organization

{
  "name": "text",
  "tenantId": "text",
  "pictureUrl": "text",
  "featuredEventId": "text",
  "websiteInfo": {
    "title": "text",
    "headTags": [
      "text"
    ]
  },
  "features": {
    "loginPanelDisclaimer": "text",
    "profilePictureUpload": true,
    "hasProfilePage": true,
    "hasCollectionsPage": true,
    "hasNavigationMenu": true,
    "allowPublicReadableChat": true,
    "loginOptions": {
      "hasEmail": true,
      "hasMetaMask": true,
      "hasWalletConnect": true,
      "hasCoinbaseWallet": true,
      "hasGoogle": true
    },
    "allowUserTokenManagement": true,
    "pubnub": {
      "publishKey": "text",
      "subscribeKey": "text",
      "defaultChannels": [
        {
          "read": true,
          "write": true,
          "type": "party"
        }
      ]
    },
    "usernameCustomization": {
      "unique": true,
      "pattern": "text"
    },
    "iosNativeClientSupport": true,
    "useSignedContentDownloads": true
  },
  "legalPolicies": {
    "termsOfService": [
      "text"
    ],
    "privacyPolicy": [
      "text"
    ],
    "chatRules": [
      "text"
    ],
    "nvidiaPrivacyPolicy": [
      "text"
    ],
    "eula": [
      "text"
    ]
  },
  "hasEventEnabled": true,
  "organizationId": "text",
  "supportedProviders": {
    "google": true,
    "twitter": true,
    "twitch": true,
    "otherside": true
  }
}

Delete organization

delete

Deletes organization and its related resources. It requires the user to have full permissions (:) to perform the deletion.

Authorizations
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

Responses
200
Default Response
delete
DELETE /api/organizations/current/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
Accept: */*
200

Default Response

No content

Updates picture URL of organization

patch

Updates the picture URL for an organization. A file is uploaded, transformed, and stored in Cloud Storage, with the resulting URL saved in the organization's record.

Authorizations
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

Responses
200
The shape of an organization
application/json
patch
PATCH /api/organizations/current/pictureUrl/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
Accept: */*
200

The shape of an organization

{
  "documentId": "text",
  "name": "text",
  "tenantId": "text",
  "pictureUrl": "text",
  "featuredEventId": "text",
  "websiteInfo": {
    "title": "text",
    "headTags": [
      "text"
    ]
  },
  "features": {
    "loginPanelDisclaimer": "text",
    "profilePictureUpload": true,
    "hasProfilePage": true,
    "hasCollectionsPage": true,
    "hasNavigationMenu": true,
    "allowPublicReadableChat": true,
    "loginOptions": {
      "hasEmail": true,
      "hasMetaMask": true,
      "hasWalletConnect": true,
      "hasCoinbaseWallet": true,
      "hasGoogle": true
    },
    "allowUserTokenManagement": true,
    "pubnub": {
      "publishKey": "text",
      "subscribeKey": "text",
      "defaultChannels": [
        {
          "read": true,
          "write": true,
          "type": "party"
        }
      ]
    },
    "usernameCustomization": {
      "unique": true,
      "pattern": "text"
    },
    "iosNativeClientSupport": true,
    "useSignedContentDownloads": true
  },
  "legalPolicies": {
    "termsOfService": [
      "text"
    ],
    "privacyPolicy": [
      "text"
    ],
    "chatRules": [
      "text"
    ],
    "nvidiaPrivacyPolicy": [
      "text"
    ],
    "eula": [
      "text"
    ]
  },
  "hasEventEnabled": true
}

Returns the projects of organization

get

Retrieves all the projects associated with a specific organization, returning the list of projects the user has access to based on their permissions.

Authorizations
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

Responses
200
The data of all the projects in an organization
application/json
get
GET /api/organizations/projects/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
Accept: */*
200

The data of all the projects in an organization

[
  {
    "documentId": "text",
    "name": "text",
    "projectId": "text",
    "permissionVerb": "*"
  }
]

Get project details

get

Retrieves details of a specific project within an organization. Access is controlled by read permissions on the project.

Authorizations
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

x-m2-project-idstringRequired

The ID of a project

Responses
200
The details for a project
application/json
get
GET /api/organizations/projects/current/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
x-m2-project-id: text
Accept: */*
200

The details for a project

{
  "documentId": "text",
  "name": "text",
  "permissionVerb": "*"
}

Delete project

delete

Deletes a project and its associated resources. Requires write permissions for the project and its children.

Authorizations
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

x-m2-project-idstringRequired

The ID of a project

Responses
200
Default Response
delete
DELETE /api/organizations/projects/current/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
x-m2-project-id: text
Accept: */*
200

Default Response

No content

Returns the details of a webhook endpoint

get
Authorizations
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

Responses
200
The details for all webhook endpoints
application/json
get
GET /api/organizations/webhooks/endpoints/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
Accept: */*
200

The details for all webhook endpoints

[
  {
    "id": "text",
    "description": "text",
    "url": "text",
    "disabled": true,
    "rateLimit": 1,
    "createdAt": "2025-06-06T04:31:15.880Z",
    "updatedAt": "2025-06-06T04:31:15.880Z",
    "eventFilters": [
      "guest_link.consumed"
    ]
  }
]

Delete a webhook endpoint

delete
Authorizations
Path parameters
endpointIdstringRequired
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

Responses
204
Default Response
application/json
Responseany
delete
DELETE /api/organizations/webhooks/endpoints/{endpointId}/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
Accept: */*
204

Default Response

No content

Returns the details of a webhook endpoint

get
Authorizations
Path parameters
endpointIdstringRequired
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

Responses
200
The details for a webhook endpoint
application/json
get
GET /api/organizations/webhooks/endpoints/{endpointId}/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
Accept: */*
200

The details for a webhook endpoint

{
  "id": "text",
  "description": "text",
  "url": "text",
  "disabled": true,
  "rateLimit": 1,
  "createdAt": "2025-06-06T04:31:15.880Z",
  "updatedAt": "2025-06-06T04:31:15.880Z",
  "eventFilters": [
    "guest_link.consumed"
  ]
}
  • GETReturns the details of an organization
  • POSTCreate organization
  • GETGet api keys
  • POSTPost api key
  • PATCHPatch api key
  • DELETEDelete api key
  • GETGet organization detail
  • PATCHUpdate organization
  • DELETEDelete organization
  • PATCHUpdates picture URL of organization
  • GETReturns the projects of organization
  • POSTCreate project
  • GETGet project details
  • PATCHUpdate project
  • DELETEDelete project
  • GETReturns the details of a webhook endpoint
  • POSTCreate a new webhook endpoint
  • DELETEDelete a webhook endpoint
  • GETReturns the details of a webhook endpoint
  • PUTUpdate a webhook endpoint

Returns the details of an organization

get
Authorizations
Responses
200
The details for all organizations
application/json
get
GET /api/organizations/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
Accept: */*
200

The details for all organizations

[
  {
    "documentId": "text",
    "name": "text",
    "tenantId": "text",
    "pictureUrl": "text",
    "featuredEventId": "text",
    "websiteInfo": {
      "title": "text",
      "headTags": [
        "text"
      ]
    },
    "features": {
      "loginPanelDisclaimer": "text",
      "profilePictureUpload": true,
      "hasProfilePage": true,
      "hasCollectionsPage": true,
      "hasNavigationMenu": true,
      "allowPublicReadableChat": true,
      "loginOptions": {
        "hasEmail": true,
        "hasMetaMask": true,
        "hasWalletConnect": true,
        "hasCoinbaseWallet": true,
        "hasGoogle": true
      },
      "allowUserTokenManagement": true,
      "pubnub": {
        "publishKey": "text",
        "subscribeKey": "text",
        "defaultChannels": [
          {
            "read": true,
            "write": true,
            "type": "party"
          }
        ]
      },
      "usernameCustomization": {
        "unique": true,
        "pattern": "text"
      },
      "iosNativeClientSupport": true,
      "useSignedContentDownloads": true
    },
    "legalPolicies": {
      "termsOfService": [
        "text"
      ],
      "privacyPolicy": [
        "text"
      ],
      "chatRules": [
        "text"
      ],
      "nvidiaPrivacyPolicy": [
        "text"
      ],
      "eula": [
        "text"
      ]
    },
    "hasEventEnabled": true,
    "permissionVerb": "*",
    "isSlot": true
  }
]

Create organization

post

Creates a new organization.

Authorizations
Body

The data to create an organization

tenantIdstringOptional
featuredEventIdstringOptional
hasEventEnabledbooleanOptional
namestring · min: 1 · max: 64Required

The name of an organization

Responses
200
The details of the created organization
application/json
post
POST /api/organizations/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 829

{
  "tenantId": "text",
  "featuredEventId": "text",
  "websiteInfo": {
    "title": "text",
    "headTags": [
      "text"
    ]
  },
  "features": {
    "loginPanelDisclaimer": "text",
    "profilePictureUpload": true,
    "hasProfilePage": true,
    "hasCollectionsPage": true,
    "hasNavigationMenu": true,
    "allowPublicReadableChat": true,
    "loginOptions": {
      "hasEmail": true,
      "hasMetaMask": true,
      "hasWalletConnect": true,
      "hasCoinbaseWallet": true,
      "hasGoogle": true
    },
    "allowUserTokenManagement": true,
    "pubnub": {
      "publishKey": "text",
      "subscribeKey": "text",
      "defaultChannels": [
        {
          "read": true,
          "write": true,
          "type": "party"
        }
      ]
    },
    "usernameCustomization": {
      "unique": true,
      "pattern": "text"
    },
    "iosNativeClientSupport": true,
    "useSignedContentDownloads": true
  },
  "legalPolicies": {
    "termsOfService": [
      "text"
    ],
    "privacyPolicy": [
      "text"
    ],
    "chatRules": [
      "text"
    ],
    "nvidiaPrivacyPolicy": [
      "text"
    ],
    "eula": [
      "text"
    ]
  },
  "hasEventEnabled": true,
  "name": "text"
}
200

The details of the created organization

{
  "organizationId": "text",
  "tenantId": "text",
  "features": {
    "loginPanelDisclaimer": "text",
    "profilePictureUpload": true,
    "hasProfilePage": true,
    "hasCollectionsPage": true,
    "hasNavigationMenu": true,
    "allowPublicReadableChat": true,
    "loginOptions": {
      "hasEmail": true,
      "hasMetaMask": true,
      "hasWalletConnect": true,
      "hasCoinbaseWallet": true,
      "hasGoogle": true
    },
    "allowUserTokenManagement": true,
    "pubnub": {
      "publishKey": "text",
      "subscribeKey": "text",
      "defaultChannels": [
        {
          "read": true,
          "write": true,
          "type": "party"
        }
      ]
    },
    "usernameCustomization": {
      "unique": true,
      "pattern": "text"
    },
    "iosNativeClientSupport": true,
    "useSignedContentDownloads": true
  }
}

Post api key

post

Creates a new api key for an organization.

Authorizations
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

Body

Request body for creating a new API key

displayNamestringRequired
isActivebooleanRequired
permissionsstring[] · min: 1Required
Responses
200
Response body for creating a new API key
application/json
post
POST /api/organizations/apiKeys/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
Content-Type: application/json
Accept: */*
Content-Length: 103

{
  "displayName": "text",
  "claims": {
    "ANY_ADDITIONAL_PROPERTY": true
  },
  "isActive": true,
  "permissions": [
    "text"
  ]
}
200

Response body for creating a new API key

{
  "apiKey": "text"
}

Patch api key

patch

Updates an existing api key for an organization.

Authorizations
Path parameters
apiKeyIdstringRequired
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

Body

Request body for updating an existing API key

displayNamestringOptional
permissionsstring[] · min: 1Optional
isActivebooleanOptional
Responses
200
Response body for updating an existing API key
application/json
patch
PATCH /api/organizations/apiKeys/{apiKeyId}/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
Content-Type: application/json
Accept: */*
Content-Length: 103

{
  "displayName": "text",
  "claims": {
    "ANY_ADDITIONAL_PROPERTY": true
  },
  "permissions": [
    "text"
  ],
  "isActive": true
}
200

Response body for updating an existing API key

{
  "documentId": "text",
  "displayName": "text",
  "isActive": true,
  "isManagedByTerraform": true,
  "organizationId": "text",
  "claims": {
    "ANY_ADDITIONAL_PROPERTY": true
  },
  "permissions": [
    "text"
  ],
  "keyString": "text"
}

Update organization

patch

Allows updating specific fields (like name or featured event) for an organization. It checks for write permissions before processing the request.

Authorizations
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

Body

The data to update an organization

namestring · min: 1 · max: 64Optional

The name of an organization

featuredEventIdstringOptional
Responses
200
Default Response
patch
PATCH /api/organizations/current/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
Content-Type: application/json
Accept: */*
Content-Length: 600

{
  "name": "text",
  "featuredEventId": "text",
  "features": {
    "loginPanelDisclaimer": "text",
    "profilePictureUpload": true,
    "hasProfilePage": true,
    "hasCollectionsPage": true,
    "hasNavigationMenu": true,
    "allowPublicReadableChat": true,
    "loginOptions": {
      "hasEmail": true,
      "hasMetaMask": true,
      "hasWalletConnect": true,
      "hasCoinbaseWallet": true,
      "hasGoogle": true
    },
    "allowUserTokenManagement": true,
    "pubnub": {
      "publishKey": "text",
      "subscribeKey": "text",
      "defaultChannels": [
        {
          "read": true,
          "write": true,
          "type": "party"
        }
      ]
    },
    "usernameCustomization": {
      "unique": true,
      "pattern": "text"
    },
    "iosNativeClientSupport": true,
    "useSignedContentDownloads": true
  }
}
200

Default Response

No content

Create project

post

Allows creating a new project within an organization. The user must have write permissions to the organization to successfully create the project.

Authorizations
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

Body

The data to create a project

namestring · min: 1 · max: 64Required

The name of the project

Responses
200
The details of the created project
application/json
post
POST /api/organizations/projects/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "name": "text"
}
200

The details of the created project

{
  "projectId": "text"
}

Update project

patch

Updates a project’s attributes, such as the project name. The user needs write permissions on the project to make changes.

Authorizations
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

x-m2-project-idstringRequired

The ID of a project

Body

The data to update a project

documentIdstringOptional
namestring · min: 1 · max: 64Optional

The name of the project

Responses
200
The details of the updated project
application/json
patch
PATCH /api/organizations/projects/current/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
x-m2-project-id: text
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "documentId": "text",
  "name": "text"
}
200

The details of the updated project

{
  "documentId": "text",
  "name": "text"
}

Create a new webhook endpoint

post
Authorizations
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

Body

The data to create a webhook endpoint

descriptionstringRequired

The description of the webhook endpoint

urlstringRequired

The URL of the webhook endpoint

disabledbooleanOptional

Whether the webhook endpoint is disabled

rateLimitnumberOptional

The rate limit for the webhook endpoint

Responses
200
The details of the created webhook endpoint
application/json
post
POST /api/organizations/webhooks/endpoints/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
Content-Type: application/json
Accept: */*
Content-Length: 104

{
  "description": "text",
  "url": "text",
  "disabled": true,
  "rateLimit": 1,
  "eventFilters": [
    "guest_link.consumed"
  ]
}
200

The details of the created webhook endpoint

{
  "id": "text",
  "description": "text",
  "url": "text",
  "disabled": true,
  "rateLimit": 1,
  "createdAt": "2025-06-06T04:31:15.880Z",
  "updatedAt": "2025-06-06T04:31:15.880Z",
  "eventFilters": [
    "guest_link.consumed"
  ]
}

Update a webhook endpoint

put
Authorizations
Path parameters
endpointIdstringRequired
Header parameters
x-m2-organization-idstringRequired

The ID of an organization

Body

The data to update a webhook endpoint

descriptionstringRequired

The description of the webhook endpoint

urlstringRequired

The URL of the webhook endpoint

disabledbooleanOptional

Whether the webhook endpoint is disabled

rateLimitnumberOptional

The rate limit for the webhook endpoint

Responses
200
The details of the updated webhook endpoint
application/json
put
PUT /api/organizations/webhooks/endpoints/{endpointId}/ HTTP/1.1
Host: your-organization-id.m2worlds.io
x-api-key: YOUR_API_KEY
x-m2-organization-id: text
Content-Type: application/json
Accept: */*
Content-Length: 104

{
  "description": "text",
  "url": "text",
  "disabled": true,
  "rateLimit": 1,
  "eventFilters": [
    "guest_link.consumed"
  ]
}
200

The details of the updated webhook endpoint

{
  "id": "text",
  "description": "text",
  "url": "text",
  "disabled": true,
  "rateLimit": 1,
  "createdAt": "2025-06-06T04:31:15.880Z",
  "updatedAt": "2025-06-06T04:31:15.880Z",
  "eventFilters": [
    "guest_link.consumed"
  ]
}