Notification

OpenAPI Schema

The following schema is based on OpenAPI 3.0 and is provided in our downloadable OpenAPI document.

{
  "properties": {
    "attributes": {
      "deprecated": true,
      "description": "Attributes are key-value pairs of data related to the notification.\n\n_**WARNING!** This is a free-form bag of unstructured data. The properties\nand values should not be relied upon by implementations; they are subject\nto change._",
      "nullable": true,
      "readOnly": true,
      "type": "object"
    },
    "created": {
      "$ref": "#/components/schemas/Signature/properties/created"
    },
    "descriptor": {
      "description": "The value of the descriptor varies among notification types. In general,\nthe descriptor may be used as a label for the entity described in the\nnotification. For orders and invoices, the descriptor is often the total\ncurrency amount related to the notification. For contracts and events, the\ndescriptor is the name of the contract or event.",
      "readOnly": true,
      "type": "string"
    },
    "dismissed": {
      "description": "If the notification is dismissed, this will be `true`. Otherwise, it will\nbe `false`. Set `dismissed` to `true` to dismiss the notification.",
      "type": "boolean"
    },
    "id": {
      "$ref": "#/components/schemas/Id"
    },
    "links": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Links"
        },
        {
          "readOnly": true
        }
      ]
    },
    "message": {
      "description": "The message may be used as the notification text. For example, if the\n`notificationType` is `order-placed`, the `message` might be “Jane Doe\nplaced a new order.”",
      "readOnly": true,
      "type": "string"
    },
    "notificationGroup": {
      "description": "The notification group refers to the type of entity this notification\nrelates to. For example, if the `notificationType` is `event-photo-favorited-by-event-contact`,\nthe `notificationGroup` will be `event` since the notification is related\nto an event.",
      "enum": [
        "contract",
        "event",
        "invoice",
        "order",
        "studio"
      ],
      "readOnly": true,
      "type": "string"
    },
    "notificationType": {
      "description": "A string identifier to indicate the type of notification described\nby this entity. This identifier may be one of the following strings\n\n| ShootProof Identifier | Description |\n| --------------------- | ----------- |\n| `contract-canceled` | The contract indicated by the `contract` link relation has been canceled. |\n| `contract-signed-by-client` | The contract indicated by the `contract` link relation was signed by the client. |\n| `event-photo-downloaded-by-event-contact` | The contact indicated by the `contact` link relation download a photo for the event indicated by the `event` link relation. |\n| `event-photo-favorited-by-event-contact` | The contact indicated by the `contact` link relation favorited a photo for the event indicated by the `event` link relation. |\n| `event-photo-hidden-by-event-contact` | The contact indicated by the `contact` link relation marked a photo as “hidden” for the event indicated by the `event` link relation. |\n| `event-photo-tagged-by-event-contact` | The contact indicated by the `contact` link relation tagged a photo for the event indicated by the `event` link relation. |\n| `invoice-past-due` | The invoice indicated by the `invoice` link relation is past due. |\n| `invoice-payment-received` | The brand received a payment for the invoice indicated by the `invoice` link relation. |\n| `order-approval-prolonged` | The order indicated by the `order` link relation has been awaiting approval for a long period of time.  |\n| `order-needs-approval` | The order indicated by the `order` link relation is awaiting approval. |\n| `order-placed` | The order indicated by the `order` link relation was just placed. |\n| `order-shipped-from-lab` | The order indicated by the `order` link relation was shipped from the lab. |\n| `studio-granted-archiving-space` | The studio was granted more archiving space.  |\n| `studio-money-balance-increased` | The studio’s money balance increased. |\n| `studio-photo-plan-next-bill-date-increased` | The studio’s next billing date changed, often due to more free time added to their plan. |\n| `studio-profit-released` | The studio’s money was released to their bank account. |",
      "enum": [
        "contract-canceled",
        "contract-signed-by-client",
        "event-photo-downloaded-by-event-contact",
        "event-photo-favorited-by-event-contact",
        "event-photo-hidden-by-event-contact",
        "event-photo-tagged-by-event-contact",
        "invoice-past-due",
        "invoice-payment-received",
        "order-approval-prolonged",
        "order-needs-approval",
        "order-placed",
        "order-shipped-from-lab",
        "studio-granted-archiving-space",
        "studio-money-balance-increased",
        "studio-photo-plan-next-bill-date-increased",
        "studio-profit-released"
      ],
      "readOnly": true,
      "type": "string"
    },
    "type": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Type"
        },
        {
          "enum": [
            "notification"
          ]
        }
      ]
    }
  },
  "title": "Notification",
  "type": "object"
}