COcomma
clips

Create clip

Changed on

Create a clip from a route.

post/v1/clips/create

Request

  • Base URL
    https://api.comma.ai
  • Auth
    HTTP bearer

Request body

idinteger required

Unique identifier for a clip

create_timeinteger required

Unix timestamp when clip was created, in milliseconds

dongle_idstring required

A unique 16-character hexadecimal string. Can represent a device or a user.

route_namestring required

Contains a dongle ID and timestamp of the beginning of the route

start_timeinteger required

Unix timestamp when clip starts, in milliseconds

end_timeinteger required

Unix timestamp when clip ends, in milliseconds

titlestring nullable

Optional title for clip

video_type'q' | 'f' | 'e' | 'd' | '360' required
  • q = QCamera
  • f = Road camera
  • e = Wide road camera
  • d = Driver camera
  • 360 = 360 video
is_publicboolean

Clip is publicly accessible

Example request

{
  "create_time": 1670109391000,
  "dongle_id": "1a2b3c4d5e6f7a8b",
  "route_name": "1a2b3c4d5e6f7a8b|2019-01-01--00-00-00"
}

Response

JSON object containing clip ID, or an error message

OR

Changes

  • 7d0e2f46b81aRevision changes
    • info

      the request property became optional

  • d13c9189b880Revision changes
    • breaking

      request property was restricted to a list of enum values

    • breaking

      request property was restricted to a list of enum values

    • breaking

      removed subschema #1: Pending subschema #2: Done subschema #3: Failed from the request property oneOf list

    • breaking

      removed subschema #1: QCamera subschema #2: Road camera subschema #3: Wide road camera subschema #4: Driver camera subschema #5: 360 from the request property oneOf list

    • warning

      added the new too_many_pending enum value to the / response property for the response status

    • info

      added the new 360 enum value to the request property

    • info

      added the new d enum value to the request property

    • info

      added the new done enum value to the request property

    • info

      added the new e enum value to the request property

    • info

      added the new f enum value to the request property

    • info

      added the new failed enum value to the request property

    • info

      added the new pending enum value to the request property

    • info

      added the new q enum value to the request property

    • info

      removed subschema #1 from the / response property oneOf list for the response status