GEgetmaintainx
Subscriptions & Webhooks

Update subscription

Changed on
patch/subscriptions/{id}

Request

  • Base URL
    https://api.getmaintainx.com/v1
  • Auth
    HTTP bearer

Path parameters

idinteger required

ID of the subscription

Query parameters

skipWebhookboolean

Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks

Headers

x-organization-idinteger

Required if using a multi organizations token

Request body

type'API_TOKEN_CREATED' | 'API_TOKEN_REVOKED' | 'ASSET_CHANGE' | 'ASSET_STATUS_CHANGE' | 'CONNECTOR_TOKEN_REVOKED' | 'CUSTOMER_CHANGE' | 'DATA_EXPORT_INITIATED' | 'INVITE_LINK_ARCHIVED' | 'INVITE_LINK_CREATED' | 'INVITE_LINK_UPDATED' | 'LOCATION_CHANGE' | 'METER_TRIGGER_STATE_CHANGE' | 'NEW_ASSET' | 'NEW_CATEGORY_ON_WORK_ORDER' | 'NEW_COMMENT_ON_WORK_ORDER' | 'NEW_CUSTOMER' | 'NEW_LOCATION' | 'NEW_PART' | 'NEW_PURCHASE_ORDER' | 'NEW_SLASH_COMMAND' | 'NEW_VENDOR' | 'NEW_WORK_ORDER' | 'NEW_WORK_REQUEST' | 'PART_CHANGE' | 'PART_DELETE' | 'PART_QUANTITY_CHANGE' | 'PART_TRANSFER' | 'PURCHASE_ORDER_CHANGE' | 'PURCHASE_ORDER_STATUS_CHANGE' | 'ROLE_ARCHIVED' | 'ROLE_CREATED' | 'ROLE_UPDATED' | 'SSO_CONFIG_CHANGED' | 'USER_ACTIVATED' | 'USER_INVITED' | 'USER_LOGIN_FAILURE' | 'USER_LOGIN_SUCCESS' | 'USER_LOGOUT' | 'USER_PERMISSIONS_CHANGED' | 'USER_REMOVED' | 'USER_ROLE_CHANGED' | 'USER_SESSION_REVOKED' | 'WEBHOOK_ARCHIVED' | 'WEBHOOK_CREATED' | 'WORK_ORDER_CHANGE' | 'WORK_ORDER_DELETE' | 'WORK_ORDER_OVERDUE' | 'WORK_ORDER_PART_STATUS_CHANGE' | 'WORK_ORDER_STATUS_CHANGE' | 'WORK_REQUEST_STATUS_CHANGE'

Type of event subscribed to

urlstring

Example request

{
  "type": "API_TOKEN_CREATED",
  "url": "https://example.com"
}

Response

Successfully edited subscription

Example response

{
  "subscription": {
    "id": 963,
    "type": "API_TOKEN_CREATED",
    "url": "https://example.com"
  }
}

Changes

  • 530b6f7c74b4Revision changes
    • warning

      added the new ASSET_CHANGE enum value to the / response property for the response status

    • info

      added the new ASSET_CHANGE enum value to the request property

  • 8ad1c4416fb8Revision changes
    • warning

      added the new LOCATION_CHANGE enum value to the / response property for the response status

    • info

      added the new LOCATION_CHANGE enum value to the request property