Box Developer Documentation
Log in

Timeline Skill Card

This resource is used by enpoints in the version 2024.0. For more details, see Box API versioning.

A Box Skill metadata card that places a list of images on a timeline.

string
skill_card

skill_card

Value is always skill_card

string (date-time)
2018-04-13T13:53:23-07:00

The optional date and time this card was created at.

integer
1000

An total duration in seconds of the timeline.

object array

A list of entries on the timeline.

object array

Defines a list of timestamps for when this item should appear on the timeline.

integer
20

The time in seconds when an entry should stop appearing on a timeline.

integer
1

The time in seconds when an entry should start appearing on a timeline.

string
https://example.com/image1.jpg

The image to show on a for an entry that appears on a timeline. This image URL is required for every entry.

The image will be shown in a list of items (for example faces), and clicking the image will show the user where that entry appears during the duration of this entry.

string
John

The text of the entry. This would be the display name for an item being placed on the timeline, for example the name of the person who was detected in a video.

object

The invocation of this service, used to track which instance of a service applied the metadata.

string
image-recognition-service-123

A custom identifier that represent the instance of the service that applied this metadata. For example, if your image-recognition-service runs on multiple nodes, this field can be used to identify the ID of the node that was used to apply the metadata.

string
skill_invocation

skill_invocation

Value is always skill_invocation

object

The service that applied this metadata.

string
image-recognition-service

A custom identifier that represent the service that applied this metadata.

string
service

service

Value is always service

object

The title of the card.

string
Faces

An optional identifier for the title.

string
Faces

The actual title to show in the UI.

string
timeline

timeline

Value is always timeline

Response Example

{
  "type": "skill_card",
  "created_at": "2018-04-13T13:53:23-07:00",
  "duration": 1000,
  "entries": [
    {
      "appears": [
        {
          "end": 20,
          "start": 1
        }
      ],
      "image_url": "https://example.com/image1.jpg",
      "text": "John"
    }
  ],
  "invocation": {
    "id": "image-recognition-service-123",
    "type": "skill_invocation"
  },
  "skill": {
    "id": "image-recognition-service",
    "type": "service"
  },
  "skill_card_title": {
    "code": "Faces",
    "message": "Faces"
  },
  "skill_card_type": "timeline"
}