v30

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

Subscriptions

Objects

Add subscriptions

Add subscriptions for an object. If a subscription already exists, it will be updated. This endpoint also handles inline identifications for the recipient.

post/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

propertiesobject nullable

The custom properties associated with the subscription relationship.

Example request

{
  "properties": {
    "key": "value"
  },
  "recipients": [
    "user_1",
    "user_2"
  ]
}

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"
  }
]