{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Zeplin API Schemas",
"description": "JSON Schema definitions extracted from the Zeplin API OpenAPI specification",
"definitions": {
"TokenResponse": {
"title": "Token Response",
"type": "object",
"required": [
"access_token",
"expires_in",
"refresh_token",
"refresh_expires_in",
"token_type"
],
"properties": {
"access_token": {
"type": "string",
"description": "Access token that allows you to make requests to the API on behalf of a user"
},
"expires_in": {
"type": "number",
"description": "Access token's lifetime in seconds"
},
"refresh_token": {
"type": "string",
"description": "Refresh token that allows you to obtain access tokens"
},
"refresh_expires_in": {
"type": "number",
"description": "Refresh token's lifetime in seconds"
},
"token_type": {
"type": "string",
"description": "Type of the token returned"
}
},
"example": {
"$ref": "#/components/examples/tokenResponse"
}
},
"BoundingRectangle": {
"title": "Bounding Rectangle",
"type": "object",
"required": [
"width",
"height",
"x",
"y",
"absolute"
],
"properties": {
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"absolute": {
"$ref": "#/components/schemas/LayerPosition",
"description": "Absolute position of the bounding rectangle"
}
},
"example": {
"$ref": "#/components/examples/boundingRectangle"
}
},
"HotspotBoundingRectangle": {
"title": "Hotspot Bounding Rectangle",
"type": "object",
"required": [
"width",
"height",
"x",
"y"
],
"properties": {
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"x": {
"type": "number"
},
"y": {
"type": "number"
}
},
"example": {
"$ref": "#/components/examples/hotspotBoundingRectangle"
}
},
"Color": {
"title": "Color",
"type": "object",
"required": [
"id",
"created",
"name",
"r",
"g",
"b",
"a"
],
"properties": {
"id": {
"type": "string",
"description": "Identifier of the color"
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the color was created"
},
"source_id": {
"type": "string",
"description": "Color's identifier in the design tool"
},
"name": {
"type": "string",
"description": "Name of the color"
},
"r": {
"type": "integer",
"description": "Red component of the color"
},
"g": {
"type": "integer",
"description": "Green component of the color"
},
"b": {
"type": "integer",
"description": "Blue component of the color"
},
"a": {
"type": "number",
"description": "Alpha component of the color"
},
"source": {
"$ref": "#/components/schemas/ResourceSource",
"description": "Source of the color\u2013either `project` or `styleguide`."
},
"variable_info": {
"$ref": "#/components/schemas/VariableInfo",
"description": "Variable info of the color"
}
},
"example": {
"$ref": "#/components/examples/color"
}
},
"ColorData": {
"title": "Color Data",
"type": "object",
"required": [
"r",
"g",
"b",
"a"
],
"properties": {
"source_id": {
"type": "string",
"description": "Color's identifier in the design tool"
},
"r": {
"type": "integer",
"description": "Red component of the color"
},
"g": {
"type": "integer",
"description": "Green component of the color"
},
"b": {
"type": "integer",
"description": "Blue component of the color"
},
"a": {
"type": "number",
"description": "Alpha component of the color"
}
},
"example": {
"$ref": "#/components/examples/colorData"
}
},
"User": {
"title": "User",
"description": "Basic info about Zeplin users.\n\nZeplin API does not expose any personal information to third-party clients. For this reason, the `email` field is a Zeplin-only alias by default.\n\nYou can get the original email addresses of members of your workspace by using a personal access token created with admin rights. Third-party (OAuth) applications are not allowed to access this information.\n\n\u261d\ufe0f*Only organization admins (or higher) can retrieve the original email addresses using an admin token.*\n",
"type": "object",
"required": [
"id",
"email",
"username"
],
"properties": {
"id": {
"type": "string",
"description": "User's unique id"
},
"email": {
"type": "string",
"description": "Zeplin-only alias for the user's email (original)"
},
"username": {
"type": "string",
"description": "Username of the user"
},
"emotar": {
"type": "string",
"format": "emoji",
"description": "Emotar of the user"
},
"avatar": {
"type": "string",
"description": "Avatar of the user"
},
"last_seen": {
"type": "number",
"description": "The unix timestamp when the user was last seen"
}
},
"example": {
"$ref": "#/components/examples/user"
},
"x-examples": {
"User": {
"$ref": "#/components/examples/user"
},
"My User": {
"$ref": "#/components/examples/me"
}
}
},
"RemPreferences": {
"title": "rem Preferences",
"description": "rem preferences of project or styleguide. The content of this property varies depending on the value of its status field.",
"discriminator": {
"propertyName": "status",
"mapping": {
"enabled": "#/components/schemas/EnabledRemPreferences",
"disabled": "#/components/schemas/DisabledOrLinkedRemPreferences",
"linked": "#/components/schemas/DisabledOrLinkedRemPreferences"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/EnabledRemPreferences"
},
{
"$ref": "#/components/schemas/DisabledOrLinkedRemPreferences"
}
]
},
"EnabledRemPreferences": {
"title": "Enabled rem Preferences",
"type": "object",
"required": [
"status",
"root_font_size",
"use_for_font_sizes",
"use_for_measurements"
],
"properties": {
"status": {
"type": "string",
"description": "The status of the preferences",
"enum": [
"enabled"
]
},
"root_font_size": {
"description": "Font size of the root element",
"type": "number"
},
"use_for_font_sizes": {
"description": "Whether rem unit is used for font sizes",
"type": "boolean"
},
"use_for_measurements": {
"description": "Whether rem unit is used for measurements",
"type": "boolean"
}
},
"example": {
"$ref": "#/components/examples/remPreferences"
}
},
"DisabledOrLinkedRemPreferences": {
"title": "Disabled or Linked rem Preferences",
"type": "object",
"description": "If `status` is `\"linked\"`, project or styleguide uses its parent styleguide as the source of preferences.",
"required": [
"status"
],
"properties": {
"status": {
"type": "string",
"description": "The status of the preferences.",
"enum": [
"disabled",
"linked"
]
}
}
},
"Project": {
"title": "Project",
"type": "object",
"required": [
"id",
"name",
"platform",
"status",
"created",
"number_of_members",
"number_of_screens",
"number_of_components",
"number_of_connected_components",
"number_of_colors",
"number_of_text_styles",
"number_of_spacing_tokens"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the project"
},
"name": {
"type": "string",
"description": "The name of the project"
},
"description": {
"type": "string",
"description": "The description of the project"
},
"platform": {
"type": "string",
"enum": [
"web",
"ios",
"android",
"macos"
],
"description": "The target platform of the project"
},
"thumbnail": {
"type": "string",
"description": "URL of the project's thumbnail image"
},
"status": {
"$ref": "#/components/schemas/ProjectStatusEnum"
},
"organization": {
"$ref": "#/components/schemas/OrganizationSummary"
},
"rem_preferences": {
"$ref": "#/components/schemas/RemPreferences"
},
"workflow_status": {
"$ref": "#/components/schemas/WorkflowStatus"
},
"scene_url": {
"type": "string",
"description": "URL of the project's scene (public projects only)",
"format": "url"
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the project was created"
},
"updated": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the project was updated"
},
"number_of_members": {
"type": "integer",
"description": "The number of members of the project"
},
"number_of_screens": {
"type": "integer",
"description": "The number of screens in the project"
},
"number_of_components": {
"type": "integer",
"description": "The number of components exported to the project"
},
"number_of_connected_components": {
"type": "integer",
"description": "The number of connected components in the project"
},
"number_of_text_styles": {
"type": "integer",
"description": "The number of text styles added to the project"
},
"number_of_colors": {
"type": "integer",
"description": "The number of colors added to the project"
},
"number_of_spacing_tokens": {
"type": "integer",
"description": "The number of spacing tokens added to the project"
},
"linked_styleguide": {
"$ref": "#/components/schemas/EntityReference",
"description": "Reference the styleguide which the project is linked to"
}
},
"example": {
"$ref": "#/components/examples/project"
},
"x-examples": {
"Personal Project": {
"$ref": "#/components/examples/project"
},
"Organization Project": {
"$ref": "#/components/examples/organizationProject"
}
}
},
"ProjectMember": {
"title": "Project Member",
"type": "object",
"required": [
"user",
"role"
],
"properties": {
"user": {
"$ref": "#/components/schemas/User"
},
"role": {
"type": "string",
"enum": [
"owner",
"admin",
"user",
"editor",
"member",
"alien"
],
"description": "The role of the user in the project"
}
},
"example": {
"$ref": "#/components/examples/projectMember"
}
},
"Organization": {
"title": "Organization",
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"description": "Organization's unique id"
},
"name": {
"type": "string",
"description": "Name of the user"
},
"logo": {
"type": "string",
"description": "URL of the organization's logo",
"format": "url"
},
"members": {
"type": "array",
"items": {
"$ref": "#/components/schemas/OrganizationMember"
},
"description": "Members of the organization (Does not exist on the response when user is restricted in organization)"
}
},
"example": {
"$ref": "#/components/examples/organization"
}
},
"OrganizationBilling": {
"title": "Organization Billing Details",
"type": "object",
"required": [
"total_seat_count",
"used_seat_count"
],
"properties": {
"total_seat_count": {
"type": "number",
"description": "Total number of seats reserved for the organization"
},
"used_seat_count": {
"type": "number",
"description": "Number of used seats for the organization"
}
},
"example": {
"$ref": "#/components/examples/organizationBilling"
}
},
"OrganizationMember": {
"title": "Organization Member",
"type": "object",
"required": [
"user",
"tags",
"role",
"restricted"
],
"properties": {
"user": {
"$ref": "#/components/schemas/User"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags of the user in the organization"
},
"role": {
"type": "string",
"enum": [
"owner",
"admin",
"editor",
"member",
"alien"
],
"description": "The role of the user in the organization\n\n\u261d\ufe0fNote that the Developer role maps to `member` and the Reviewer role maps to `alien` in the API.\n"
},
"restricted": {
"type": "boolean",
"description": "Whether the user's membership is restricted to only the projects that they are member of"
},
"invited": {
"type": "number",
"description": "Invitation timestamp of the user to the organization"
}
},
"example": {
"$ref": "#/components/examples/organizationMember"
}
},
"OrganizationSummary": {
"title": "Organization Summary",
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"description": "Organization's unique id"
},
"name": {
"type": "string",
"description": "Name of the user"
},
"logo": {
"type": "string",
"description": "URL of the organization's logo",
"format": "url"
}
},
"example": {
"$ref": "#/components/examples/organizationSummary"
}
},
"Screen": {
"title": "Screen",
"type": "object",
"required": [
"id",
"tags",
"name",
"image",
"created",
"number_of_versions",
"number_of_notes",
"number_of_annotations"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the screen"
},
"name": {
"type": "string",
"description": "The name of the screen"
},
"description": {
"type": "string",
"description": "The description of the screen"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "The tags platform of the screen"
},
"image": {
"$ref": "#/components/schemas/SnapshotImage"
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the screen was created"
},
"updated": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the screen was updated"
},
"number_of_versions": {
"type": "integer",
"description": "The number of versions exported to the screen"
},
"number_of_notes": {
"type": "integer",
"description": "The number of notes in the screen"
},
"number_of_annotations": {
"type": "integer",
"description": "The number of annotations in the screen"
},
"section": {
"$ref": "#/components/schemas/EntityReference",
"description": "Reference of the section that contains the screen"
},
"variant": {
"$ref": "#/components/schemas/ScreenVariant"
}
},
"example": {
"$ref": "#/components/examples/screen"
}
},
"ScreenNote": {
"title": "Screen Note",
"type": "object",
"description": "Screen notes are comments added to a screen and can be either point notes, which have a single point in the position field, or area notes, which have a position field containing both a start and end point to define a rectangular region.\n",
"required": [
"id",
"order",
"creator",
"status",
"comments",
"position",
"color",
"created"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the note"
},
"creator": {
"$ref": "#/components/schemas/User"
},
"order": {
"type": "integer",
"description": "Order of the note in the screen (e.g., 1, 2, 3, so on)"
},
"status": {
"$ref": "#/components/schemas/ScreenNoteStatusEnum"
},
"position": {
"$ref": "#/components/schemas/ScreenNotePosition"
},
"color": {
"$ref": "#/components/schemas/ScreenNoteColor"
},
"comments": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ScreenNoteComment"
}
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the note was created"
}
},
"example": {
"$ref": "#/components/examples/screenNote"
}
},
"ScreenNoteColor": {
"title": "Screen Note Color",
"type": "object",
"required": [
"r",
"g",
"b",
"a"
],
"properties": {
"name": {
"$ref": "#/components/schemas/ScreenNoteColorNameEnum",
"description": "Name of the color"
},
"r": {
"type": "integer",
"description": "Red component of the color"
},
"g": {
"type": "integer",
"description": "Green component of the color"
},
"b": {
"type": "integer",
"description": "Blue component of the color"
},
"a": {
"type": "number",
"description": "Alpha component of the color"
}
},
"example": {
"$ref": "#/components/examples/screenNoteColor"
}
},
"ScreenNotePosition": {
"title": "Screen Note Position",
"description": "Position of the note with respect to top left corner. Values are normalized in [0, 1]",
"type": "object",
"required": [
"x",
"y"
],
"properties": {
"x": {
"type": "number",
"description": "The X-coordinate of the note's position. For area notes, this represents the X-coordinate of the end point."
},
"y": {
"type": "number",
"description": "The Y-coordinate of the note's position. For area notes, this represents the Y-coordinate of the end point."
},
"x_start": {
"type": "number",
"description": "The X-coordinate of the start point for area notes. Ignored for point notes."
},
"y_start": {
"type": "number",
"description": "The Y-coordinate of the start point for area notes. Ignored for point notes."
}
},
"example": {
"$ref": "#/components/examples/screenNotePosition"
}
},
"ScreenAnnotation": {
"title": "Screen Annotation",
"type": "object",
"required": [
"id",
"content",
"type",
"position",
"creator",
"updated",
"created"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the annotation"
},
"content": {
"type": "string",
"description": "The text of the annotation"
},
"type": {
"$ref": "#/components/schemas/ScreenAnnotationNoteType"
},
"position": {
"$ref": "#/components/schemas/ScreenAnnotationPosition"
},
"creator": {
"$ref": "#/components/schemas/User"
},
"updated_by": {
"$ref": "#/components/schemas/User",
"description": "The user who last updated the content of the annotation"
},
"updated": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the annotation was last updated"
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the annotation was created"
}
},
"example": {
"$ref": "#/components/examples/screenAnnotation"
}
},
"ScreenAnnotationPosition": {
"title": "Screen Annotation Position",
"description": "Position of the annotation with respect to top left corner. Values are normalized in [0, 1]",
"type": "object",
"required": [
"x",
"y"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
}
},
"example": {
"$ref": "#/components/examples/screenAnnotationPosition"
}
},
"ScreenAnnotationNoteType": {
"title": "Screen Annotation Note Type",
"type": "object",
"required": [
"id",
"name",
"color"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the annotation"
},
"name": {
"$ref": "#/components/schemas/ScreenAnnotationNoteTypeEnum",
"description": "Name of the note type"
},
"color": {
"$ref": "#/components/schemas/ScreenAnnotationColor",
"description": "Color of the note type"
}
}
},
"ScreenAnnotationColor": {
"title": "Screen Annotation Color",
"type": "object",
"required": [
"r",
"g",
"b",
"a"
],
"properties": {
"name": {
"type": "string",
"description": "Name of the color"
},
"r": {
"type": "integer",
"description": "Red component of the color"
},
"g": {
"type": "integer",
"description": "Green component of the color"
},
"b": {
"type": "integer",
"description": "Blue component of the color"
},
"a": {
"type": "number",
"description": "Alpha component of the color"
}
},
"example": {
"$ref": "#/components/examples/screenAnnotationColor"
}
},
"ScreenSection": {
"title": "Screen Section",
"type": "object",
"required": [
"id",
"created",
"name"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the screen section"
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the screen section was created"
},
"name": {
"type": "string",
"description": "The name of the screen section"
},
"description": {
"type": "string",
"description": "The description of the screen section"
},
"parent": {
"$ref": "#/components/schemas/EntityReference"
}
},
"example": {
"$ref": "#/components/examples/screenSection"
}
},
"ScreenVariant": {
"title": "Screen Variant",
"type": "object",
"required": [
"value",
"group"
],
"properties": {
"value": {
"type": "string",
"description": "Value for this variant of the screen"
},
"group": {
"$ref": "#/components/schemas/ScreenVariantGroupReference"
}
}
},
"ScreenVariantGroup": {
"title": "Screen Variant Group",
"type": "object",
"required": [
"id",
"name",
"variants"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the screen variant"
},
"name": {
"type": "string",
"description": "The name of the screen variant"
},
"variants": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ScreenVariantGroupValue"
}
}
},
"example": {
"$ref": "#/components/examples/screenVariantGroup"
}
},
"ScreenVariantGroupReference": {
"title": "Screen Variant Group Reference",
"type": "object",
"description": "Variant group that contains the screen",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"description": "Unique id of the screen variant"
},
"name": {
"type": "string",
"description": "Name of the screen variant"
}
}
},
"ScreenVariantGroupValue": {
"title": "Screen Variant Group Value",
"type": "object",
"required": [
"screen_id",
"value"
],
"properties": {
"screen_id": {
"type": "string",
"description": "Unique id of the variant screen"
},
"value": {
"type": "string",
"description": "Value for the variant"
}
}
},
"ScreenVersion": {
"title": "Screen Version",
"type": "object",
"required": [
"id",
"created",
"source",
"width",
"height",
"density_scale",
"links",
"layers",
"assets"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the version"
},
"creator": {
"$ref": "#/components/schemas/User"
},
"commit": {
"$ref": "#/components/schemas/VersionCommit"
},
"image_url": {
"type": "string",
"format": "url",
"description": "URL of the image for the version"
},
"thumbnails": {
"$ref": "#/components/schemas/Thumbnails"
},
"source": {
"allOf": [
{
"$ref": "#/components/schemas/SourceEnum"
},
{
"description": "Source application of the version"
}
]
},
"source_file_url": {
"type": "string",
"format": "url",
"description": "Source file url of the version"
},
"width": {
"type": "integer",
"description": "Width of the version"
},
"height": {
"type": "integer",
"description": "Height of the version"
},
"background_color": {
"$ref": "#/components/schemas/ColorData"
},
"density_scale": {
"type": "number",
"description": "Pixel density"
},
"links": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Link"
}
},
"grid": {
"$ref": "#/components/schemas/Grid"
},
"layers": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Layer"
},
"description": "Layers of the screen version"
},
"assets": {
"type": "array",
"description": "Assets of the screen version",
"items": {
"$ref": "#/components/schemas/Asset"
}
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the screen version was created"
}
},
"example": {
"$ref": "#/components/examples/screenVersion"
}
},
"ScreenVersionSummary": {
"title": "Screen Version Summary",
"type": "object",
"required": [
"id",
"created",
"source",
"width",
"height",
"density_scale",
"links",
"image_url",
"thumbnails"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the version"
},
"creator": {
"$ref": "#/components/schemas/User"
},
"commit": {
"$ref": "#/components/schemas/VersionCommit"
},
"image_url": {
"type": "string",
"format": "url",
"description": "URL of the image for the version"
},
"thumbnails": {
"$ref": "#/components/schemas/Thumbnails"
},
"source": {
"allOf": [
{
"$ref": "#/components/schemas/SourceEnum"
},
{
"description": "Source application of the version"
}
]
},
"source_file_url": {
"type": "string",
"format": "url",
"description": "Source file url of the version"
},
"width": {
"type": "integer",
"description": "Width of the version"
},
"height": {
"type": "integer",
"description": "Height of the version"
},
"background_color": {
"$ref": "#/components/schemas/ColorData"
},
"density_scale": {
"type": "number",
"description": "Pixel density"
},
"links": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Link"
}
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the screen version was created"
}
},
"example": {
"$ref": "#/components/examples/screenVersionSummary"
}
},
"Styleguide": {
"title": "Styleguide",
"type": "object",
"required": [
"id",
"name",
"platform",
"status",
"created",
"number_of_members",
"number_of_components",
"number_of_colors",
"number_of_text_styles",
"number_of_spacing_tokens",
"number_of_connected_components"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the styleguide"
},
"name": {
"type": "string",
"description": "The name of the styleguide"
},
"description": {
"type": "string",
"description": "The description of the styleguide (It can contain markdown https://zpl.io/article/markdown-support)"
},
"platform": {
"type": "string",
"enum": [
"base",
"web",
"ios",
"android",
"macos"
],
"description": "The target platform of the styleguide"
},
"thumbnail": {
"type": "string",
"description": "URL of the styleguide's thumbnail image"
},
"status": {
"$ref": "#/components/schemas/StyleguideStatusEnum"
},
"organization": {
"$ref": "#/components/schemas/OrganizationSummary"
},
"rem_preferences": {
"$ref": "#/components/schemas/RemPreferences"
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the styleguide was created"
},
"updated": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the styleguide was updated"
},
"number_of_members": {
"type": "integer",
"description": "The number of members of the styleguide"
},
"number_of_connected_components": {
"type": "integer",
"description": "The number of connected components in the styleguide"
},
"number_of_components": {
"type": "integer",
"description": "The number of components exported to the styleguide"
},
"number_of_text_styles": {
"type": "integer",
"description": "The number of text styles added to the styleguide"
},
"number_of_colors": {
"type": "integer",
"description": "The number of colors added to the styleguide"
},
"number_of_spacing_tokens": {
"type": "integer",
"description": "The number of spacing tokens added to the styleguide"
},
"parent": {
"$ref": "#/components/schemas/EntityReference",
"description": "Reference of the parent styleguide"
}
},
"example": {
"$ref": "#/components/examples/styleguide"
},
"x-examples": {
"Personal Styleguide": {
"$ref": "#/components/examples/styleguide"
},
"Organization Styleguide": {
"$ref": "#/components/examples/organizationStyleguide"
}
}
},
"StyleguideMember": {
"title": "Styleguide Member",
"type": "object",
"required": [
"user",
"role"
],
"properties": {
"user": {
"$ref": "#/components/schemas/User"
},
"role": {
"type": "string",
"enum": [
"owner",
"admin",
"user",
"editor",
"member",
"alien"
],
"description": "The role of the user in the styleguide"
}
},
"example": {
"$ref": "#/components/examples/styleguideMember"
}
},
"VersionCommit": {
"title": "Version Commit",
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string",
"description": "Commit message for the version"
},
"author": {
"$ref": "#/components/schemas/User"
},
"color": {
"$ref": "#/components/schemas/VersionCommitColor"
}
},
"example": {
"$ref": "#/components/examples/versionCommit"
}
},
"VersionCommitColor": {
"title": "Version Commit Color",
"type": "object",
"required": [
"r",
"g",
"b",
"a"
],
"properties": {
"r": {
"type": "integer",
"description": "red component of the color"
},
"g": {
"type": "integer",
"description": "green component of the color"
},
"b": {
"type": "integer",
"description": "blue component of the color"
},
"a": {
"type": "number",
"description": "alpha component of the color"
}
},
"example": {
"$ref": "#/components/examples/versionCommitColor"
}
},
"TextStyle": {
"title": "Text Style",
"type": "object",
"required": [
"id",
"name",
"created",
"postscript_name",
"font_family",
"font_size",
"font_weight",
"font_style",
"font_stretch"
],
"properties": {
"id": {
"type": "string",
"description": "Identifier of the text style"
},
"name": {
"type": "string",
"description": "Name of the text style"
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the text style was created"
},
"postscript_name": {
"type": "string",
"description": "PostScript name of the text style, e.g. Roboto-Regular"
},
"font_family": {
"type": "string",
"description": "Font family of the text style, e.g. Roboto, Arial"
},
"font_size": {
"type": "number",
"description": "Font size of the text style"
},
"font_weight": {
"type": "number",
"description": "Font weight of the text style, e.g. 500, 700"
},
"font_style": {
"type": "string",
"description": "Font style of the text style, e.g. italic, oblique"
},
"font_stretch": {
"type": "number",
"description": "Font stretch form of the text style, e.g. 0.75, 1.00"
},
"line_height": {
"type": "number",
"description": "Minimum height of a line for the text style"
},
"letter_spacing": {
"type": "number",
"description": "Spacing between letters"
},
"text_align": {
"type": "string",
"description": "Horizontal alignment of the text style, left, right, center, or justify"
},
"color": {
"$ref": "#/components/schemas/ColorData"
},
"source": {
"$ref": "#/components/schemas/ResourceSource",
"description": "Source of the text style\u2013either `project` or `styleguide`."
}
},
"example": {
"$ref": "#/components/examples/textStyle"
}
},
"TextStyleData": {
"title": "Text Style Data",
"type": "object",
"required": [
"postscript_name",
"font_family",
"font_size",
"font_weight",
"font_style",
"font_stretch"
],
"properties": {
"postscript_name": {
"type": "string",
"description": "PostScript name of the text style, e.g. Roboto-Regular"
},
"font_family": {
"type": "string",
"description": "Font family of the text style, e.g. Roboto, Arial"
},
"font_size": {
"type": "number",
"description": "Font size of the text style"
},
"font_weight": {
"type": "number",
"description": "Font weight of the text style, e.g. 500, 700"
},
"font_style": {
"type": "string",
"description": "Font style of the text style, e.g. italic, oblique"
},
"font_stretch": {
"type": "number",
"description": "Font stretch form of the text style, e.g. 0.75, 1.00"
},
"line_height": {
"type": "number",
"description": "Minimum height of a line for the text style"
},
"letter_spacing": {
"type": "number",
"description": "Spacing between letters"
},
"text_align": {
"type": "string",
"description": "Horizontal alignment of the text style, left, right, center, or justify"
},
"color": {
"$ref": "#/components/schemas/ColorData"
}
},
"example": {
"$ref": "#/components/examples/textStyleData"
}
},
"Component": {
"title": "Component",
"type": "object",
"required": [
"id",
"name",
"image",
"created"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the component"
},
"name": {
"type": "string",
"description": "The name of the component"
},
"description": {
"type": "string",
"description": "The description of the component"
},
"image": {
"$ref": "#/components/schemas/SnapshotImage"
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the component was created"
},
"updated": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the component was updated"
},
"section": {
"$ref": "#/components/schemas/ComponentSectionReference"
},
"variant_properties": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ComponentVariantProperty"
},
"description": "Variant properties of the component"
},
"source": {
"$ref": "#/components/schemas/ResourceSource",
"description": "Source of the text style. Either `project` or `styleguide`."
},
"latest_version": {
"$ref": "#/components/schemas/ComponentVersion",
"description": "Design data in the latest version of the component. This exists if the related endpoint parameter (`include_latest_version=true`) is provided in component endpoints."
}
},
"example": {
"$ref": "#/components/examples/component"
}
},
"ComponentSection": {
"title": "Component Section",
"type": "object",
"required": [
"id",
"created",
"name",
"groups"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the component section"
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the component section was created"
},
"name": {
"type": "string",
"description": "The name of the component section"
},
"description": {
"type": "string",
"description": "The description of the component section"
},
"groups": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ComponentGroup"
}
},
"variant": {
"$ref": "#/components/schemas/ComponentSectionVariant"
}
},
"example": {
"$ref": "#/components/examples/componentSection"
}
},
"ComponentSectionReference": {
"title": "Component Section Reference",
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique id of the section that contains the component"
},
"group": {
"allOf": [
{
"$ref": "#/components/schemas/EntityReference"
},
{
"description": "Unique id of the group that contains the component"
}
]
}
},
"example": {
"$ref": "#/components/examples/componentSectionReference"
}
},
"ComponentGroup": {
"title": "Component Group",
"type": "object",
"required": [
"id",
"created",
"name"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the component section"
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the component group was created"
},
"name": {
"type": "string",
"description": "The name of the component section"
},
"description": {
"type": "string",
"description": "The description of the component section"
}
},
"example": {
"$ref": "#/components/examples/componentGroup"
}
},
"ComponentSectionVariant": {
"title": "Component Section Variant",
"description": "Variant information for this component section",
"type": "object",
"required": [
"properties"
],
"properties": {
"properties": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ComponentSectionVariantProperty"
},
"description": "List of variant properties that the components of this section take"
},
"source_id": {
"type": "string",
"description": "Unique identifier used for this variant in the source design file"
}
},
"example": {
"$ref": "#/components/examples/componentSectionVariant"
}
},
"ComponentSectionVariantProperty": {
"title": "Component Section Variant Property",
"type": "object",
"required": [
"id",
"name",
"values"
],
"properties": {
"id": {
"type": "string",
"description": "Unique id of the variant property"
},
"name": {
"type": "string",
"description": "Name of the variant property (e.g. `\u201ctype\u201d`, `\u201cstate\u201d`, etc.)"
},
"values": {
"type": "array",
"items": {
"type": "string"
},
"description": "Possible values that the property can take (e.g. `[\"default\", \"hover\", \"pressed\"]`)"
}
},
"example": {
"$ref": "#/components/examples/componentSectionVariantProperty"
}
},
"ComponentVariantProperty": {
"title": "Component Variant Property",
"type": "object",
"required": [
"id",
"name",
"value"
],
"properties": {
"id": {
"type": "string",
"description": "Unique id of the variant property"
},
"name": {
"type": "string",
"description": "Name of the variant property (e.g. `\u201ctype\u201d`, `\u201cstate\u201d`, etc.)"
},
"value": {
"type": "string",
"description": "Value for this property of the component (e.g. `\"primary\"`)"
}
},
"example": {
"$ref": "#/components/examples/componentVariantProperty"
}
},
"ComponentVersion": {
"title": "Component Version",
"type": "object",
"required": [
"id",
"source",
"width",
"height",
"density_scale",
"links",
"layers",
"assets",
"created"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the version"
},
"creator": {
"$ref": "#/components/schemas/User"
},
"image_url": {
"type": "string",
"format": "url",
"description": "URL of the image for the version"
},
"thumbnails": {
"$ref": "#/components/schemas/Thumbnails"
},
"source": {
"allOf": [
{
"$ref": "#/components/schemas/SourceEnum"
},
{
"description": "Source application of the version"
}
]
},
"source_file_url": {
"type": "string",
"format": "url",
"description": "Source file url of the version"
},
"width": {
"type": "integer",
"description": "Width of the version"
},
"height": {
"type": "integer",
"description": "Height of the version"
},
"background_color": {
"$ref": "#/components/schemas/ColorData"
},
"density_scale": {
"type": "number",
"description": "Pixel density"
},
"links": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Link"
}
},
"grid": {
"$ref": "#/components/schemas/Grid"
},
"layers": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Layer"
},
"description": "Layers of the component version"
},
"assets": {
"type": "array",
"description": "Assets of the component version",
"items": {
"$ref": "#/components/schemas/Asset"
}
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the component version was created"
}
},
"example": {
"$ref": "#/components/examples/componentVersion"
}
},
"ComponentVersionSummary": {
"title": "Component Version Summary",
"type": "object",
"required": [
"id",
"created",
"source",
"width",
"height",
"density_scale",
"links",
"image_url"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the version"
},
"creator": {
"$ref": "#/components/schemas/User"
},
"commit": {
"$ref": "#/components/schemas/VersionCommit"
},
"image_url": {
"type": "string",
"format": "url",
"description": "URL of the image for the version"
},
"thumbnails": {
"$ref": "#/components/schemas/Thumbnails"
},
"source": {
"allOf": [
{
"$ref": "#/components/schemas/SourceEnum"
},
{
"description": "Source application of the version"
}
]
},
"source_file_url": {
"type": "string",
"format": "url",
"description": "Source file url of the version"
},
"width": {
"type": "integer",
"description": "Width of the version"
},
"height": {
"type": "integer",
"description": "Height of the version"
},
"background_color": {
"$ref": "#/components/schemas/ColorData"
},
"density_scale": {
"type": "number",
"description": "Pixel density"
},
"links": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Link"
}
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the component version was created"
}
},
"example": {
"$ref": "#/components/examples/componentVersionSummary"
}
},
"SnapshotImage": {
"title": "Snapshot Image",
"type": "object",
"required": [
"width",
"height",
"original_url",
"thumbnails"
],
"properties": {
"width": {
"type": "number",
"description": "Width of the component image"
},
"height": {
"type": "number",
"description": "Height of the component image"
},
"thumbnails": {
"$ref": "#/components/schemas/Thumbnails"
},
"original_url": {
"type": "string",
"description": "URL of the original image for the component (from the latest version)"
}
},
"example": {
"$ref": "#/components/examples/snapshotImage"
}
},
"SpacingToken": {
"title": "Spacing Token",
"type": "object",
"required": [
"id",
"name",
"value",
"color",
"section"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the token"
},
"name": {
"type": "string",
"description": "The name of the token"
},
"value": {
"type": "number",
"description": "The value of the token"
},
"color": {
"$ref": "#/components/schemas/SpacingTokenColor"
},
"section": {
"$ref": "#/components/schemas/EntityReference",
"description": "Reference of the section that contains the token"
},
"source": {
"$ref": "#/components/schemas/ResourceSource",
"description": "Source of the color\u2013either `project` or `styleguide`."
}
},
"example": {
"$ref": "#/components/examples/spacingToken"
}
},
"SpacingTokenColor": {
"title": "Spacing Token Color",
"type": "object",
"required": [
"r",
"g",
"b",
"a"
],
"properties": {
"r": {
"type": "integer",
"description": "red component of the color"
},
"g": {
"type": "integer",
"description": "green component of the color"
},
"b": {
"type": "integer",
"description": "blue component of the color"
},
"a": {
"type": "number",
"description": "alpha component of the color"
}
},
"example": {
"$ref": "#/components/examples/spacingTokenColor"
}
},
"SpacingSection": {
"title": "Spacing Section",
"type": "object",
"required": [
"id",
"name",
"base_token"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the section"
},
"name": {
"type": "string",
"description": "The name of the section"
},
"description": {
"type": "string",
"description": "The description of the section"
},
"base_token": {
"$ref": "#/components/schemas/EntityReference",
"description": "Reference of the base token of the section"
}
},
"example": {
"$ref": "#/components/examples/spacingSection"
}
},
"LayerPosition": {
"title": "Layer Position",
"type": "object",
"required": [
"x",
"y"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
}
},
"example": {
"$ref": "#/components/examples/layerPosition"
}
},
"Layer": {
"title": "Layer",
"type": "object",
"required": [
"id",
"type",
"rect",
"opacity"
],
"properties": {
"id": {
"type": "string",
"description": "Layer's unique id"
},
"source_id": {
"type": "string",
"description": "Layer's identifier in the design tool"
},
"type": {
"type": "string",
"enum": [
"text",
"shape",
"group"
],
"description": "Type of the layer"
},
"name": {
"type": "string",
"description": "Name of the layer"
},
"rect": {
"$ref": "#/components/schemas/BoundingRectangle",
"description": "Bounding rectangle of the layer"
},
"fills": {
"type": "array",
"description": "Fills applied to the layer",
"items": {
"$ref": "#/components/schemas/LayerFill"
}
},
"borders": {
"type": "array",
"description": "Borders of the layer",
"items": {
"$ref": "#/components/schemas/LayerBorder"
}
},
"shadows": {
"type": "array",
"description": "Shadows applied to the layer",
"items": {
"$ref": "#/components/schemas/LayerShadow"
}
},
"blur": {
"$ref": "#/components/schemas/LayerBlur"
},
"opacity": {
"type": "number",
"description": "Opacity of the layer, [0, 1]"
},
"blend_mode": {
"$ref": "#/components/schemas/BlendModeEnum"
},
"border_radius": {
"type": "number",
"description": "Border radius of the layer"
},
"rotation": {
"type": "number",
"description": "Rotation of the layer"
},
"exportable": {
"type": "boolean",
"description": "Indicates whether the layer has assets or not"
},
"content": {
"type": "string",
"description": "Text of the text layer"
},
"text_styles": {
"type": "array",
"items": {
"$ref": "#/components/schemas/LayerTextStyle"
}
},
"layers": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Layer"
}
},
"component_name": {
"type": "string",
"description": "Name of the component the group layer is referencing"
}
},
"example": {
"$ref": "#/components/examples/layer"
}
},
"Gradient": {
"title": "Gradient",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"linear",
"radial",
"angular"
],
"description": "Type of the gradient"
},
"angle": {
"type": "number",
"description": "Angle of the gradient"
},
"scale": {
"type": "number",
"description": "Scale of the gradient"
},
"color_stops": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ColorStop"
}
},
"opacity": {
"type": "number",
"description": "Opacity of the gradient"
}
},
"example": {
"$ref": "#/components/examples/gradient"
}
},
"ColorStop": {
"title": "Color Stop",
"type": "object",
"required": [
"color",
"position"
],
"properties": {
"color": {
"$ref": "#/components/schemas/ColorData"
},
"position": {
"type": "number"
}
},
"example": {
"$ref": "#/components/examples/colorStop"
}
},
"LayerBlur": {
"title": "Layer Blur",
"type": "object",
"description": "Blur applied to the layer",
"properties": {
"type": {
"type": "string",
"enum": [
"gaussian",
"background"
],
"description": "Type of the blur"
},
"radius": {
"type": "number",
"description": "Radius of the blur"
}
},
"example": {
"$ref": "#/components/examples/layerBlur"
}
},
"LayerBorder": {
"title": "Layer Border",
"type": "object",
"properties": {
"position": {
"type": "string",
"enum": [
"center",
"inside",
"outside"
],
"description": "Position of the border"
},
"thickness": {
"type": "number",
"description": "Thickness of the border"
},
"fill": {
"$ref": "#/components/schemas/LayerFill"
}
},
"example": {
"$ref": "#/components/examples/layerBorder"
}
},
"LayerFill": {
"title": "Layer Fill",
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"enum": [
"color",
"gradient"
],
"description": "Type of the fill"
},
"color": {
"$ref": "#/components/schemas/ColorData"
},
"gradient": {
"$ref": "#/components/schemas/Gradient"
},
"blend_mode": {
"$ref": "#/components/schemas/BlendModeEnum"
}
},
"example": {
"$ref": "#/components/examples/layerFill"
}
},
"LayerShadow": {
"title": "Layer Shadow",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"outer",
"inner"
],
"description": "Type of the shadow"
},
"offset_x": {
"type": "number",
"description": "Horizontal offset of the shadow"
},
"offset_y": {
"type": "number",
"description": "Vertical offset of the shadow"
},
"blur_radius": {
"type": "number",
"description": "Blur radius of the shadow"
},
"spread": {
"type": "number",
"description": "Spread of the shadow"
},
"color": {
"$ref": "#/components/schemas/ColorData"
}
},
"example": {
"$ref": "#/components/examples/layerShadow"
}
},
"LayerTextStyle": {
"title": "Layer Text Style",
"type": "object",
"properties": {
"range": {
"$ref": "#/components/schemas/LayerTextStyleRange"
},
"style": {
"$ref": "#/components/schemas/TextStyleData"
}
},
"example": {
"$ref": "#/components/examples/layerTextStyle"
}
},
"LayerTextStyleRange": {
"title": "Layer Text Style Range",
"type": "object",
"properties": {
"location": {
"type": "number",
"description": "Start of the range"
},
"length": {
"type": "number",
"description": "Length of the range"
}
},
"example": {
"$ref": "#/components/examples/layerTextStyle"
}
},
"Asset": {
"title": "Asset",
"type": "object",
"description": "Assets are automatically generated while exporting designs based on the platform the design is exported. Asset formats and densities change according to these platforms.\n\nPlatform | Formats\n---|---|---\nBase | PNG (1.0, 1.5, 2.0, 3.0, 4.0), and PDF\nWeb | PNG (1.0, 2.0, 3.0), SVG, and JPG (bitmap image)\niOS | PNG (1.0, 2.0, 3.0), and PDF\nAndroid | PNG (1.0, 1.5, 2.0, 3.0, 4.0), and SVG\n",
"required": [
"display_name",
"contents"
],
"properties": {
"layer_source_id": {
"type": "string",
"description": "Layer's identifier in the design tool"
},
"display_name": {
"type": "string",
"description": "Display name of the asset"
},
"layer_name": {
"type": "string",
"description": "Name of the layer containing the asset"
},
"contents": {
"type": "array",
"items": {
"$ref": "#/components/schemas/AssetContent"
}
}
},
"example": {
"$ref": "#/components/examples/asset"
}
},
"AssetContent": {
"title": "Asset Content",
"type": "object",
"required": [
"url",
"format"
],
"properties": {
"url": {
"type": "string",
"description": "URL of the asset content"
},
"format": {
"type": "string",
"description": "Format of the asset content",
"enum": [
"png",
"jpg",
"svg",
"pdf"
]
},
"density": {
"type": "number",
"description": "Density of the asset content",
"enum": [
1,
1.5,
2,
3,
4
]
}
},
"example": {
"$ref": "#/components/examples/assetContent"
}
},
"EntityReference": {
"title": "Object Reference",
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Id of the entity"
}
},
"example": {
"$ref": "#/components/examples/entityReference"
}
},
"ErrorResponse": {
"title": "Error Response",
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string",
"description": "A user readable descriptive message for the error"
},
"detail": {
"type": "string",
"description": "A detailed message describing the error"
},
"code": {
"type": "string",
"description": "The unique code for the error"
}
},
"example": {
"$ref": "#/components/examples/error"
}
},
"ScreenNoteComment": {
"title": "Screen Note Comment",
"type": "object",
"required": [
"id",
"content",
"author",
"updated",
"reactions"
],
"properties": {
"id": {
"type": "string",
"description": "Unique id of the comment"
},
"content": {
"type": "string",
"description": "Content of the comment"
},
"author": {
"$ref": "#/components/schemas/User"
},
"updated": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the comment was updated"
},
"reactions": {
"type": "array",
"description": "Reactions to the comment",
"items": {
"$ref": "#/components/schemas/Reaction"
}
},
"screen_version_id": {
"type": "string",
"description": "The version of the screen this comment is associated with"
}
},
"example": {
"$ref": "#/components/examples/screenNoteComment"
}
},
"UserWebhook": {
"title": "User Webhook",
"type": "object",
"required": [
"id",
"url",
"status",
"url_health",
"created",
"updated",
"created_by",
"updated_by",
"events",
"project_ids",
"styleguide_ids"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the webhook"
},
"url": {
"type": "string",
"description": "The URL of the webhook"
},
"name": {
"type": "string",
"description": "The name of the webhook"
},
"status": {
"$ref": "#/components/schemas/WebhookStatusEnum"
},
"url_health": {
"$ref": "#/components/schemas/WebhookHealthEnum"
},
"created": {
"type": "number",
"description": "The unix timestamp when the webhook was created"
},
"updated": {
"type": "number",
"description": "The unix timestamp when the webhook was updated"
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
},
{
"description": "The user that creates the webhook"
}
]
},
"updated_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
},
{
"description": "The user that updates the webhook recently"
}
]
},
"zeplin_app": {
"allOf": [
{
"$ref": "#/components/schemas/ZeplinApplication"
},
{
"description": "The app that uses and manages the webhook"
}
]
},
"events": {
"type": "array",
"items": {
"$ref": "#/components/schemas/UserWebhookEventEnum"
},
"minItems": 1,
"uniqueItems": true,
"description": "The events of the webhook"
},
"project_ids": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true,
"description": "The project ids of the webhooks. Note: `*` wildcard denotes all project_ids"
},
"styleguide_ids": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true,
"description": "The styleguide ids of the webhooks. Note: `*` wildcard denotes all styleguide_ids"
}
},
"example": {
"$ref": "#/components/examples/webhook"
}
},
"OrganizationWebhook": {
"title": "Organization Webhook",
"type": "object",
"required": [
"id",
"url",
"status",
"url_health",
"created",
"updated",
"created_by",
"updated_by",
"events",
"project_ids",
"styleguide_ids"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the webhook"
},
"url": {
"type": "string",
"description": "The URL of the webhook"
},
"name": {
"type": "string",
"description": "The name of the webhook"
},
"status": {
"$ref": "#/components/schemas/WebhookStatusEnum"
},
"url_health": {
"$ref": "#/components/schemas/WebhookHealthEnum"
},
"created": {
"type": "number",
"description": "The unix timestamp when the webhook was created"
},
"updated": {
"type": "number",
"description": "The unix timestamp when the webhook was updated"
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
},
{
"description": "The user that creates the webhook"
}
]
},
"updated_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
},
{
"description": "The user that updates the webhook recently"
}
]
},
"zeplin_app": {
"allOf": [
{
"$ref": "#/components/schemas/ZeplinApplication"
},
{
"description": "The app that uses and manages the webhook"
}
]
},
"events": {
"type": "array",
"items": {
"$ref": "#/components/schemas/OrganizationWebhookEventEnum"
},
"minItems": 1,
"uniqueItems": true,
"description": "The events of the webhook"
},
"project_ids": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true,
"description": "The project ids of the webhooks. Note: `*` wildcard denotes all project_ids"
},
"styleguide_ids": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true,
"description": "The styleguide ids of the webhooks. Note: `*` wildcard denotes all styleguide_ids"
}
},
"example": {
"$ref": "#/components/examples/webhook"
}
},
"ProjectWebhook": {
"title": "Project Webhook",
"type": "object",
"required": [
"id",
"url",
"status",
"url_health",
"created",
"updated",
"created_by",
"updated_by",
"events"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the webhook"
},
"url": {
"type": "string",
"description": "The URL of the webhook"
},
"name": {
"type": "string",
"description": "The name of the webhook"
},
"status": {
"$ref": "#/components/schemas/WebhookStatusEnum"
},
"url_health": {
"$ref": "#/components/schemas/WebhookHealthEnum"
},
"created": {
"type": "number",
"description": "The unix timestamp when the webhook was created"
},
"updated": {
"type": "number",
"description": "The unix timestamp when the webhook was updated"
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
},
{
"description": "The user that creates the webhook"
}
]
},
"updated_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
},
{
"description": "The user that updates the webhook recently"
}
]
},
"zeplin_app": {
"allOf": [
{
"$ref": "#/components/schemas/ZeplinApplication"
},
{
"description": "The app that uses and manages the webhook"
}
]
},
"events": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ProjectWebhookEventEnum"
},
"minItems": 1,
"uniqueItems": true,
"description": "The events of the webhook"
}
},
"example": {
"$ref": "#/components/examples/projectWebhook"
}
},
"StyleguideWebhook": {
"title": "Styleguide Webhook",
"type": "object",
"required": [
"id",
"url",
"status",
"url_health",
"created",
"updated",
"created_by",
"updated_by",
"events"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the webhook"
},
"url": {
"type": "string",
"description": "The URL of the webhook"
},
"name": {
"type": "string",
"description": "The name of the webhook"
},
"status": {
"$ref": "#/components/schemas/WebhookStatusEnum"
},
"url_health": {
"$ref": "#/components/schemas/WebhookHealthEnum"
},
"created": {
"type": "number",
"description": "The unix timestamp when the webhook was created"
},
"updated": {
"type": "number",
"description": "The unix timestamp when the webhook was updated"
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
},
{
"description": "The user that creates the webhook"
}
]
},
"updated_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
},
{
"description": "The user that updates the webhook recently"
}
]
},
"zeplin_app": {
"allOf": [
{
"$ref": "#/components/schemas/ZeplinApplication"
},
{
"description": "The app that uses and manages the webhook"
}
]
},
"events": {
"type": "array",
"items": {
"$ref": "#/components/schemas/StyleguideWebhookEventEnum"
},
"minItems": 1,
"uniqueItems": true,
"description": "The events of the webhook"
}
},
"example": {
"$ref": "#/components/examples/styleguideWebhook"
}
},
"ZeplinApplication": {
"title": "Zeplin Application",
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the app"
},
"name": {
"type": "string",
"description": "The name of the app"
},
"description": {
"type": "string",
"description": "The description of the app"
},
"website": {
"type": "string",
"description": "The website of the app"
},
"logo": {
"type": "string",
"description": "The logo of the app"
}
},
"example": {
"$ref": "#/components/examples/zeplinApplication"
}
},
"Thumbnails": {
"title": "Thumbnails",
"description": "Thumbnail image URLs in various sizes. The aspect ratio of the original image is preserved. If the width of original image is lower than the desired width then the original width is used.",
"type": "object",
"required": [
"small",
"medium",
"large"
],
"properties": {
"small": {
"type": "string",
"description": "URL of the thumbnail image with a width of at most 256 pixels"
},
"medium": {
"type": "string",
"description": "URL of the thumbnail image with a width of at most 512 pixels"
},
"large": {
"type": "string",
"description": "URL of the thumbnail image with a width of at most 1024 pixels"
}
},
"example": {
"$ref": "#/components/examples/thumbnails"
}
},
"Notification": {
"title": "Notification",
"description": "Notification objects have a polymorphic structure. They can be of various types and each type has a certain set of actions that describe the notification further.\n\nNotification content (specifically `resource` and `context` fields) varies based on the value of type field. These variations and their details are described in the table below.\n\nType | Actions | Context | Resource | Description\n--| --| --| --| --\n`workspace.project` | `activated`
`archived`
`deleted`
`ownership_transferred` | - | `Project (extra: { name, platform })` | Used for changes related to projects in a workspace.\n`workspace.styleguide` | `activated`
`archived`
`deleted`
`ownership_transferred` | - | `Styleguide (extra: { name, platform })` | Used for changes related to styleguides in a workspace.\n`workspace.organization.member` | `role_updated`
`invited` | `Organization (extra: { name })` | `OrganizationMember (extra: { role })` | Used for changes related to members of a workspace.\n`project.screen` | `created`
`version_created`
`deleted` | `Project (extra: { name, platform })`
`ScreenVersion (extra: { image_url, thumbnails, width, height })` | `Screen (extra: { name })` | Used for changes related to screens in a project.\n`project.screen.note` | `created`
`mentioned` | `Project (extra: { name, platform })`
`Screen (extra: { name })`
`ScreenNoteComment (extra: { content })` | `Screen (extra: { order, color, status })` | Used for changes related to notes.\n`project.screen.note.comment` | `created`
`mentioned` | `Project (extra: { name, platform })`
`Screen (extra: { name })`
`Screen (extra: { order, color, status })` | `ScreenNoteComment (extra: { content })` | Used for changes related to note comments.\n`project.color` | `created`
`updated`
`deleted` | `Project (extra: { name, platform })` | `Color (extra: { name, r, g, b, a })` | Used for changes related to colors in a project.\n`project.text_style` | `created`
`updated`
`deleted` | `Project (extra: { name, platform })` | `TextStyle (extra: { name })` | Used for changes related to text styles in a project.\n`project.component` | `created`
`version_created`
`deleted` | `Project (extra: { name, platform })` | `Component (extra: { name })` | Used for changes related to components in a project.\n`project.spacing_token` | `created`
`updated`
`deleted` | `Project (extra: { name, platform })` | `SpacingToken (extra: { name, value })` | Used for changes related to spacing tokens in a project.\n`project.member` | `joined` | `Project (extra: { name, platform })` | | Used for changes related to members of a project.\n`project.extension` | `added`
`removed` | `Project (extra: { name, platform })` | `Extension (extra: { name })` | Used for changes related to extensions in a project.\n`project.slack_integration` | `added` | `Project (extra: { name, platform })` | `SlackIntegration (extra: { channel })` | Used for changes related to slack intgrations in a project.\n`project.jira_attachment` | `added`
`removed` | `Project (extra: { name, platform })` | `JiraIntegration (extra: { issue })` | Used for changes related to jira attachments in a project.\n`project.screen.jira_attachment` | `added`
`removed` | `Project (extra: { name, platform })`
`Screen (extra: { name })` | `JiraIntegration (extra: { issue })` | Used for changes related to jira attachments in a screen.\n`project.screen_section.jira_attachment` | `added`
`removed` | `Project (extra: { name, platform })`
`ScreenSection (extra: { name })` | `JiraIntegration (extra: { issue })` | Used for changes related to jira attachments in a screen section.\n`project.flow_board` | `added` | `Project (extra: { name, platform })` | `FlowBoard (extra: {})` | Used for changes related to flow boards in a project.\n`styleguide.color` | `created`
`updated`
`deleted` | `Styleguide (extra: { name, platform })` | `Color (extra: { name, r, g, b, a })` | Used for changes related to colors in a styleguide.\n`styleguide.text_style` | `created`
`updated`
`deleted` | `Styleguide (extra: { name, platform })` | `TextStyle (extra: { name })` | Used for changes related to text styles in a styleguide.\n`styleguide.component` | `created`
`version_created`
`deleted` | `Styleguide (extra: { name, platform })` | `Component (extra: { name })` | Used for changes related to components in a styleguide.\n`styleguide.spacing_token` | `created`
`updated`
`deleted` | `Styleguide (extra: { name, platform })` | `SpacingToken (extra: { name, value })` | Used for changes related to spacing tokens in a styleguide.\n`styleguide.member` | `joined` | `Styleguide (extra: { name, platform })` | `User (extra: { username })` | Used for changes related to members of a styleguide.\n`styleguide.extension` | `added`
`removed` | `Styleguide (extra: { name, platform })` | `Extension (extra: { name })` | Used for changes related to extensions in a styleguide.\n`styleguide.slack_integration` | `added` | `Styleguide (extra: { name, platform })` | `SlackIntegration (extra: { channel })` | Used for changes related to slack intgrations in a styleguide.\n`user.project_membership` | `invited`
`role_updated`
`removed` | - | `Project (extra: { name, platform })` | Used for changes related to notified user's membership to projects.\n`user.styleguide_membership` | `invited`
`role_updated`
`removed` | - | `Styleguide (extra: { name, platform })` | Used for changes related to notified user's membership to styleguides.\n",
"type": "object",
"required": [
"id",
"type",
"is_read",
"action",
"created",
"updated",
"context",
"actor"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the notification"
},
"type": {
"allOf": [
{
"$ref": "#/components/schemas/NotificationTypeEnum"
},
{
"description": "Type of the notification"
}
]
},
"is_read": {
"type": "boolean",
"description": "Whether the notification is read or not"
},
"action": {
"type": "string",
"description": "Action that causes the notification"
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the screen was created"
},
"updated": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the screen was updated"
},
"resource": {
"$ref": "#/components/schemas/NotificationResource"
},
"context": {
"type": "object",
"description": "Additional objects which are related to the main resource object. The content of this object changes depending on the `type` field (e.g. `{ project: { ... }, screen: { ... } }` for a screen related notification)."
},
"actor": {
"$ref": "#/components/schemas/NotificationActor"
}
},
"example": {
"$ref": "#/components/examples/notification"
}
},
"NotificationActor": {
"title": "Notification Actor",
"type": "object",
"description": "The actor of the change triggering this notification",
"required": [
"user"
],
"properties": {
"user": {
"$ref": "#/components/schemas/User",
"description": "User object"
}
},
"example": {
"$ref": "#/components/examples/notificationActor"
}
},
"NotificationResource": {
"title": "Notification Resource",
"type": "object",
"description": "The main object that this notification is related. It contains the ID of the object along with its type and partial data. The content of this object varies between notification types.",
"required": [
"id",
"type",
"extra"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the resource (e.g. `\"5ed05ecf3356a7967b21f12b\"`)"
},
"type": {
"type": "string",
"description": "Type of the object, which is one of the API models (e.g. `\"ScreenVersion\"`)"
},
"extra": {
"type": "object",
"description": "Partial data of the resource, whose content changes depending on the `type` field"
}
},
"example": {
"$ref": "#/components/examples/notificationResource"
}
},
"WorkflowStatus": {
"title": "Workflow Status",
"type": "object",
"required": [
"id",
"name",
"color"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the workflow status"
},
"name": {
"type": "string",
"description": "The name of the workflow status"
},
"color": {
"$ref": "#/components/schemas/WorkflowStatusColor"
}
},
"example": {
"$ref": "#/components/examples/workflowStatus"
}
},
"WorkflowStatusColor": {
"title": "Workflow Status Color",
"type": "object",
"required": [
"name",
"r",
"g",
"b",
"a"
],
"properties": {
"name": {
"type": "string",
"description": "The name of the color"
},
"r": {
"type": "integer",
"description": "red component of the color"
},
"g": {
"type": "integer",
"description": "green component of the color"
},
"b": {
"type": "integer",
"description": "blue component of the color"
},
"a": {
"type": "number",
"description": "alpha component of the color"
}
},
"example": {
"$ref": "#/components/examples/workflowStatusColor"
}
},
"Link": {
"title": "Link",
"type": "object",
"required": [
"rect",
"destination"
],
"properties": {
"rect": {
"$ref": "#/components/schemas/HotspotBoundingRectangle",
"description": "Bounding rectangle of the link's hotspot"
},
"destination": {
"$ref": "#/components/schemas/LinkDestination"
}
},
"example": {
"$ref": "#/components/examples/link"
}
},
"LinkDestination": {
"title": "Link Destination",
"type": "object",
"required": [
"name",
"type"
],
"properties": {
"name": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"component",
"previous"
],
"description": "Type of the link (`component` or `previous`)"
}
},
"example": {
"$ref": "#/components/examples/linkDestination"
}
},
"Grid": {
"title": "Grid",
"type": "object",
"properties": {
"horizontal_offset": {
"type": "number"
},
"vertical_offset": {
"type": "number"
},
"vertical": {
"$ref": "#/components/schemas/VerticalGrid"
},
"horizontal": {
"$ref": "#/components/schemas/HorizontalGrid"
}
},
"example": {
"$ref": "#/components/examples/grid"
}
},
"VerticalGrid": {
"title": "Vertical Grid",
"type": "object",
"required": [
"gutter_width",
"column_width",
"number_of_cols",
"gutters_on_outside"
],
"properties": {
"gutter_width": {
"type": "number"
},
"column_width": {
"type": "number"
},
"number_of_cols": {
"type": "number"
},
"gutters_on_outside": {
"type": "boolean"
}
},
"example": {
"$ref": "#/components/examples/verticalGrid"
}
},
"HorizontalGrid": {
"title": "Horizontal Grid",
"type": "object",
"required": [
"gutter_height",
"row_height"
],
"properties": {
"gutter_height": {
"type": "number"
},
"row_height": {
"type": "number"
},
"number_of_rows": {
"type": "number"
}
},
"example": {
"$ref": "#/components/examples/horizontalGrid"
}
},
"ColorDesignToken": {
"type": "object",
"title": "Color Design Token",
"required": [
"value",
"metadata"
],
"properties": {
"value": {
"type": "string",
"description": "The value of color token in `rgb(r, g, b)` or `rgba(r, g, b, a)` format."
},
"metadata": {
"$ref": "#/components/schemas/ColorDesignTokenMetadata"
}
},
"example": {
"$ref": "#/components/examples/colorDesignToken"
}
},
"ColorDesignTokenMetadata": {
"type": "object",
"title": "Color Design Token Metadata",
"required": [
"source",
"resource"
],
"properties": {
"source": {
"$ref": "#/components/schemas/DesignTokenSource",
"description": "Source of the design token\u2013either `project` or `styleguide`."
},
"resource": {
"$ref": "#/components/schemas/DesignTokenResource",
"description": "Details of the `Color` object that the design token is generated from."
}
},
"description": "Additional information about the color token",
"example": {
"$ref": "#/components/examples/colorDesignTokenMetadata"
}
},
"ColorDesignTokens": {
"title": "Color Design Tokens",
"type": "object",
"description": "Color tokens",
"additionalProperties": {
"description": "Color tokens",
"$ref": "#/components/schemas/ColorDesignToken"
},
"example": {
"$ref": "#/components/examples/colorDesignTokens"
}
},
"SpacingDesignToken": {
"type": "object",
"title": "Spacing Design Token",
"required": [
"value",
"metadata"
],
"properties": {
"value": {
"type": "number",
"description": "The value of the token"
},
"metadata": {
"$ref": "#/components/schemas/SpacingDesignTokenMetadata"
}
},
"example": {
"$ref": "#/components/examples/spacingDesignToken"
}
},
"SpacingDesignTokenMetadata": {
"title": "Spacing Design Token Metadata",
"description": "Additional information about the spacing token",
"type": "object",
"required": [
"source",
"resource",
"spacing_section"
],
"properties": {
"source": {
"$ref": "#/components/schemas/DesignTokenSource",
"description": "Source of the design token\u2013either `project` or `styleguide`."
},
"resource": {
"$ref": "#/components/schemas/DesignTokenResource",
"description": "Details of the `SpacingToken` object that the design token is generated from."
},
"spacing_section": {
"$ref": "#/components/schemas/EntityReference",
"description": "The reference of the spacing section the spacing token belongs to."
}
},
"example": {
"$ref": "#/components/examples/spacingDesignTokenMetadata"
}
},
"SpacingDesignTokens": {
"title": "Spacing Design Tokens",
"type": "object",
"description": "Spacing tokens",
"additionalProperties": {
"description": "Spacing tokens",
"$ref": "#/components/schemas/SpacingDesignToken"
},
"example": {
"$ref": "#/components/examples/spacingDesignTokens"
}
},
"TextStyleDesignToken": {
"type": "object",
"title": "Text Style Design Token",
"required": [
"value",
"metadata"
],
"properties": {
"value": {
"$ref": "#/components/schemas/TextStyleDesignTokenValue"
},
"metadata": {
"$ref": "#/components/schemas/TextStyleDesignTokenMetadata"
}
},
"example": {
"$ref": "#/components/examples/textStyleDesignToken"
}
},
"TextStyleDesignTokenMetadata": {
"title": "Text Style Design Token Metadata",
"type": "object",
"description": "Additional information about the text style token",
"required": [
"source",
"resource"
],
"properties": {
"source": {
"$ref": "#/components/schemas/DesignTokenSource",
"description": "Source of the design token\u2013either `project` or `styleguide`."
},
"resource": {
"$ref": "#/components/schemas/DesignTokenResource",
"description": "Details of the `TextStyle` object that the design token is generated from."
}
},
"example": {
"$ref": "#/components/examples/textStyleDesignTokenMetadata"
}
},
"TextStyleDesignTokenValue": {
"title": "Text Style Design Token Value",
"type": "object",
"description": "Value of the token",
"required": [
"font"
],
"properties": {
"letter_spacing": {
"type": "number",
"description": "Spacing between letters"
},
"line_height": {
"type": "number",
"description": "Minimum height of a line for the text style"
},
"alignment": {
"type": "string",
"description": "Horizontal alignment of the text style, `left`, `right`, `center`, or `justify`"
},
"font": {
"$ref": "#/components/schemas/DesignTokenFont"
},
"color": {
"type": "string",
"description": "The value of color in `rgb(r, g, b)` or `rgba(r, g, b, a)` format for the text style.\n\n\u261d\ufe0f*If there's a matching color token for the text style's color, the color token's value is returned as a reference, e.g. `{$colors.light-yellow.value}`.*\n"
}
},
"example": {
"$ref": "#/components/examples/textStyleDesignTokenValue"
}
},
"TextStyleDesignTokens": {
"title": "Text Style Design Tokens",
"type": "object",
"description": "Text style tokens",
"additionalProperties": {
"description": "Text style tokens",
"$ref": "#/components/schemas/TextStyleDesignToken"
},
"example": {
"$ref": "#/components/examples/textStyleDesignToken"
}
},
"DesignTokenResource": {
"title": "Design Token Resouce",
"type": "object",
"description": "Details of the resource that the design token is generated from.",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the resource"
},
"type": {
"type": "string",
"enum": [
"Color",
"TextStyle",
"SpacingToken"
],
"description": "The type of the resource"
}
},
"example": {
"$ref": "#/components/examples/designTokenResource"
}
},
"DesignTokenProject": {
"title": "Design Token Project",
"type": "object",
"description": "The source project of the token",
"required": [
"id",
"name",
"platform"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the source project"
},
"name": {
"type": "string",
"description": "The name of the source project"
},
"platform": {
"type": "string",
"enum": [
"web",
"ios",
"android",
"macos"
],
"description": "The target platform of the source project"
},
"linked_styleguide": {
"$ref": "#/components/schemas/EntityReference",
"description": "Reference of the styleguide which the source project is linked to"
}
},
"example": {
"$ref": "#/components/examples/designTokenProject"
}
},
"DesignTokenFont": {
"title": "Design Token Font",
"type": "object",
"description": "Font information for the text style",
"required": [
"family",
"size",
"weight",
"stretch"
],
"properties": {
"family": {
"type": "string",
"description": "Font family of the text style, e.g. `Roboto`, `Arial`"
},
"size": {
"type": "number",
"description": "Font size of the text style"
},
"weight": {
"type": "number",
"description": "Font weight of the text style, e.g. `500`, `700`"
},
"stretch": {
"type": "number",
"description": "Font stretch form of the text style, e.g. `0.75`, `1.00`"
}
},
"example": {
"$ref": "#/components/examples/designTokenFont"
}
},
"DesignTokenSource": {
"title": "Design Token Source",
"type": "object",
"description": "Source details for design token. It has to be either `project` or `styleguide`.",
"properties": {
"project": {
"$ref": "#/components/schemas/DesignTokenProject"
},
"styleguide": {
"$ref": "#/components/schemas/DesignTokenStyleguide"
}
},
"example": {
"$ref": "#/components/examples/designTokenSourceForProject"
},
"x-examples": {
"Project": {
"$ref": "#/components/examples/designTokenSourceForProject"
},
"Styleguide": {
"$ref": "#/components/examples/designTokenSourceForStyleguide"
}
}
},
"DesignTokenStyleguide": {
"title": "Design Token Styleguide",
"type": "object",
"description": "The source styleguide of the token",
"required": [
"id",
"name",
"platform"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the source styleguide"
},
"name": {
"type": "string",
"description": "The name of the source styleguide"
},
"platform": {
"type": "string",
"enum": [
"base",
"web",
"ios",
"android",
"macos"
],
"description": "The target platform of the source styleguide"
},
"parent": {
"$ref": "#/components/schemas/EntityReference",
"description": "Reference of the parent styleguide of the source styleguide"
}
},
"example": {
"$ref": "#/components/examples/designTokenStyleguide"
}
},
"DesignTokens": {
"title": "Design Tokens",
"type": "object",
"required": [
"colors",
"text_styles",
"spacing"
],
"properties": {
"colors": {
"$ref": "#/components/schemas/ColorDesignTokens"
},
"spacing": {
"$ref": "#/components/schemas/SpacingDesignTokens"
},
"text_styles": {
"$ref": "#/components/schemas/TextStyleDesignTokens"
}
},
"example": {
"$ref": "#/components/examples/projectDesignTokens"
},
"x-examples": {
"Project Design Tokens": {
"$ref": "#/components/examples/projectDesignTokens"
},
"Styleguide Design Tokens": {
"$ref": "#/components/examples/styleguideDesignTokens"
}
}
},
"ResourceSource": {
"title": "Resource Source",
"type": "object",
"description": "Source details for resource. It has to be either `project` or `styleguide`.",
"properties": {
"project": {
"$ref": "#/components/schemas/ResourceProjectSource"
},
"styleguide": {
"$ref": "#/components/schemas/ResourceStyleguideSource"
}
},
"example": {
"$ref": "#/components/examples/resourceSourceForProject"
},
"x-examples": {
"Project": {
"$ref": "#/components/examples/resourceSourceForProject"
},
"Styleguide": {
"$ref": "#/components/examples/resourceSourceForStyleguide"
}
}
},
"ResourceProjectSource": {
"title": "Source Project",
"type": "object",
"description": "The source project of the resource",
"required": [
"id",
"name",
"platform"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the source project"
},
"name": {
"type": "string",
"description": "The name of the source project"
},
"platform": {
"type": "string",
"enum": [
"web",
"ios",
"android",
"macos"
],
"description": "The target platform of the source project"
},
"linked_styleguide": {
"$ref": "#/components/schemas/EntityReference",
"description": "Reference of the styleguide which the source project is linked to"
}
},
"example": {
"$ref": "#/components/examples/resourceProjectSource"
}
},
"ResourceStyleguideSource": {
"title": "Source Styleguide",
"type": "object",
"description": "The source styleguide of the resource",
"required": [
"id",
"name",
"platform"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the source styleguide"
},
"name": {
"type": "string",
"description": "The name of the source styleguide"
},
"platform": {
"type": "string",
"enum": [
"base",
"web",
"ios",
"android",
"macos"
],
"description": "The target platform of the source styleguide"
},
"parent": {
"$ref": "#/components/schemas/EntityReference",
"description": "Reference of the parent styleguide of the source styleguide"
}
},
"example": {
"$ref": "#/components/examples/resourceStyleguideSource"
}
},
"ConnectedComponent": {
"title": "Connected Component",
"type": "object",
"required": [
"components",
"links"
],
"properties": {
"components": {
"description": "Components that are connected",
"type": "array",
"items": {
"$ref": "#/components/schemas/EntityReference"
}
},
"file_path": {
"type": "string",
"description": "File path of the connected component from the source code"
},
"name": {
"type": "string",
"description": "Name of the connected component"
},
"description": {
"type": "string",
"description": "Description of the connected component"
},
"code": {
"$ref": "#/components/schemas/Code"
},
"links": {
"type": "array",
"description": "Links of the connected component",
"items": {
"$ref": "#/components/schemas/ConnectedComponentLink"
}
},
"source": {
"$ref": "#/components/schemas/ResourceSource"
}
},
"example": {
"$ref": "#/components/examples/connectedComponent"
}
},
"ConnectedComponentLink": {
"title": "Connected Component Link",
"type": "object",
"required": [
"type",
"url"
],
"properties": {
"type": {
"type": "string",
"description": "Type of the link",
"enum": [
"custom",
"github",
"gitlab",
"bitbucket",
"storybook",
"styleguidist"
]
},
"url": {
"type": "string",
"description": "Url of the link"
},
"name": {
"type": "string",
"description": "Name for custom links"
}
},
"example": {
"$ref": "#/components/examples/connectedComponentLink"
},
"x-examples": {
"Link": {
"$ref": "#/components/examples/connectedComponentLink"
},
"Custom Link": {
"$ref": "#/components/examples/connectedComponentCustomLink"
}
}
},
"Code": {
"title": "Code",
"type": "object",
"required": [
"snippet"
],
"properties": {
"snippet": {
"type": "string",
"description": "The code snippet"
},
"language": {
"$ref": "#/components/schemas/LanguageEnum"
}
},
"example": {
"$ref": "#/components/examples/code"
}
},
"LanguageEnum": {
"title": "Language",
"description": "Programming language",
"type": "string",
"enum": [
"markup",
"html",
"xml",
"svg",
"css",
"clike",
"javascript",
"actionscript",
"c",
"cs",
"cpp",
"coffeescript",
"dart",
"ejs",
"elm",
"erb",
"flow",
"ftl",
"handlebars",
"java",
"kotlin",
"less",
"livescript",
"markdown",
"objectivec",
"php",
"pug",
"python",
"r",
"jsx",
"tsx",
"sass",
"scss",
"scala",
"swift",
"ts",
"velocity",
"yaml"
]
},
"SourceEnum": {
"title": "Source",
"type": "string",
"description": "Source application of the design",
"enum": [
"sketch",
"xd",
"figma",
"psd",
"bitmap"
]
},
"WebhookStatusEnum": {
"title": "Webhook Status",
"type": "string",
"enum": [
"active",
"inactive"
],
"description": "The status of the webhook"
},
"ProjectStatusEnum": {
"title": "Project Status",
"type": "string",
"enum": [
"active",
"archived"
],
"description": "The status of the project"
},
"StyleguideStatusEnum": {
"title": "Styleguide Status",
"type": "string",
"enum": [
"active",
"archived"
],
"description": "The status of the styleguide"
},
"WebhookHealthEnum": {
"title": "Webhook Health",
"type": "string",
"enum": [
"healthy",
"unhealthy"
],
"description": "The health of a webhook URL"
},
"ScreenNoteStatusEnum": {
"title": "Screen Note Status",
"type": "string",
"enum": [
"open",
"resolved"
],
"description": "Status of the note"
},
"ScreenNoteColorNameEnum": {
"title": "Screen Note Color Name",
"type": "string",
"enum": [
"yellow",
"orange",
"peach",
"green",
"turquoise",
"cornflower_blue",
"deep_purple"
]
},
"ScreenAnnotationNoteTypeEnum": {
"title": "Note Types",
"type": "string",
"enum": [
"Behavior",
"Requirement",
"Animation",
"Accessibility",
"API",
"Tracking"
],
"description": "Type of the annotation note"
},
"BlendModeEnum": {
"title": "Blend Mode",
"type": "string",
"enum": [
"normal",
"darken",
"multiply",
"color-burn",
"lighten",
"screen",
"color-dodge",
"overlay",
"soft-light",
"hard-light",
"difference",
"exclusion",
"hue",
"saturation",
"color",
"luminosity",
"source-in",
"source-out",
"source-atop",
"destination-over",
"destination-in",
"destination-out",
"destination-atop",
"dissolve",
"linear-burn",
"linear-dodge",
"darker-color",
"lighter-color",
"vivid-light",
"linear-light",
"pin-light",
"hard-mix",
"subtract",
"divide"
]
},
"ProjectWebhookEventEnum": {
"title": "Project Webhook Event Type",
"type": "string",
"enum": [
"project.*",
"project.color",
"project.component",
"project.member",
"project.note",
"project.note.comment",
"project.note.comment.reaction",
"project.screen",
"project.screen.version",
"project.spacing_token",
"project.text_style",
"project.flow_board"
]
},
"StyleguideWebhookEventEnum": {
"title": "Styleguide Webhook Event Type",
"type": "string",
"enum": [
"styleguide.*",
"styleguide.color",
"styleguide.component",
"styleguide.member",
"styleguide.spacing_token",
"styleguide.text_style"
]
},
"OrganizationWebhookEventEnum": {
"title": "Organization Webhook Event Type",
"type": "string",
"enum": [
"*",
"project.*",
"project.color",
"project.component",
"project.member",
"project.note",
"project.note.comment",
"project.note.comment.reaction",
"project.screen",
"project.screen.version",
"project.spacing_token",
"project.text_style",
"styleguide.*",
"styleguide.color",
"styleguide.component",
"styleguide.member",
"styleguide.spacing_token",
"styleguide.text_style",
"workspace.*",
"workspace.project",
"workspace.styleguide",
"workspace.organization",
"workspace.organization.member"
]
},
"UserWebhookEventEnum": {
"title": "User Webhook Event Type",
"type": "string",
"enum": [
"*",
"project.*",
"project.color",
"project.component",
"project.member",
"project.note",
"project.note.comment",
"project.note.comment.reaction",
"project.screen",
"project.screen.version",
"project.spacing_token",
"project.text_style",
"styleguide.*",
"styleguide.color",
"styleguide.component",
"styleguide.member",
"styleguide.spacing_token",
"styleguide.text_style",
"workspace.*",
"workspace.notification",
"workspace.project",
"workspace.styleguide"
]
},
"NotificationTypeEnum": {
"title": "Notification Type",
"type": "string",
"enum": [
"workspace.project",
"workspace.styleguide",
"project.extension",
"styleguide.extension",
"user.project_membership",
"user.styleguide_membership",
"project.component",
"styleguide.component",
"project.color",
"styleguide.color",
"project.screen.note",
"project.screen.note.comment",
"project.screen",
"project.text_style",
"styleguide.text_style",
"project.spacing_token",
"styleguide.spacing_token",
"project.jira_attachment",
"project.screen_section.jira_attachment",
"project.screen.jira_attachment",
"workspace.organization.member",
"project.slack_integration",
"styleguide.slack_integration",
"project.member",
"styleguide.member",
"project.flow_board"
]
},
"VariableValueTypeEnum": {
"title": "Source",
"type": "string",
"description": "Variable value types",
"enum": [
"color"
]
},
"ColorUpdateBody": {
"title": "Color Update Body",
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Name of the color"
},
"r": {
"type": "integer",
"minimum": 0,
"maximum": 255,
"description": "Red component of the color"
},
"g": {
"type": "integer",
"minimum": 0,
"maximum": 255,
"description": "Green component of the color"
},
"b": {
"type": "integer",
"minimum": 0,
"maximum": 255,
"description": "Blue component of the color"
},
"a": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Alpha component of the color"
}
}
},
"ColorCreateBody": {
"title": "Color Create Body",
"required": [
"name",
"r",
"g",
"b",
"a"
],
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Name of the color"
},
"source_id": {
"type": "string",
"description": "Color's identifier in the design tool"
},
"r": {
"type": "integer",
"minimum": 0,
"maximum": 255,
"description": "Red component of the color"
},
"g": {
"type": "integer",
"minimum": 0,
"maximum": 255,
"description": "Green component of the color"
},
"b": {
"type": "integer",
"minimum": 0,
"maximum": 255,
"description": "Blue component of the color"
},
"a": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Alpha component of the color"
}
}
},
"CommentCreateBody": {
"title": "Comment Create Body",
"type": "object",
"properties": {
"content": {
"type": "string",
"description": "Content of the comment"
}
},
"required": [
"content"
]
},
"CommentUpdateBody": {
"title": "Comment Update Body",
"type": "object",
"properties": {
"content": {
"type": "string",
"description": "Content of the comment"
}
},
"required": [
"content"
]
},
"ComponentUpdateBody": {
"title": "Component Update Body",
"required": [
"description"
],
"type": "object",
"properties": {
"description": {
"type": "string",
"description": "New description for component"
}
}
},
"TokenCreateBody": {
"title": "Token Create Body",
"discriminator": {
"propertyName": "grant_type",
"mapping": {
"authorization_code": "#/components/schemas/TokenCreateAuthorizationCodeBody",
"refresh_token": "#/components/schemas/TokenCreateRefreshTokenBody"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/TokenCreateAuthorizationCodeBody"
},
{
"$ref": "#/components/schemas/TokenCreateRefreshTokenBody"
}
]
},
"TokenCreateAuthorizationCodeBody": {
"title": "Authorization code flow",
"type": "object",
"required": [
"grant_type",
"code",
"redirect_uri",
"client_id"
],
"properties": {
"grant_type": {
"type": "string",
"enum": [
"authorization_code"
]
},
"code": {
"type": "string",
"description": "Applies when `grant_type` is `authorization_code`. The `code` obtained after `authorization` request"
},
"redirect_uri": {
"type": "string",
"description": "The URL where users will be redirected after authorization"
},
"client_id": {
"type": "string",
"description": "The `client_id` of your Zeplin app"
},
"client_secret": {
"type": "string",
"description": "The `client_secret` of your Zeplin app\n\n**Note**: `client_secret` is required for `code` values obtained without using a PKCE `code_challenge` value.\n\n**Warning**: `client_secret` property should only be used in a server-side application. \nIf your Zeplin app is a public client, you should use PKCE authorization flow.\n"
},
"code_verifier": {
"type": "string",
"description": "A cryptographically random string that is used to correlate the authorization request to the token request"
}
}
},
"TokenCreateRefreshTokenBody": {
"title": "Refresh token flow",
"type": "object",
"required": [
"grant_type",
"refresh_token",
"client_id"
],
"properties": {
"grant_type": {
"type": "string",
"enum": [
"refresh_token"
]
},
"refresh_token": {
"type": "string",
"description": "Applies when `grant_type` is `refresh_token`. The `refresh_token` you obtained while generating the access token in the first place"
},
"client_id": {
"type": "string",
"description": "The `client_id` of your Zeplin app"
},
"client_secret": {
"type": "string",
"description": "The `client_secret` of your Zeplin app\n\n**Note**: `client_secret` is required for `code` values obtained without using a PKCE `code_challenge` value.\n\n**Warning**: `client_secret` property should only be used in a server-side application. \nIf your Zeplin app is a public client, you should use PKCE authorization flow.\n"
},
"code_verifier": {
"type": "string",
"description": "A cryptographically random string that is used to correlate the authorization request to the token request"
}
}
},
"OrganizationMemberInviteBody": {
"title": "Organization Member Invite Body",
"type": "object",
"properties": {
"handle": {
"type": "string",
"description": "Email, username or unique identifier of the user"
},
"tags": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string"
},
"description": "Tags of the user in the organization"
},
"role": {
"type": "string",
"enum": [
"admin",
"editor",
"member",
"alien"
],
"description": "The role of the user in the organization\n\n\u261d\ufe0fNote that the Developer role maps to `member` and the Reviewer role maps to `alien` in the API.\n"
},
"restricted": {
"type": "boolean",
"description": "Whether the user's membership is restricted to only the projects that they are member of"
}
},
"required": [
"handle",
"role",
"restricted"
]
},
"OrganizationMemberUpdateBody": {
"title": "Organization Member Update Body",
"type": "object",
"properties": {
"tags": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string"
},
"description": "Tags of the user in the organization"
},
"role": {
"type": "string",
"enum": [
"admin",
"editor",
"member",
"alien"
],
"description": "The role of the user in the organization\n\n\u261d\ufe0fNote that the Developer role maps to `member` and the Reviewer role maps to `alien` in the API.\n"
},
"restricted": {
"type": "boolean",
"description": "Whether the user's membership is restricted to only the"
}
}
},
"ProjectMemberInviteBody": {
"title": "Project Member Invite Body",
"type": "object",
"properties": {
"handle": {
"type": "string",
"description": "Email, username or unique identifier of the user\n\nCan also be `\"me\"` for joining the project as the current user\n"
}
},
"required": [
"handle"
]
},
"StyleguideMemberInviteBody": {
"title": "Styleguide Member Invite Body",
"type": "object",
"properties": {
"handle": {
"type": "string",
"description": "Email, username or unique identifier of the user\n\nCan also be `\"me\"` for joining the styleguide as the current user\n"
}
},
"required": [
"handle"
]
},
"ScreenCreateBody": {
"title": "Screen Create Body",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name of the screen"
},
"image": {
"type": "string",
"format": "binary",
"description": "Binary data of the screen image.\n\nThe image has to be in JPEG or PNG format, and its size cannot exceed 5MB.\n",
"x-valid-types": [
"jpeg",
"png"
]
},
"description": {
"type": "string",
"description": "Description for the screen"
},
"commit_message": {
"type": "string",
"description": "Commit message for the screen version"
},
"commit_color": {
"type": "string",
"enum": [
"yellow",
"orange",
"peach",
"green",
"turquoise"
],
"description": "Commit color for the screen version"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags for the screen"
},
"section_id": {
"type": "string",
"description": "Unique id of the screen section"
}
},
"required": [
"name",
"image"
]
},
"ScreenVersionCreateBody": {
"title": "Screen Version Create Body",
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "binary",
"description": "Binary data of the screen image.\n\nThe image has to be in JPEG or PNG format, and its size cannot exceed 5MB.\n",
"x-valid-types": [
"jpeg",
"png"
]
},
"commit_message": {
"type": "string",
"description": "Commit message for the screen version"
},
"commit_color": {
"type": "string",
"enum": [
"yellow",
"orange",
"peach",
"green",
"turquoise"
],
"description": "Commit color for the screen version"
}
},
"required": [
"image"
]
},
"ScreenNoteCreateBody": {
"title": "Screen Note Create Body",
"type": "object",
"properties": {
"content": {
"type": "string",
"description": "Content of the first comment of the note"
},
"position": {
"title": "position",
"$ref": "#/components/schemas/ScreenNotePosition"
},
"color": {
"$ref": "#/components/schemas/ScreenNoteColorNameEnum"
}
},
"required": [
"content",
"position",
"color"
]
},
"ScreenNoteUpdateBody": {
"title": "Screen Note Update Body",
"type": "object",
"properties": {
"status": {
"title": "status",
"$ref": "#/components/schemas/ScreenNoteStatusEnum"
},
"position": {
"title": "position",
"$ref": "#/components/schemas/ScreenNotePosition"
},
"color": {
"title": "color",
"$ref": "#/components/schemas/ScreenNoteColorNameEnum"
}
}
},
"ScreenAnnotationCreateBody": {
"title": "Screen Annotation Create Body",
"type": "object",
"properties": {
"content": {
"type": "string",
"description": "Content of the annotation"
},
"position": {
"$ref": "#/components/schemas/ScreenAnnotationPosition"
},
"type": {
"type": "string",
"description": "The unique id of the annotation type"
}
},
"required": [
"content",
"position"
]
},
"ScreenAnnotationUpdateBody": {
"title": "Screen Annotation Update Body",
"type": "object",
"properties": {
"content": {
"type": "string",
"description": "Content of the annotation"
},
"position": {
"$ref": "#/components/schemas/ScreenAnnotationPosition"
},
"type": {
"type": "string",
"description": "The unique id of the annotation type"
}
}
},
"SpacingTokenUpdateBody": {
"title": "Spacing Token Update Body",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the token"
},
"value": {
"type": "number",
"description": "The value of the token"
}
}
},
"OrganizationWebhookCreateBody": {
"title": "Organization Webhook Create Body",
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The URL of the webhook"
},
"name": {
"type": "string",
"description": "The name of the webhook"
},
"secret": {
"type": "string",
"description": "The secret to be used to generate signatures for webhook requests"
},
"status": {
"title": "status",
"allOf": [
{
"$ref": "#/components/schemas/WebhookStatusEnum"
},
{
"default": "active"
}
]
},
"project_ids": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true,
"description": "The project ids of the webhook"
},
"styleguide_ids": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true,
"description": "The styleguide ids of the webhook"
},
"events": {
"type": "array",
"uniqueItems": true,
"items": {
"$ref": "#/components/schemas/OrganizationWebhookEventEnum"
},
"minItems": 1,
"description": "The events of the webhook"
}
},
"required": [
"events",
"project_ids",
"styleguide_ids",
"url",
"secret"
]
},
"OrganizationWebhookUpdateBody": {
"title": "Organization Webhook Update Body",
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The URL of the webhook"
},
"name": {
"type": "string",
"description": "The name of the webhook"
},
"secret": {
"type": "string",
"description": "The secret to be used to generate signatures for webhook requests"
},
"status": {
"title": "status",
"$ref": "#/components/schemas/WebhookStatusEnum"
},
"project_ids": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true,
"description": "The project ids of the webhook"
},
"styleguide_ids": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true,
"description": "The styleguide ids of the webhook"
},
"events": {
"type": "array",
"uniqueItems": true,
"items": {
"$ref": "#/components/schemas/OrganizationWebhookEventEnum"
},
"minItems": 1,
"description": "The events of the webhook"
}
}
},
"ProjectWebhookCreateBody": {
"title": "Project Webhook Create Body",
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The URL of the webhook"
},
"name": {
"type": "string",
"description": "The name of the webhook"
},
"secret": {
"type": "string",
"description": "The secret to be used to generate signatures for webhook requests"
},
"status": {
"title": "status",
"allOf": [
{
"$ref": "#/components/schemas/WebhookStatusEnum"
},
{
"default": "active"
}
]
},
"events": {
"type": "array",
"uniqueItems": true,
"items": {
"$ref": "#/components/schemas/ProjectWebhookEventEnum"
},
"minItems": 1,
"description": "The events of the webhook"
}
},
"required": [
"events",
"url",
"secret"
]
},
"ProjectWebhookUpdateBody": {
"title": "Project Webhook Update Body",
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The URL of the webhook"
},
"name": {
"type": "string",
"description": "The name of the webhook"
},
"secret": {
"type": "string",
"description": "The secret to be used to generate signatures for webhook requests"
},
"status": {
"title": "status",
"$ref": "#/components/schemas/WebhookStatusEnum"
},
"events": {
"type": "array",
"uniqueItems": true,
"items": {
"$ref": "#/components/schemas/ProjectWebhookEventEnum"
},
"minItems": 1,
"description": "The events of the webhook"
}
}
},
"StyleguideWebhookCreateBody": {
"title": "Styleguide Webhook Create Body",
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The URL of the webhook"
},
"name": {
"type": "string",
"description": "The name of the webhook"
},
"secret": {
"type": "string",
"description": "The secret to be used to generate signatures for webhook requests"
},
"status": {
"title": "status",
"allOf": [
{
"$ref": "#/components/schemas/WebhookStatusEnum"
},
{
"default": "active"
}
]
},
"events": {
"type": "array",
"uniqueItems": true,
"items": {
"$ref": "#/components/schemas/StyleguideWebhookEventEnum"
},
"minItems": 1,
"description": "The events of the webhook"
}
},
"required": [
"events",
"url",
"secret"
]
},
"StyleguideWebhookUpdateBody": {
"title": "Styleguide Webhook Update Body",
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The URL of the webhook"
},
"name": {
"type": "string",
"description": "The name of the webhook"
},
"secret": {
"type": "string",
"description": "The secret to be used to generate signatures for webhook requests"
},
"status": {
"title": "status",
"$ref": "#/components/schemas/WebhookStatusEnum"
},
"events": {
"type": "array",
"uniqueItems": true,
"items": {
"$ref": "#/components/schemas/StyleguideWebhookEventEnum"
},
"minItems": 1,
"description": "The events of the webhook"
}
}
},
"UserWebhookCreateBody": {
"title": "User Webhook Create Body",
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The URL of the webhook"
},
"name": {
"type": "string",
"description": "The name of the webhook"
},
"secret": {
"type": "string",
"description": "The secret to be used to generate signatures for webhook requests"
},
"status": {
"title": "status",
"allOf": [
{
"$ref": "#/components/schemas/WebhookStatusEnum"
},
{
"default": "active"
}
]
},
"project_ids": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true,
"description": "The project ids of the webhook"
},
"styleguide_ids": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true,
"description": "The styleguide ids of the webhook"
},
"events": {
"type": "array",
"uniqueItems": true,
"items": {
"$ref": "#/components/schemas/UserWebhookEventEnum"
},
"minItems": 1,
"description": "The events of the webhook"
}
},
"required": [
"events",
"project_ids",
"styleguide_ids",
"url",
"secret"
]
},
"UserWebhookUpdateBody": {
"title": "User Webhook Update Body",
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The URL of the webhook"
},
"name": {
"type": "string",
"description": "The name of the webhook"
},
"secret": {
"type": "string",
"description": "The secret to be used to generate signatures for webhook requests"
},
"status": {
"title": "status",
"$ref": "#/components/schemas/WebhookStatusEnum"
},
"project_ids": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true,
"description": "The project ids of the webhook"
},
"styleguide_ids": {
"type": "array",
"items": {
"type": "string"
},
"uniqueItems": true,
"description": "The styleguide ids of the webhook"
},
"events": {
"type": "array",
"uniqueItems": true,
"items": {
"$ref": "#/components/schemas/UserWebhookEventEnum"
},
"minItems": 1,
"description": "The events of the webhook"
}
}
},
"NotificationUpdateBody": {
"title": "Notifications Update Body",
"type": "object",
"required": [
"is_read"
],
"properties": {
"is_read": {
"type": "boolean",
"description": "New is_read status for notifications"
}
}
},
"ProjectUpdateBody": {
"title": "Project Update Body",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "New name for the project"
},
"description": {
"type": "string",
"description": "New description for the project"
},
"workflow_status_id": {
"type": "string",
"description": "Id of the new workflow status for the project"
},
"linked_styleguide_id": {
"type": "string",
"nullable": true,
"description": "The unique id of the styleguide to be linked. Set null to unlink the linked styleguide."
}
}
},
"ScreenUpdateBody": {
"title": "Screen Update Body",
"type": "object",
"properties": {
"description": {
"type": "string",
"description": "New description for screen"
},
"tags": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string"
},
"description": "New tags for the screen"
}
}
},
"StyleguideUpdateBody": {
"title": "Styleguide Update Body",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "New name for the styleguide"
},
"description": {
"type": "string",
"description": "New description for the styleguide"
},
"linked_parent_styleguide_id": {
"type": "string",
"nullable": true,
"description": "The unique id of the styleguide to be linked as parent. Set null to unlink the linked parent styleguide."
}
}
},
"TextStyleUpdateBody": {
"title": "Text Style Update Body",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name of the text style"
},
"color": {
"title": "color",
"$ref": "#/components/schemas/ColorData"
}
}
},
"FlowBoard": {
"title": "Flow Board",
"type": "object",
"required": [
"id",
"name",
"number_of_connectors",
"number_of_nodes",
"number_of_groups"
],
"properties": {
"id": {
"type": "string",
"description": "Identifier of the board"
},
"name": {
"type": "string",
"description": "Name of the board"
},
"number_of_connectors": {
"type": "integer",
"description": "Number of connectors in the board"
},
"number_of_nodes": {
"type": "integer",
"description": "Number of nodes in the board"
},
"number_of_groups": {
"type": "integer",
"description": "Number of groups in the board"
}
},
"example": {
"$ref": "#/components/examples/flowBoard"
}
},
"FlowBoardGroup": {
"title": "Flow Board Group",
"type": "object",
"required": [
"id",
"created",
"name",
"color"
],
"properties": {
"id": {
"type": "string",
"description": "Identifier of the flow board group"
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the color was created"
},
"name": {
"type": "string",
"description": "Name of the flow board"
},
"color": {
"$ref": "#/components/schemas/ColorData"
}
},
"example": {
"$ref": "#/components/examples/flowBoardGroup"
}
},
"FlowBoardConnector": {
"title": "Flow Board Connector",
"type": "object",
"required": [
"id",
"type",
"start",
"end"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the connector"
},
"type": {
"type": "string",
"enum": [
"SolidLine",
"DashedLine"
]
},
"start": {
"$ref": "#/components/schemas/FlowBoardConnection"
},
"end": {
"$ref": "#/components/schemas/FlowBoardConnection"
},
"label": {
"$ref": "#/components/schemas/FlowBoardConnectorLabel"
},
"color": {
"type": "string",
"enum": [
"yellow",
"orange",
"peach",
"green",
"turquoise"
],
"description": "Color for the connector"
}
},
"example": {
"$ref": "#/components/examples/flowBoardConnector"
}
},
"FlowBoardConnectionPosition": {
"title": "Flow Board Connection Position",
"type": "object",
"required": [
"dot_index",
"side"
],
"properties": {
"dot_index": {
"type": "number"
},
"side": {
"type": "string",
"enum": [
"left",
"right",
"bottom",
"top"
]
}
},
"example": {
"$ref": "#/components/examples/flowBoardConnectionPosition"
}
},
"FlowBoardConnection": {
"title": "Flow Board Connection",
"type": "object",
"required": [
"node"
],
"properties": {
"node": {
"$ref": "#/components/schemas/EntityReference"
},
"style": {
"type": "string",
"enum": [
"arrow",
"point"
]
},
"layer_source_id": {
"type": "string",
"description": "Layer's identifier in the design tool"
},
"connection_position": {
"$ref": "#/components/schemas/FlowBoardConnectionPosition"
}
},
"example": {
"$ref": "#/components/examples/flowBoardConnection"
}
},
"FlowBoardConnectorLabel": {
"title": "Flow Board Connector Label",
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "Text for the connector label"
},
"position": {
"type": "number",
"description": "Percentage based position of the connector label"
},
"width": {
"type": "number",
"description": "Width of the connector label"
}
},
"example": {
"$ref": "#/components/examples/flowBoardConnectorLabel"
}
},
"FlowBoardNode": {
"title": "Flow Board Node",
"discriminator": {
"propertyName": "type",
"mapping": {
"ScreenNode": "#/components/schemas/FlowBoardScreenNode",
"TextLabelNode": "#/components/schemas/FlowBoardTextNode",
"VariantGroupNode": "#/components/schemas/FlowBoardVariantGroupNode",
"ShapeNode": "#/components/schemas/FlowBoardShapeNode",
"AnnotationNode": "#/components/schemas/FlowBoardAnnotationNode"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/FlowBoardScreenNode"
},
{
"$ref": "#/components/schemas/FlowBoardTextNode"
},
{
"$ref": "#/components/schemas/FlowBoardVariantGroupNode"
},
{
"$ref": "#/components/schemas/FlowBoardShapeNode"
},
{
"$ref": "#/components/schemas/FlowBoardAnnotationNode"
}
],
"x-examples": {
"Board Screen Node": {
"$ref": "#/components/examples/flowBoardScreenNode"
},
"Board Text Node": {
"$ref": "#/components/examples/flowBoardTextNode"
},
"Board Variant Group Node": {
"$ref": "#/components/examples/flowBoardVariantGroupNode"
},
"Board Shape Node": {
"$ref": "#/components/examples/flowBoardShapeNode"
},
"Board Annotation Node": {
"$ref": "#/components/examples/flowBoardAnnotationNode"
}
}
},
"FlowBoardScreenNode": {
"title": "Flow Board Screen Node",
"type": "object",
"required": [
"id",
"type",
"position",
"screen"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the screen node"
},
"type": {
"type": "string",
"enum": [
"ScreenNode"
]
},
"position": {
"$ref": "#/components/schemas/FlowBoardPosition"
},
"screen": {
"$ref": "#/components/schemas/EntityReference"
}
},
"example": {
"$ref": "#/components/examples/flowBoardScreenNode"
}
},
"FlowBoardTextNode": {
"title": "Flow Board Text Node",
"type": "object",
"required": [
"id",
"type",
"position",
"text",
"width"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the text node"
},
"type": {
"type": "string",
"enum": [
"TextLabelNode"
]
},
"position": {
"$ref": "#/components/schemas/FlowBoardPosition"
},
"text": {
"type": "string"
},
"width": {
"type": "number"
}
},
"example": {
"$ref": "#/components/examples/flowBoardTextNode"
}
},
"FlowBoardShapeNode": {
"title": "Flow Board Shape Node",
"type": "object",
"required": [
"id",
"type",
"shape_type",
"position",
"text",
"width",
"height",
"color"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the shape node"
},
"type": {
"type": "string",
"enum": [
"ShapeNode"
]
},
"shape_type": {
"type": "string",
"enum": [
"rectangle",
"pill",
"diamond"
]
},
"position": {
"$ref": "#/components/schemas/FlowBoardPosition"
},
"text": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"color": {
"$ref": "#/components/schemas/FlowBoardNodeColor"
}
},
"example": {
"$ref": "#/components/examples/flowBoardShapeNode"
}
},
"FlowBoardVariantGroupNode": {
"title": "Flow Board Variant Group Node",
"type": "object",
"required": [
"id",
"type",
"position",
"variant_group",
"default_variant"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the variant group node"
},
"type": {
"type": "string",
"enum": [
"VariantGroupNode"
]
},
"position": {
"$ref": "#/components/schemas/FlowBoardPosition"
},
"variant_group": {
"$ref": "#/components/schemas/EntityReference"
},
"default_variant": {
"$ref": "#/components/schemas/EntityReference"
}
},
"example": {
"$ref": "#/components/examples/flowBoardVariantGroupNode"
}
},
"FlowBoardAnnotationNode": {
"title": "Flow Board Annotation Node",
"type": "object",
"required": [
"id",
"type",
"position",
"width",
"height",
"color",
"font_size",
"font_type",
"text"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the screen node"
},
"type": {
"type": "string",
"enum": [
"AnnotationNode"
]
},
"position": {
"$ref": "#/components/schemas/FlowBoardPosition"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"color": {
"$ref": "#/components/schemas/FlowBoardNodeColor"
},
"font_size": {
"type": "string",
"enum": [
"small",
"medium",
"large",
"xlarge"
]
},
"font_type": {
"type": "string",
"enum": [
"simple",
"book-style",
"technical",
"handwritten"
]
},
"text": {
"type": "string",
"description": "The text content of the annotation"
},
"note_type": {
"$ref": "#/components/schemas/ScreenAnnotationNoteType"
}
},
"example": {
"$ref": "#/components/examples/flowBoardAnnotationNode"
}
},
"FlowBoardPosition": {
"title": "Flow Board Position",
"type": "object",
"required": [
"x",
"y"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
}
},
"example": {
"$ref": "#/components/examples/flowBoardPosition"
}
},
"FlowBoardNodeColor": {
"title": "Flow Board Node Color",
"type": "object",
"required": [
"r",
"g",
"b",
"a"
],
"properties": {
"r": {
"type": "integer",
"description": "Red component of the color"
},
"g": {
"type": "integer",
"description": "Green component of the color"
},
"b": {
"type": "integer",
"description": "Blue component of the color"
},
"a": {
"type": "number",
"description": "Alpha component of the color"
}
},
"example": {
"$ref": "#/components/examples/flowBoardNodeColor"
}
},
"VariableInfo": {
"title": "Variable Info",
"type": "object",
"required": [
"source_id",
"collection_source_id"
],
"properties": {
"source_id": {
"type": "string",
"description": "The source id of the variable"
},
"collection_source_id": {
"type": "string",
"description": "The source id of the collection that the variable belongs to"
}
},
"example": {
"$ref": "#/components/examples/variableInfo"
}
},
"VariableCollection": {
"title": "Variable Collection",
"type": "object",
"required": [
"id",
"created",
"name",
"modes",
"groups",
"source_id"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the variable collection"
},
"created": {
"type": "integer",
"format": "timestamp",
"description": "The unix timestamp when the variable collection was created"
},
"name": {
"type": "string",
"description": "The name of the variable collection"
},
"description": {
"type": "string",
"description": "The description of the variable collection"
},
"modes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/VariableMode"
}
},
"groups": {
"type": "array",
"items": {
"$ref": "#/components/schemas/VariableGroup"
}
},
"source_id": {
"type": "string",
"description": "Variable collection's identifier in the design tool"
},
"source": {
"$ref": "#/components/schemas/ResourceSource",
"description": "Source of the variable collection - either `project` or `styleguide`."
}
},
"example": {
"$ref": "#/components/examples/variableCollection"
}
},
"VariableMode": {
"title": "Variable Mode",
"type": "object",
"required": [
"id",
"name",
"mode_id"
],
"properties": {
"id": {
"type": "string",
"description": "Identifier of the mode"
},
"name": {
"type": "string",
"description": "Name of the mode"
},
"mode_id": {
"type": "string",
"description": "Mode's identifier in the design tool"
}
},
"example": {
"$ref": "#/components/examples/variableMode"
}
},
"VariableGroup": {
"title": "Variable Group",
"type": "object",
"required": [
"id",
"name",
"variables"
],
"properties": {
"id": {
"type": "string",
"description": "Identifier of the color"
},
"name": {
"type": "string",
"description": "Name of the color"
},
"description": {
"type": "string",
"description": "Description of the color"
},
"parent": {
"type": "string",
"description": "Parent group of the group"
},
"variables": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Variable"
}
}
},
"example": {
"$ref": "#/components/examples/variableGroup"
}
},
"VariableValue": {
"title": "Variable value",
"type": "object",
"required": [
"mode_id",
"type",
"color"
],
"properties": {
"mode_id": {
"type": "string",
"description": "Mode id of the variable value"
},
"type": {
"$ref": "#/components/schemas/VariableValueTypeEnum",
"description": "Type of the variable value"
},
"color": {
"$ref": "#/components/schemas/ColorData",
"description": "Color value of the variable"
}
},
"example": {
"$ref": "#/components/examples/variableValue"
}
},
"Variable": {
"title": "Variable",
"type": "object",
"required": [
"id",
"name",
"source_id",
"values"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the variable"
},
"name": {
"type": "string",
"description": "The name of the variable"
},
"description": {
"type": "string",
"description": "The description of the variable"
},
"source_id": {
"type": "string",
"description": "Variable's identifier in the design tool"
},
"values": {
"type": "array",
"items": {
"$ref": "#/components/schemas/VariableValue"
}
}
},
"example": {
"$ref": "#/components/examples/variable"
}
},
"Page": {
"title": "Page",
"type": "object",
"required": [
"id",
"name",
"type",
"componentSections"
],
"properties": {
"id": {
"type": "string",
"description": "The unique id of the page"
},
"name": {
"type": "string",
"description": "The name of the page"
},
"type": {
"type": "string",
"description": "The type of the page"
},
"description": {
"type": "string",
"description": "The description of the page"
},
"componentSections": {
"type": "array",
"description": "Array of component section IDs",
"items": {
"type": "string"
}
}
},
"example": {
"$ref": "#/components/examples/page"
}
},
"Reaction": {
"title": "Reaction",
"type": "object",
"required": [
"id",
"short_code",
"users"
],
"properties": {
"id": {
"type": "string",
"description": "Unique id of the reaction"
},
"short_code": {
"type": "string",
"description": "Type of the reaction (e.g., thumbsup, eyes, etc.)"
},
"unicode": {
"type": "string",
"description": "Unicode representation of the reaction"
},
"users": {
"type": "array",
"items": {
"$ref": "#/components/schemas/User"
}
}
},
"example": {
"$ref": "#/components/examples/reaction"
}
},
"WebhookEvent": {
"title": "Webhook Event",
"discriminator": {
"propertyName": "event",
"mapping": {
"ping": "#/components/schemas/PingEvent",
"workspace.notification": "#/components/schemas/WorkspaceNotificationEvent",
"workspace.project": "#/components/schemas/WorkspaceProjectEvent",
"workspace.styleguide": "#/components/schemas/WorkspaceStyleguideEvent",
"workspace.organization": "#/components/schemas/WorkspaceOrganizationEvent",
"workspace.organization.member": "#/components/schemas/WorkspaceOrganizationMemberEvent",
"project.member": "#/components/schemas/ProjectMemberEvent",
"project.screen": "#/components/schemas/ProjectScreenEvent",
"project.screen.version": "#/components/schemas/ProjectScreenVersionEvent",
"project.note": "#/components/schemas/ProjectNoteEvent",
"project.note.comment": "#/components/schemas/ProjectNoteCommentEvent",
"project.note.comment.reaction": "#/components/schemas/ProjectNoteCommentReactionEvent",
"project.color": "#/components/schemas/ProjectColorEvent",
"project.flow_board": "#/components/schemas/ProjectFlowBoardEvent",
"project.text_style": "#/components/schemas/ProjectTextStyleEvent",
"project.component": "#/components/schemas/ProjectComponentEvent",
"project.spacing_token": "#/components/schemas/ProjectSpacingTokenEvent",
"styleguide.member": "#/components/schemas/StyleguideMemberEvent",
"styleguide.color": "#/components/schemas/StyleguideColorEvent",
"styleguide.text_style": "#/components/schemas/StyleguideTextStyleEvent",
"styleguide.component": "#/components/schemas/StyleguideComponentEvent",
"styleguide.spacing_token": "#/components/schemas/StyleguideSpacingTokenEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/WorkspaceNotificationEvent"
},
{
"$ref": "#/components/schemas/WorkspaceProjectEvent"
},
{
"$ref": "#/components/schemas/WorkspaceStyleguideEvent"
},
{
"$ref": "#/components/schemas/WorkspaceOrganizationEvent"
},
{
"$ref": "#/components/schemas/WorkspaceOrganizationMemberEvent"
},
{
"$ref": "#/components/schemas/ProjectMemberEvent"
},
{
"$ref": "#/components/schemas/ProjectScreenEvent"
},
{
"$ref": "#/components/schemas/ProjectScreenVersionEvent"
},
{
"$ref": "#/components/schemas/ProjectNoteEvent"
},
{
"$ref": "#/components/schemas/ProjectNoteCommentEvent"
},
{
"$ref": "#/components/schemas/ProjectNoteCommentReactionEvent"
},
{
"$ref": "#/components/schemas/ProjectColorEvent"
},
{
"$ref": "#/components/schemas/ProjectFlowBoardEvent"
},
{
"$ref": "#/components/schemas/ProjectTextStyleEvent"
},
{
"$ref": "#/components/schemas/ProjectComponentEvent"
},
{
"$ref": "#/components/schemas/ProjectSpacingTokenEvent"
},
{
"$ref": "#/components/schemas/StyleguideMemberEvent"
},
{
"$ref": "#/components/schemas/StyleguideColorEvent"
},
{
"$ref": "#/components/schemas/StyleguideTextStyleEvent"
},
{
"$ref": "#/components/schemas/StyleguideComponentEvent"
},
{
"$ref": "#/components/schemas/StyleguideSpacingTokenEvent"
},
{
"$ref": "#/components/schemas/PingEvent"
}
]
},
"PingEvent": {
"title": "Ping Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"context",
"resource"
],
"properties": {
"event": {
"type": "string",
"enum": [
"ping"
]
},
"action": {
"type": "string",
"enum": [
"ping"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object"
},
"context": {
"type": "object"
}
}
},
"WebhookEventActor": {
"title": "Webhook Event Actor",
"type": "object",
"required": [
"user"
],
"properties": {
"user": {
"$ref": "#/components/schemas/User"
}
}
},
"WorkspaceNotificationEvent": {
"title": "Workspace Notification Event",
"description": "This event is used to notify webhooks about changes related to user's notifications.",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/WorkspaceNotificationCreatedEvent",
"updated": "#/components/schemas/WorkspaceNotificationUpdatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/WorkspaceNotificationCreatedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceNotificationUpdatedEvent"
}
]
},
"WorkspaceNotificationCreatedEvent": {
"title": "Workspace Notification Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.notification"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Notification"
]
},
"data": {
"$ref": "#/components/schemas/Notification"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceNotificationUpdatedEvent": {
"title": "Workspace Notification Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.notification"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Notification"
]
},
"data": {
"$ref": "#/components/schemas/Notification"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceProjectEvent": {
"title": "Workspace Project Event",
"description": "This event is used to notify webhooks about changes directly related to Zeplin projects:\n - Project is created or deleted\n - Project's linked styleguide changes\n - Any of these properties change:\n - name\n - description\n - density scale (1x, 2x, etc.)\n - thumbnail image\n - status (archived or activated)\n - rem preferences (web projects only)\"\n",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/WorkspaceProjectCreatedEvent",
"updated": "#/components/schemas/WorkspaceProjectUpdatedEvent",
"deleted": "#/components/schemas/WorkspaceProjectDeletedEvent",
"activated": "#/components/schemas/WorkspaceProjectActivatedEvent",
"archived": "#/components/schemas/WorkspaceProjectArchivedEvent",
"styleguide_linked": "#/components/schemas/WorkspaceProjectStyleguideLinkedEvent",
"styleguide_unlinked": "#/components/schemas/WorkspaceProjectStyleguideUnlinkedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/WorkspaceProjectCreatedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceProjectUpdatedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceProjectDeletedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceProjectActivatedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceProjectArchivedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceProjectStyleguideLinkedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceProjectStyleguideUnlinkedEvent"
}
]
},
"WorkspaceProjectCreatedEvent": {
"title": "Workspace Project Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.project"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Project"
]
},
"data": {
"$ref": "#/components/schemas/Project"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceProjectUpdatedEvent": {
"title": "Workspace Project Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.project"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Project"
]
},
"data": {
"$ref": "#/components/schemas/Project"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceProjectDeletedEvent": {
"title": "Workspace Project Deleted Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.project"
]
},
"action": {
"type": "string",
"enum": [
"deleted"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Project"
]
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceProjectActivatedEvent": {
"title": "Workspace Project Activated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.project"
]
},
"action": {
"type": "string",
"enum": [
"activated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Project"
]
},
"data": {
"$ref": "#/components/schemas/Project"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceProjectArchivedEvent": {
"title": "Workspace Project Archived Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.project"
]
},
"action": {
"type": "string",
"enum": [
"archived"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Project"
]
},
"data": {
"$ref": "#/components/schemas/Project"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceProjectStyleguideLinkedEvent": {
"title": "Workspace Project Styleguide Linked Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.project"
]
},
"action": {
"type": "string",
"enum": [
"styleguide_linked"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Project"
]
},
"data": {
"$ref": "#/components/schemas/Project"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceProjectStyleguideUnlinkedEvent": {
"title": "Workspace Project Styleguide Unlinked Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.project"
]
},
"action": {
"type": "string",
"enum": [
"styleguide_unlinked"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Project"
]
},
"data": {
"$ref": "#/components/schemas/Project"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceStyleguideEvent": {
"title": "Workspace Styleguide Event",
"description": "This event is used to notify webhooks about changes directly related to Zeplin styleguides:\n - Styleguide is created or deleted\n - Styleguide's parent styleguide changes\n - Any of these properties change:\n - name\n - description\n - density scale (1x, 2x, etc.)\n - thumbnail image\n - status (archived or activated)\n - rem preferences (web styleguides only)\"\n",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/WorkspaceStyleguideCreatedEvent",
"updated": "#/components/schemas/WorkspaceStyleguideUpdatedEvent",
"deleted": "#/components/schemas/WorkspaceStyleguideDeletedEvent",
"activated": "#/components/schemas/WorkspaceStyleguideActivatedEvent",
"archived": "#/components/schemas/WorkspaceStyleguideArchivedEvent",
"styleguide_linked": "#/components/schemas/WorkspaceStyleguideStyleguideLinkedEvent",
"styleguide_unlinked": "#/components/schemas/WorkspaceStyleguideStyleguideUnlinkedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/WorkspaceStyleguideCreatedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceStyleguideUpdatedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceStyleguideDeletedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceStyleguideActivatedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceStyleguideArchivedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceStyleguideStyleguideLinkedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceStyleguideStyleguideUnlinkedEvent"
}
]
},
"WorkspaceStyleguideCreatedEvent": {
"title": "Workspace Styleguide Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.styleguide"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Styleguide"
]
},
"data": {
"$ref": "#/components/schemas/Styleguide"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceStyleguideUpdatedEvent": {
"title": "Workspace Styleguide Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.styleguide"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Styleguide"
]
},
"data": {
"$ref": "#/components/schemas/Styleguide"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceStyleguideDeletedEvent": {
"title": "Workspace Styleguide Deleted Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.styleguide"
]
},
"action": {
"type": "string",
"enum": [
"deleted"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Styleguide"
]
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceStyleguideActivatedEvent": {
"title": "Workspace Styleguide Activated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.styleguide"
]
},
"action": {
"type": "string",
"enum": [
"activated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Styleguide"
]
},
"data": {
"$ref": "#/components/schemas/Styleguide"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceStyleguideArchivedEvent": {
"title": "Workspace Styleguide Archived Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.styleguide"
]
},
"action": {
"type": "string",
"enum": [
"archived"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Styleguide"
]
},
"data": {
"$ref": "#/components/schemas/Styleguide"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceStyleguideStyleguideLinkedEvent": {
"title": "Workspace Styleguide Styleguide Linked Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.styleguide"
]
},
"action": {
"type": "string",
"enum": [
"styleguide_linked"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Styleguide"
]
},
"data": {
"$ref": "#/components/schemas/Styleguide"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceStyleguideStyleguideUnlinkedEvent": {
"title": "Workspace Styleguide Styleguide Unlinked Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.styleguide"
]
},
"action": {
"type": "string",
"enum": [
"styleguide_unlinked"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Styleguide"
]
},
"data": {
"$ref": "#/components/schemas/Styleguide"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceOrganizationEvent": {
"title": "Workspace Organization Event",
"description": "This event is used to notify webhooks about any of these activies:\n - Name or logo of the organization was changed\n - User requested to join the organization\n",
"discriminator": {
"propertyName": "action",
"mapping": {
"updated": "#/components/schemas/WorkspaceOrganizationUpdatedEvent",
"join_requested": "#/components/schemas/WorkspaceOrganizationJoinRequestedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/WorkspaceOrganizationUpdatedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceOrganizationJoinRequestedEvent"
}
]
},
"WorkspaceOrganizationUpdatedEvent": {
"title": "Workspace Organization Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.organization"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"OrganizationSummary"
]
},
"data": {
"$ref": "#/components/schemas/OrganizationSummary"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceOrganizationJoinRequestedEvent": {
"title": "Workspace Organization Join Requested Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.organization"
]
},
"action": {
"type": "string",
"enum": [
"join_requested"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"OrganizationSummary"
]
},
"data": {
"$ref": "#/components/schemas/OrganizationSummary"
}
}
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceOrganizationMemberEvent": {
"title": "Workspace Organization Member Event",
"description": "This event is used to notify webhooks about any of these activies related to the organization's members:\n - New member added\n - Member removed\n - Member's role changed\n - Member's tag changed\n",
"discriminator": {
"propertyName": "action",
"mapping": {
"invited": "#/components/schemas/WorkspaceOrganizationMemberInvitedEvent",
"removed": "#/components/schemas/WorkspaceOrganizationMemberRemovedEvent",
"role_updated": "#/components/schemas/WorkspaceOrganizationMemberRoleUpdatedEvent",
"tag_updated": "#/components/schemas/WorkspaceOrganizationMemberTagUpdatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/WorkspaceOrganizationMemberInvitedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceOrganizationMemberRemovedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceOrganizationMemberRoleUpdatedEvent"
},
{
"$ref": "#/components/schemas/WorkspaceOrganizationMemberTagUpdatedEvent"
}
]
},
"WorkspaceOrganizationMemberEventContext": {
"title": "Workspace Organization Member Event Context",
"type": "object",
"required": [
"organization"
],
"properties": {
"organization": {
"description": "Organization that contains the member",
"$ref": "#/components/schemas/OrganizationSummary"
}
}
},
"WorkspaceOrganizationMemberInvitedEvent": {
"title": "Workspace Organization Member Invited Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.organization.member"
]
},
"action": {
"type": "string",
"enum": [
"invited"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"OrganizationMember"
]
},
"data": {
"$ref": "#/components/schemas/OrganizationMember"
}
}
},
"context": {
"$ref": "#/components/schemas/WorkspaceOrganizationMemberEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceOrganizationMemberRemovedEvent": {
"title": "Workspace Organization Member Removed Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.organization.member"
]
},
"action": {
"type": "string",
"enum": [
"removed"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"OrganizationMember"
]
}
}
},
"context": {
"$ref": "#/components/schemas/WorkspaceOrganizationMemberEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceOrganizationMemberRoleUpdatedEvent": {
"title": "Workspace Organization Member Role Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.organization.member"
]
},
"action": {
"type": "string",
"enum": [
"role_updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"OrganizationMember"
]
},
"data": {
"$ref": "#/components/schemas/OrganizationMember"
}
}
},
"context": {
"$ref": "#/components/schemas/WorkspaceOrganizationMemberEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"WorkspaceOrganizationMemberTagUpdatedEvent": {
"title": "Workspace Organization Member Tag Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"workspace.organization.member"
]
},
"action": {
"type": "string",
"enum": [
"tag_updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"OrganizationMember"
]
},
"data": {
"$ref": "#/components/schemas/OrganizationMember"
}
}
},
"context": {
"$ref": "#/components/schemas/WorkspaceOrganizationMemberEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectMemberEvent": {
"title": "Project Member Event",
"description": "This event is used to notify webhooks about changes related to the project's members:\n - New member invited\n - Member removed\n - Member's role changed\n",
"discriminator": {
"propertyName": "action",
"mapping": {
"invited": "#/components/schemas/ProjectMemberInvitedEvent",
"removed": "#/components/schemas/ProjectMemberRemovedEvent",
"role_updated": "#/components/schemas/ProjectMemberRoleUpdatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/ProjectMemberInvitedEvent"
},
{
"$ref": "#/components/schemas/ProjectMemberRemovedEvent"
},
{
"$ref": "#/components/schemas/ProjectMemberRoleUpdatedEvent"
}
]
},
"ProjectMemberEventContext": {
"title": "Project Member Event Context",
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"description": "Project that contains the user",
"$ref": "#/components/schemas/Project"
}
}
},
"ProjectMemberInvitedEvent": {
"title": "Project Member Invited Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.member"
]
},
"action": {
"type": "string",
"enum": [
"invited"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"ProjectMember"
]
},
"data": {
"$ref": "#/components/schemas/ProjectMember"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectMemberEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectMemberRemovedEvent": {
"title": "Project Member Removed Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.member"
]
},
"action": {
"type": "string",
"enum": [
"removed"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"ProjectMember"
]
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectMemberEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectMemberRoleUpdatedEvent": {
"title": "Project Member Role Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.member"
]
},
"action": {
"type": "string",
"enum": [
"role_updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"ProjectMember"
]
},
"data": {
"$ref": "#/components/schemas/ProjectMember"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectMemberEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectScreenEvent": {
"title": "Project Screen Event",
"description": "This event is used to notify webhooks about changes related to a screen in Zeplin projects.",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/ProjectScreenCreatedEvent",
"deleted": "#/components/schemas/ProjectScreenDeletedEvent",
"updated": "#/components/schemas/ProjectScreenUpdatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/ProjectScreenCreatedEvent"
},
{
"$ref": "#/components/schemas/ProjectScreenDeletedEvent"
},
{
"$ref": "#/components/schemas/ProjectScreenUpdatedEvent"
}
]
},
"ProjectScreenEventContext": {
"title": "Project Screen Event Context",
"type": "object",
"required": [
"project",
"version"
],
"properties": {
"project": {
"description": "Project that contains the screen",
"$ref": "#/components/schemas/Project"
},
"version": {
"description": "The details of the screen's version (exists for all actions except `deleted` action).",
"$ref": "#/components/schemas/ScreenVersionSummary"
}
}
},
"ProjectScreenCreatedEvent": {
"title": "Project Screen Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.screen"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Screen"
]
},
"data": {
"$ref": "#/components/schemas/Screen"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectScreenEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectScreenDeletedEvent": {
"title": "Project Screen Deleted Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.screen"
]
},
"action": {
"type": "string",
"enum": [
"deleted"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Screen"
]
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectScreenDeletedEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectScreenDeletedEventContext": {
"title": "Project Screen Deleted Event Context",
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"description": "Project that contains the screen",
"$ref": "#/components/schemas/Project"
}
}
},
"ProjectScreenUpdatedEvent": {
"title": "Project Screen Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.screen"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Screen"
]
},
"data": {
"$ref": "#/components/schemas/Screen"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectScreenEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectScreenVersionEvent": {
"title": "Project Screen Version Event",
"description": "This event is used to notify webhooks about changes related to a screen versions in Zeplin projects.",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/ProjectScreenVersionCreatedEvent",
"deleted": "#/components/schemas/ProjectScreenVersionDeletedEvent",
"updated": "#/components/schemas/ProjectScreenVersionUpdatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/ProjectScreenVersionCreatedEvent"
},
{
"$ref": "#/components/schemas/ProjectScreenVersionDeletedEvent"
},
{
"$ref": "#/components/schemas/ProjectScreenVersionUpdatedEvent"
}
]
},
"ProjectScreenVersionEventContext": {
"title": "Project Screen Version Event Context",
"type": "object",
"required": [
"project",
"screen"
],
"properties": {
"project": {
"description": "Project that contains the screen version",
"$ref": "#/components/schemas/Project"
},
"screen": {
"description": "Screen that the version belongs to",
"$ref": "#/components/schemas/Screen"
}
}
},
"ProjectScreenVersionCreatedEvent": {
"title": "Project Screen Version Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.screen.version"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"ScreenVersionSummary"
]
},
"data": {
"$ref": "#/components/schemas/ScreenVersionSummary"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectScreenVersionEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectScreenVersionDeletedEvent": {
"title": "Project Screen Version Deleted Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.screen.version"
]
},
"action": {
"type": "string",
"enum": [
"deleted"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"ScreenVersionSummary"
]
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectScreenVersionEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectScreenVersionUpdatedEvent": {
"title": "Project Screen Version Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.screen.version"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"ScreenVersionSummary"
]
},
"data": {
"$ref": "#/components/schemas/ScreenVersionSummary"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectScreenVersionEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectNoteEvent": {
"title": "Project Note Event",
"description": "This event is used to notify webhooks about changes related to a notes in Zeplin projects.",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/ProjectNoteCreatedEvent",
"deleted": "#/components/schemas/ProjectNoteDeletedEvent",
"updated": "#/components/schemas/ProjectNoteUpdatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/ProjectNoteCreatedEvent"
},
{
"$ref": "#/components/schemas/ProjectNoteDeletedEvent"
},
{
"$ref": "#/components/schemas/ProjectNoteUpdatedEvent"
}
]
},
"ProjectNoteEventContext": {
"title": "Project Note Event Context",
"type": "object",
"required": [
"project",
"screen"
],
"properties": {
"project": {
"description": "Project that contains the screen in which the note has been added",
"$ref": "#/components/schemas/Project"
},
"screen": {
"description": "Screen in which the note has been added",
"$ref": "#/components/schemas/Screen"
}
}
},
"ProjectNoteCreatedEvent": {
"title": "Project Note Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.note"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"ScreenNote"
]
},
"data": {
"$ref": "#/components/schemas/ScreenNote"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectNoteEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectNoteDeletedEvent": {
"title": "Project Note Deleted Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.note"
]
},
"action": {
"type": "string",
"enum": [
"deleted"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"ScreenNote"
]
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectNoteEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectNoteUpdatedEvent": {
"title": "Project Note Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.note"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"ScreenNote"
]
},
"data": {
"$ref": "#/components/schemas/ScreenNote"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectNoteEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectNoteCommentEvent": {
"title": "Project Note Comment Event",
"description": "This event is used to notify webhooks about changes related to the comments in notes in Zeplin projects.",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/ProjectNoteCommentCreatedEvent",
"deleted": "#/components/schemas/ProjectNoteCommentDeletedEvent",
"updated": "#/components/schemas/ProjectNoteCommentUpdatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/ProjectNoteCommentCreatedEvent"
},
{
"$ref": "#/components/schemas/ProjectNoteCommentDeletedEvent"
},
{
"$ref": "#/components/schemas/ProjectNoteCommentUpdatedEvent"
}
]
},
"ProjectNoteCommentEventContext": {
"title": "Project Note Comment Event Context",
"type": "object",
"required": [
"project",
"screen",
"note"
],
"properties": {
"project": {
"description": "Project in which the comment has been added",
"$ref": "#/components/schemas/Project"
},
"screen": {
"description": "Screen in which the comment has been added",
"$ref": "#/components/schemas/Screen"
},
"note": {
"description": "Note in which the comment has been added",
"$ref": "#/components/schemas/ScreenNote"
}
}
},
"ProjectNoteCommentCreatedEvent": {
"title": "Project Note Comment Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.note.comment"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"ScreenNoteComment"
]
},
"data": {
"$ref": "#/components/schemas/ScreenNoteComment"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectNoteCommentEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectNoteCommentDeletedEvent": {
"title": "Project Note Comment Deleted Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.note.comment"
]
},
"action": {
"type": "string",
"enum": [
"deleted"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"ScreenNoteComment"
]
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectNoteCommentEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectNoteCommentUpdatedEvent": {
"title": "Project Note Comment Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.note.comment"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"ScreenNoteComment"
]
},
"data": {
"$ref": "#/components/schemas/ScreenNoteComment"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectNoteCommentEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectNoteCommentReactionEvent": {
"title": "Project Note Comment Reaction Event",
"description": "This event is used to notify webhooks about reactions to comments in notes in Zeplin projects.",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/ProjectNoteCommentReactionCreatedEvent",
"deleted": "#/components/schemas/ProjectNoteCommentReactionDeletedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/ProjectNoteCommentReactionCreatedEvent"
},
{
"$ref": "#/components/schemas/ProjectNoteCommentReactionDeletedEvent"
}
]
},
"ProjectNoteCommentReactionEventContext": {
"title": "Project Note Comment Reaction Event Context",
"type": "object",
"required": [
"project",
"screen",
"note",
"comment"
],
"properties": {
"project": {
"description": "Project in which the reaction has been added",
"$ref": "#/components/schemas/Project"
},
"screen": {
"description": "Screen in which the reaction has been added",
"$ref": "#/components/schemas/Screen"
},
"note": {
"description": "Note in which the reaction has been added",
"$ref": "#/components/schemas/ScreenNote"
},
"comment": {
"description": "Comment in which the reaction has been added",
"$ref": "#/components/schemas/ScreenNoteComment"
}
}
},
"ProjectNoteCommentReactionCreatedEvent": {
"title": "Project Note Comment Reaction Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.note.comment.reaction"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Reaction"
]
},
"data": {
"$ref": "#/components/schemas/Reaction"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectNoteCommentReactionEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectNoteCommentReactionDeletedEvent": {
"title": "Project Note Comment Reaction Deleted Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.note.comment.reaction"
]
},
"action": {
"type": "string",
"enum": [
"deleted"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Reaction"
]
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectNoteCommentReactionEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectColorEvent": {
"title": "Project Color Event",
"description": "This event is used to notify webhooks about changes related to a colors in the local styleguide of Zeplin projects.",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/ProjectColorCreatedEvent",
"deleted": "#/components/schemas/ProjectColorDeletedEvent",
"updated": "#/components/schemas/ProjectColorUpdatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/ProjectColorCreatedEvent"
},
{
"$ref": "#/components/schemas/ProjectColorDeletedEvent"
},
{
"$ref": "#/components/schemas/ProjectColorUpdatedEvent"
}
]
},
"ProjectColorEventContext": {
"title": "Project Color Event Context",
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"description": "Project that contains the color",
"$ref": "#/components/schemas/Project"
}
}
},
"ProjectColorCreatedEvent": {
"title": "Project Color Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.color"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Color"
]
},
"data": {
"$ref": "#/components/schemas/Color"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectColorEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectColorDeletedEvent": {
"title": "Project Color Deleted Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.color"
]
},
"action": {
"type": "string",
"enum": [
"deleted"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Color"
]
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectColorEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectColorUpdatedEvent": {
"title": "Project Color Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.color"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Color"
]
},
"data": {
"$ref": "#/components/schemas/Color"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectColorEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectFlowBoardEvent": {
"title": "Project Flow Board Event",
"description": "This event is used to notify webhooks about changes related to boards in Zeplin projects.",
"discriminator": {
"propertyName": "action",
"mapping": {
"built": "#/components/schemas/ProjectFlowBoardBuiltEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/ProjectFlowBoardBuiltEvent"
}
]
},
"ProjectFlowBoardEventContext": {
"title": "Project Flow Board Event Context",
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"description": "Project that contains the flow board",
"$ref": "#/components/schemas/Project"
}
}
},
"ProjectFlowBoardBuiltEvent": {
"title": "Project Flow Board Built Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.flow_board"
]
},
"action": {
"type": "string",
"enum": [
"built"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"FlowBoard"
]
},
"data": {
"$ref": "#/components/schemas/FlowBoard"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectFlowBoardEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectTextStyleEvent": {
"title": "Project Text Style Event",
"description": "This event is used to notify webhooks about changes related to a text styles in the local styleguide of Zeplin projects.",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/ProjectTextStyleCreatedEvent",
"deleted": "#/components/schemas/ProjectTextStyleDeletedEvent",
"updated": "#/components/schemas/ProjectTextStyleUpdatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/ProjectTextStyleCreatedEvent"
},
{
"$ref": "#/components/schemas/ProjectTextStyleDeletedEvent"
},
{
"$ref": "#/components/schemas/ProjectTextStyleUpdatedEvent"
}
]
},
"ProjectTextStyleEventContext": {
"title": "Project Text Style Event Context",
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"description": "Project that contains the text style",
"$ref": "#/components/schemas/Project"
}
}
},
"ProjectTextStyleCreatedEvent": {
"title": "Project Text Style Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.text_style"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"TextStyle"
]
},
"data": {
"$ref": "#/components/schemas/TextStyle"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectTextStyleEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectTextStyleDeletedEvent": {
"title": "Project Text Style Deleted Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.text_style"
]
},
"action": {
"type": "string",
"enum": [
"deleted"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"TextStyle"
]
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectTextStyleEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectTextStyleUpdatedEvent": {
"title": "Project Text Style Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.text_style"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"TextStyle"
]
},
"data": {
"$ref": "#/components/schemas/TextStyle"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectTextStyleEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectComponentEvent": {
"title": "Project Component Event",
"description": "This event is used to notify webhooks about changes related to a components in the local styleguide of Zeplin projects.",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/ProjectComponentCreatedEvent",
"deleted": "#/components/schemas/ProjectComponentDeletedEvent",
"updated": "#/components/schemas/ProjectComponentUpdatedEvent",
"version_created": "#/components/schemas/ProjectComponentVersionCreatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/ProjectComponentCreatedEvent"
},
{
"$ref": "#/components/schemas/ProjectComponentDeletedEvent"
},
{
"$ref": "#/components/schemas/ProjectComponentUpdatedEvent"
},
{
"$ref": "#/components/schemas/ProjectComponentVersionCreatedEvent"
}
]
},
"ProjectComponentEventContext": {
"title": "Project Component Event Context",
"type": "object",
"required": [
"project",
"version"
],
"properties": {
"project": {
"description": "Project that contains the component",
"$ref": "#/components/schemas/Project"
},
"version": {
"description": "The details of the component's version (exists for all actions except `deleted` action).",
"$ref": "#/components/schemas/ComponentVersionSummary"
}
}
},
"ProjectComponentCreatedEvent": {
"title": "Project Component Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.component"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Component"
]
},
"data": {
"$ref": "#/components/schemas/Component"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectComponentEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectComponentDeletedEvent": {
"title": "Project Component Deleted Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.component"
]
},
"action": {
"type": "string",
"enum": [
"deleted"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Component"
]
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectComponentDeletedEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectComponentDeletedEventContext": {
"title": "Project Component Deleted Event Context",
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"description": "Project that contains the component",
"$ref": "#/components/schemas/Project"
}
}
},
"ProjectComponentUpdatedEvent": {
"title": "Project Component Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.component"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Component"
]
},
"data": {
"$ref": "#/components/schemas/Component"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectComponentEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectComponentVersionCreatedEvent": {
"title": "Project Component Version Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.component"
]
},
"action": {
"type": "string",
"enum": [
"version_created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Component"
]
},
"data": {
"$ref": "#/components/schemas/Component"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectComponentEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectSpacingTokenEvent": {
"title": "Project Spacing Token Event",
"description": "This event is used to notify webhooks about changes related to a spacing tokens in the local styleguide of Zeplin projects.",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/ProjectSpacingTokenCreatedEvent",
"deleted": "#/components/schemas/ProjectSpacingTokenDeletedEvent",
"updated": "#/components/schemas/ProjectSpacingTokenUpdatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/ProjectSpacingTokenCreatedEvent"
},
{
"$ref": "#/components/schemas/ProjectSpacingTokenDeletedEvent"
},
{
"$ref": "#/components/schemas/ProjectSpacingTokenUpdatedEvent"
}
]
},
"ProjectSpacingTokenEventContext": {
"title": "Project Spacing Token Event Context",
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"description": "Project that contains the spacing token",
"$ref": "#/components/schemas/Project"
}
}
},
"ProjectSpacingTokenCreatedEvent": {
"title": "Project Spacing Token Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.spacing_token"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"SpacingToken"
]
},
"data": {
"$ref": "#/components/schemas/SpacingToken"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectSpacingTokenEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectSpacingTokenDeletedEvent": {
"title": "Project Spacing Token Deleted Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.spacing_token"
]
},
"action": {
"type": "string",
"enum": [
"deleted"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"SpacingToken"
]
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectSpacingTokenEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"ProjectSpacingTokenUpdatedEvent": {
"title": "Project Spacing Token Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"project.spacing_token"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"SpacingToken"
]
},
"data": {
"$ref": "#/components/schemas/SpacingToken"
}
}
},
"context": {
"$ref": "#/components/schemas/ProjectSpacingTokenEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideMemberEvent": {
"title": "Styleguide Member Event",
"description": "This event is used to notify webhooks about changes related to the styleguide's members:\n - New member invited\n - Member removed\n - Member's role changed\n",
"discriminator": {
"propertyName": "action",
"mapping": {
"invited": "#/components/schemas/StyleguideMemberInvitedEvent",
"removed": "#/components/schemas/StyleguideMemberRemovedEvent",
"role_updated": "#/components/schemas/StyleguideMemberRoleUpdatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/StyleguideMemberInvitedEvent"
},
{
"$ref": "#/components/schemas/StyleguideMemberRemovedEvent"
},
{
"$ref": "#/components/schemas/StyleguideMemberRoleUpdatedEvent"
}
]
},
"StyleguideMemberEventContext": {
"title": "Styleguide Member Event Context",
"type": "object",
"required": [
"styleguide"
],
"properties": {
"styleguide": {
"description": "Styleguide that contains the user",
"$ref": "#/components/schemas/Styleguide"
}
}
},
"StyleguideMemberInvitedEvent": {
"title": "Styleguide Member Invited Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.member"
]
},
"action": {
"type": "string",
"enum": [
"invited"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"StyleguideMember"
]
},
"data": {
"$ref": "#/components/schemas/StyleguideMember"
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideMemberEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideMemberRemovedEvent": {
"title": "Styleguide Member Removed Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.member"
]
},
"action": {
"type": "string",
"enum": [
"removed"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"StyleguideMember"
]
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideMemberEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideMemberRoleUpdatedEvent": {
"title": "Styleguide Member Role Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.member"
]
},
"action": {
"type": "string",
"enum": [
"role_updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"StyleguideMember"
]
},
"data": {
"$ref": "#/components/schemas/StyleguideMember"
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideMemberEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideColorEvent": {
"title": "Styleguide Color Event",
"description": "This event is used to notify webhooks about changes related to a colors in Zeplin styleguides.",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/StyleguideColorCreatedEvent",
"deleted": "#/components/schemas/StyleguideColorDeletedEvent",
"updated": "#/components/schemas/StyleguideColorUpdatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/StyleguideColorCreatedEvent"
},
{
"$ref": "#/components/schemas/StyleguideColorDeletedEvent"
},
{
"$ref": "#/components/schemas/StyleguideColorUpdatedEvent"
}
]
},
"StyleguideColorEventContext": {
"title": "Styleguide Color Event Context",
"type": "object",
"required": [
"styleguide"
],
"properties": {
"styleguide": {
"description": "Styleguide that contains the color",
"$ref": "#/components/schemas/Styleguide"
}
}
},
"StyleguideColorCreatedEvent": {
"title": "Styleguide Color Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.color"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Color"
]
},
"data": {
"$ref": "#/components/schemas/Color"
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideColorEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideColorDeletedEvent": {
"title": "Styleguide Color Deleted Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.color"
]
},
"action": {
"type": "string",
"enum": [
"deleted"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Color"
]
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideColorEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideColorUpdatedEvent": {
"title": "Styleguide Color Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.color"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Color"
]
},
"data": {
"$ref": "#/components/schemas/Color"
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideColorEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideTextStyleEvent": {
"title": "Styleguide Text Style Event",
"description": "This event is used to notify webhooks about changes related to a text styles in Zeplin styleguides.",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/StyleguideTextStyleCreatedEvent",
"deleted": "#/components/schemas/StyleguideTextStyleDeletedEvent",
"updated": "#/components/schemas/StyleguideTextStyleUpdatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/StyleguideTextStyleCreatedEvent"
},
{
"$ref": "#/components/schemas/StyleguideTextStyleDeletedEvent"
},
{
"$ref": "#/components/schemas/StyleguideTextStyleUpdatedEvent"
}
]
},
"StyleguideTextStyleEventContext": {
"title": "Styleguide Text Style Event Context",
"type": "object",
"required": [
"styleguide"
],
"properties": {
"styleguide": {
"description": "Styleguide that contains the text style",
"$ref": "#/components/schemas/Styleguide"
}
}
},
"StyleguideTextStyleCreatedEvent": {
"title": "Styleguide Text Style Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.text_style"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"TextStyle"
]
},
"data": {
"$ref": "#/components/schemas/TextStyle"
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideTextStyleEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideTextStyleDeletedEvent": {
"title": "Styleguide Text Style Deleted Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.text_style"
]
},
"action": {
"type": "string",
"enum": [
"deleted"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"TextStyle"
]
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideTextStyleEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideTextStyleUpdatedEvent": {
"title": "Styleguide Text Style Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.text_style"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"TextStyle"
]
},
"data": {
"$ref": "#/components/schemas/TextStyle"
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideTextStyleEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideComponentEvent": {
"title": "Styleguide Component Event",
"description": "This event is used to notify webhooks about changes related to a components in Zeplin styleguides.",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/StyleguideComponentCreatedEvent",
"deleted": "#/components/schemas/StyleguideComponentDeletedEvent",
"updated": "#/components/schemas/StyleguideComponentUpdatedEvent",
"version_created": "#/components/schemas/StyleguideComponentVersionCreatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/StyleguideComponentCreatedEvent"
},
{
"$ref": "#/components/schemas/StyleguideComponentDeletedEvent"
},
{
"$ref": "#/components/schemas/StyleguideComponentUpdatedEvent"
},
{
"$ref": "#/components/schemas/StyleguideComponentVersionCreatedEvent"
}
]
},
"StyleguideComponentEventContext": {
"title": "Styleguide Component Event Context",
"type": "object",
"required": [
"styleguide",
"version"
],
"properties": {
"styleguide": {
"description": "Styleguide that contains the component",
"$ref": "#/components/schemas/Styleguide"
},
"version": {
"description": "The details of the component's version (exists for all actions except `deleted` action).",
"$ref": "#/components/schemas/ComponentVersionSummary"
}
}
},
"StyleguideComponentCreatedEvent": {
"title": "Styleguide Component Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.component"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Component"
]
},
"data": {
"$ref": "#/components/schemas/Component"
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideComponentEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideComponentDeletedEvent": {
"title": "Styleguide Component Deleted Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.component"
]
},
"action": {
"type": "string",
"enum": [
"deleted"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Component"
]
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideComponentDeletedEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideComponentDeletedEventContext": {
"title": "Styleguide Component Deleted Event Context",
"type": "object",
"required": [
"styleguide"
],
"properties": {
"styleguide": {
"description": "Styleguide that contains the component",
"$ref": "#/components/schemas/Styleguide"
}
}
},
"StyleguideComponentUpdatedEvent": {
"title": "Styleguide Component Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.component"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Component"
]
},
"data": {
"$ref": "#/components/schemas/Component"
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideComponentEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideComponentVersionCreatedEvent": {
"title": "Styleguide Component Version Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.component"
]
},
"action": {
"type": "string",
"enum": [
"version_created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"Component"
]
},
"data": {
"$ref": "#/components/schemas/Component"
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideComponentEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideSpacingTokenEvent": {
"title": "Styleguide Spacing Token Event",
"description": "This event is used to notify webhooks about changes related to a spacing tokens in Zeplin styleguides.",
"discriminator": {
"propertyName": "action",
"mapping": {
"created": "#/components/schemas/StyleguideSpacingTokenCreatedEvent",
"deleted": "#/components/schemas/StyleguideSpacingTokenDeletedEvent",
"updated": "#/components/schemas/StyleguideSpacingTokenUpdatedEvent"
}
},
"oneOf": [
{
"$ref": "#/components/schemas/StyleguideSpacingTokenCreatedEvent"
},
{
"$ref": "#/components/schemas/StyleguideSpacingTokenDeletedEvent"
},
{
"$ref": "#/components/schemas/StyleguideSpacingTokenUpdatedEvent"
}
]
},
"StyleguideSpacingTokenEventContext": {
"title": "Styleguide Spacing Token Event Context",
"type": "object",
"required": [
"styleguide"
],
"properties": {
"styleguide": {
"description": "Styleguide that contains the spacing token",
"$ref": "#/components/schemas/Styleguide"
}
}
},
"StyleguideSpacingTokenCreatedEvent": {
"title": "Styleguide Spacing Token Created Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.spacing_token"
]
},
"action": {
"type": "string",
"enum": [
"created"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"SpacingToken"
]
},
"data": {
"$ref": "#/components/schemas/SpacingToken"
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideSpacingTokenEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideSpacingTokenDeletedEvent": {
"title": "Styleguide Spacing Token Deleted Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.spacing_token"
]
},
"action": {
"type": "string",
"enum": [
"deleted"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"SpacingToken"
]
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideSpacingTokenEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
},
"StyleguideSpacingTokenUpdatedEvent": {
"title": "Styleguide Spacing Token Updated Event",
"type": "object",
"required": [
"event",
"action",
"timestamp",
"resource",
"actor",
"context"
],
"properties": {
"event": {
"type": "string",
"enum": [
"styleguide.spacing_token"
]
},
"action": {
"type": "string",
"enum": [
"updated"
]
},
"timestamp": {
"type": "number"
},
"resource": {
"type": "object",
"required": [
"id",
"type",
"data"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"SpacingToken"
]
},
"data": {
"$ref": "#/components/schemas/SpacingToken"
}
}
},
"context": {
"$ref": "#/components/schemas/StyleguideSpacingTokenEventContext"
},
"actor": {
"$ref": "#/components/schemas/WebhookEventActor"
}
}
}
}
}