Attach an Event to a resource

Supported Formats

json

GET https://api.vidyard.com/dashboard/v1/chapters/:id/events
Get all events belonging to a chapter, with their timing information.

Get all events belonging to a chapter, with their timing information.

Supported Formats

json

Errors

Code Description
400 Bad Request: body has wrong syntax or unable to handle request
401 Unauthorized: auth_token omitted or authentication failed
403 Forbidden: This action cannot be performed
404 Not Found: The requested resource could not be found
406 Not Acceptable: Accept or Content-Type headers must be application/json, text/csv or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Examples

REQUEST
Accept: application/json

RESPONSE
200 (OK)
[
  {
    "event_id": 8192,
    "second": 4,
    "duration": 2
    "event": {
      "event_type": "custom",
      "html": "<div class=\"main\">Checkout my CTA!</div>"
      ...
    }
  },
  {
    "event_id": 9297,
    "second": 6,
    "duration": 4
    "event": {
      "event_type": "custom",
      "html": "<div class=\"main\">Checkout my CTA!</div>"
      ...
    }
  }
]

Params

Param name Description
auth_token
optional

API token needed to authorize requests
This can appear as an attribute in the body of the request or the query parameters on the URL

Validations:

  • Must be a String


GET https://api.vidyard.com/dashboard/v1/organizations/:id/events
Get all events belonging to your organization, with their timing information.

Get all events belonging to your organization, with their timing information.

Supported Formats

json

Errors

Code Description
400 Bad Request: body has wrong syntax or unable to handle request
401 Unauthorized: auth_token omitted or authentication failed
403 Forbidden: This action cannot be performed
404 Not Found: The requested resource could not be found
406 Not Acceptable: Accept or Content-Type headers must be application/json, text/csv or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Examples

REQUEST
Accept: application/json

RESPONSE
200 (OK)
[
  {
    "event_id": 8192,
    "second": 4,
    "duration": 2
    "event": {
      "event_type": "custom",
      "html": "<div class=\"main\">Checkout my CTA!</div>"
      ...
    }
  },
  {
    "event_id": 9297,
    "second": 6,
    "duration": 4
    "event": {
      "event_type": "custom",
      "html": "<div class=\"main\">Checkout my CTA!</div>"
      ...
    }
  }
]

Params

Param name Description
auth_token
optional

API token needed to authorize requests
This can appear as an attribute in the body of the request or the query parameters on the URL

Validations:

  • Must be a String


POST https://api.vidyard.com/dashboard/v1/chapters/:id/events
Add an event to a chapter

Add an event to a chapter

Supported Formats

json

Errors

Code Description
400 Bad Request: body has wrong syntax or unable to handle request
401 Unauthorized: auth_token omitted or authentication failed
403 Forbidden: This action cannot be performed
404 Not Found: The requested resource could not be found
406 Not Acceptable: Accept or Content-Type headers must be application/json, text/csv or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Examples

REQUEST
Content-Type: application/json
{
  "event_id": 8192,
  "second": 4,
  "duration": 2
}

RESPONSE
200 (OK)
{
  "event_id": 8192,
  "second": 4,
  "duration": 2
  "event": {
    "event_type": "custom",
    "html": "<div class=\"main\">Checkout my CTA!</div>"
    ...
  }
},

Params

Param name Description
auth_token
optional

API token needed to authorize requests
This can appear as an attribute in the body of the request or the query parameters on the URL

Validations:

  • Must be a String

event_id
required

The ID of the event to add to this chapter.

Validations:

  • Parameter has to be Integer.

second
required

The second the event will start on.

Validations:

  • Parameter has to be Integer.

duration
required

The duration of the event.

Validations:

  • Parameter has to be Integer.

annotation_css
optional , nil allowed

Custom display settings if the event is an annotation

Validations:

  • Must be a Hash


POST https://api.vidyard.com/dashboard/v1/organizations/:id/events
Add a default event to a organization

Add a default event to a organization

Supported Formats

json

Errors

Code Description
400 Bad Request: body has wrong syntax or unable to handle request
401 Unauthorized: auth_token omitted or authentication failed
403 Forbidden: This action cannot be performed
404 Not Found: The requested resource could not be found
406 Not Acceptable: Accept or Content-Type headers must be application/json, text/csv or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Examples

REQUEST
Content-Type: application/json
{
  "event_id": 8192,
  "second": 4,
  "duration": 2
}

RESPONSE
200 (OK)
{
  "event_id": 8192,
  "second": 4,
  "duration": 2
  "event": {
    "event_type": "custom",
    "html": "<div class=\"main\">Checkout my CTA!</div>"
    ...
  }
}

Params

Param name Description
auth_token
optional

API token needed to authorize requests
This can appear as an attribute in the body of the request or the query parameters on the URL

Validations:

  • Must be a String

event_id
required

The ID of the default event to add to this organization.

Validations:

  • Parameter has to be Integer.

second
required

The second the event will start on. A setting of “-1” will designate the event as a Post-Roll

Validations:

  • Parameter has to be Integer.

duration
required

The duration of the event.

Validations:

  • Parameter has to be Integer.

annotation_css
optional , nil allowed

Custom display settings if the event is an annotation

Validations:

  • Must be a Hash


POST https://api.vidyard.com/dashboard/v1/events/:id/bulk_associate_events
Add an event to various chapters in an organization

Add an event to various chapters in an organization. Note that the collection will be modified to match the POSTed state.

Supported Formats

json

Errors

Code Description
400 Bad Request: body has wrong syntax or unable to handle request
401 Unauthorized: auth_token omitted or authentication failed
403 Forbidden: This action cannot be performed
404 Not Found: The requested resource could not be found
406 Not Acceptable: Accept or Content-Type headers must be application/json, text/csv or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Examples

REQUEST
Content-Type: application/json
{[
  {
    "second": 4,
    "duration": 2,
    "owner_id": 99
  },
  {
    "second": 4,
    "duration": 2,
    "owner_id": 96
  }
]}

RESPONSE
200 (OK)
{
  {
    "event_id": 40,
    "second": 4,
    "duration": 2,
    "owner_id": 99
  },
  {
    "event_id": 40,
    "second": 4,
    "duration": 2,
    "owner_id": 96
  }
}

Params

Param name Description
auth_token
optional

API token needed to authorize requests
This can appear as an attribute in the body of the request or the query parameters on the URL

Validations:

  • Must be a String


POST https://api.vidyard.com/dashboard/v1/chapters/:id/bulk_associate_events
Add a series of events to a chapter

Add a series of events to a chapter. Note that the collection will be modified to match the POSTed state.

Supported Formats

json

Errors

Code Description
400 Bad Request: body has wrong syntax or unable to handle request
401 Unauthorized: auth_token omitted or authentication failed
403 Forbidden: This action cannot be performed
404 Not Found: The requested resource could not be found
406 Not Acceptable: Accept or Content-Type headers must be application/json, text/csv or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Examples

REQUEST
Content-Type: application/json
{[
  {
    "event_id": 40,
    "second": 4,
    "duration": 2
  },
  {
    "event_id": 42,
    "second": 4,
    "duration": 2
  }
]}

RESPONSE
200 (OK)
{
  {
    "event_id": 40,
    "second": 4,
    "duration": 2
    "owner_id": 99
  },
  {
    "event_id": 42,
    "second": 4,
    "duration": 2
    "owner_id": 99
  }
}

Params

Param name Description
auth_token
optional

API token needed to authorize requests
This can appear as an attribute in the body of the request or the query parameters on the URL

Validations:

  • Must be a String


PATCH https://api.vidyard.com/dashboardv1/chapters/:id/events/:event_id
Modify an existing chapter's event

Modify an existing chapter’s event

Supported Formats

json

Errors

Code Description
400 Bad Request: body has wrong syntax or unable to handle request
401 Unauthorized: auth_token omitted or authentication failed
403 Forbidden: This action cannot be performed
404 Not Found: The requested resource could not be found
406 Not Acceptable: Accept or Content-Type headers must be application/json, text/csv or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Examples

REQUEST
Content-Type: application/json
{
  "second": 4,
  "duration": 2
}

RESPONSE
200 (OK)
{
  "event_id": 8192,
  "second": 4,
  "duration": 2
  "event": {
    "event_type": "custom",
    "html": "<div class=\"main\">Checkout my CTA!</div>"
    ...
  }
}

Params

Param name Description
auth_token
optional

API token needed to authorize requests
This can appear as an attribute in the body of the request or the query parameters on the URL

Validations:

  • Must be a String

second
optional

The second the event will start on.

Validations:

  • Parameter has to be Integer.

duration
optional

The duration of the event.

Validations:

  • Parameter has to be Integer.

annotation_css
optional

Custom display settings if the event is an annotation

Validations:

  • Must be a Hash


PATCH https://api.vidyard.com/dashboardv1/orgnizations/:id/events/:event_id
Modify an existing organization's default event

Modify an existing organization’s default event

Supported Formats

json

Errors

Code Description
400 Bad Request: body has wrong syntax or unable to handle request
401 Unauthorized: auth_token omitted or authentication failed
403 Forbidden: This action cannot be performed
404 Not Found: The requested resource could not be found
406 Not Acceptable: Accept or Content-Type headers must be application/json, text/csv or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Examples

REQUEST
Content-Type: application/json
{
  "second": 4,
  "duration": 2
}

RESPONSE
200 (OK)
{
  "event_id": 8192,
  "second": 4,
  "duration": 2
  "event": {
    "event_type": "custom",
    "html": "<div class=\"main\">Checkout my CTA!</div>"
    ...
  }
}

Params

Param name Description
auth_token
optional

API token needed to authorize requests
This can appear as an attribute in the body of the request or the query parameters on the URL

Validations:

  • Must be a String

second
optional

The second the event will start on. A setting of “-1” will designate the event as a Post-Roll

Validations:

  • Parameter has to be Integer.

duration
optional

The duration of the event.

Validations:

  • Parameter has to be Integer.

annotation_css
optional

Custom display settings if the referenced event is an annotation

Validations:

  • Must be a Hash


DELETE https://api.vidyard.com/dashboardv1/chapters/:id/events/:event_id
Delete an event from a chapter.

Delete an event from a chapter.

Supported Formats

json

Errors

Code Description
400 Bad Request: body has wrong syntax or unable to handle request
401 Unauthorized: auth_token omitted or authentication failed
403 Forbidden: This action cannot be performed
404 Not Found: The requested resource could not be found
406 Not Acceptable: Accept or Content-Type headers must be application/json, text/csv or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Examples

REQUEST
Accept: application/json

RESPONSE
200 (OK)
{
  "event_id": 8192,
  "second": 4,
  "duration": 2
  "event": {
    "event_type": "custom",
    "html": "<div class=\"main\">Checkout my CTA!</div>"
    ...
  }
}

Params

Param name Description
auth_token
optional

API token needed to authorize requests
This can appear as an attribute in the body of the request or the query parameters on the URL

Validations:

  • Must be a String


DELETE https://api.vidyard.com/dashboardv1/organizations/:id/events/:event_id
Delete a default event from an organization.

Delete a default event from an organization.

Supported Formats

json

Errors

Code Description
400 Bad Request: body has wrong syntax or unable to handle request
401 Unauthorized: auth_token omitted or authentication failed
403 Forbidden: This action cannot be performed
404 Not Found: The requested resource could not be found
406 Not Acceptable: Accept or Content-Type headers must be application/json, text/csv or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Examples

REQUEST
Accept: application/json

RESPONSE
200 (OK)
{
  "event_id": 8192,
  "second": 4,
  "duration": 2
  "event": {
    "event_type": "custom",
    "html": "<div class=\"main\">Checkout my CTA!</div>"
    ...
  }
}

Params

Param name Description
auth_token
optional

API token needed to authorize requests
This can appear as an attribute in the body of the request or the query parameters on the URL

Validations:

  • Must be a String