v30

latestOpenAPI 3.0.0raw.githubusercontent.com2026-04-22116135580.0 KB

Subscriptions

Objects

Delete subscriptions

Delete subscriptions for the specified recipients from an object. Returns the list of deleted subscriptions.

delete/v1/objects/{collection}/{object_id}/subscriptions

Path parameters

object_idstring required

Unique identifier for the object.

collectionstring required

The collection this object belongs to.

Request body

Example request

{
  "recipients": [
    "user_123"
  ]
}

Response

__typenamestring required

The typename of the schema.

inserted_atstring date-time required

Timestamp when the resource was created.

propertiesobject nullable

The custom properties associated with the subscription relationship.

updated_atstring date-time required

The timestamp when the resource was last updated.

Example response

[
  {
    "__typename": "Subscription",
    "inserted_at": "2021-01-01T00:00:00Z",
    "object": {
      "__typename": "Object",
      "collection": "assets",
      "created_at": null,
      "id": "specimen_25",
      "properties": {
        "classification": "Theropod",
        "config": {
          "biz": "baz",
          "foo": "bar"
        },
        "name": "Velociraptor",
        "status": "contained"
      },
      "updated_at": "2024-05-22T12:00:00Z"
    },
    "recipient": {
      "__typename": "User",
      "avatar": null,
      "created_at": null,
      "email": "jane@ingen.net",
      "id": "jane",
      "name": "Jane Doe",
      "phone_number": null,
      "timezone": null,
      "updated_at": "2024-05-22T12:00:00Z"
    },
    "updated_at": "2021-01-01T00:00:00Z"
  }
]