You can also view
You are viewing documentation for version 13. This version is antiquated!
The current version is version 14

Create App

You can use the REST API to create Apps programatically.

Request

POST https://cameratag.com/api/v13/apps.json

Parameters

Below is a list of parameters that this endpoint accepts.

Parameter Accepted Values Description Required
api_key a valid user api_key All App endpoints require authentcation Required
name * The name of your application Required
region us, eu, ap, sa The name of the region in which you would like CameraTag to store your assets. (defaults to "us" if blank) Required
use_domain_auth true / false Turn on / off domain-based security Optional
domains[] * The authorized domain(s) for your app. To select more than one pass multiple domains[] params Optional
use_webhook true, false Turn on / off webhooks Optional
callback_trigger processed, approved, rejected, featured CameraTag will perform the callback after assets reach a specific state Optional
callback_url * A URL for the server callback functionality. Optional
use_email true, false Turn on / off Email notifications Optional
email_trigger processed, approved, rejected, featured CameraTag send an email after assets reach a specific state Optional
notification_email * An email to receive asset notifications Optional
publish_signature_required true, false require a valid signature for publishing of new assets Optional
playback_signature_required true, false require a valid signature for playback Optional
wall_privacy none, all, whitelist, blacklist Determines which assets are shown in videowalls connected to this app. Optional
use_ftp true, false Turn on / off FTP syndication Optional
ftp_trigger processed, approved, rejected, featured CameraTag will syndicate assets to your FTP account after they have reached the specified state Optional
ftp_server * A FTP server for FTP syndication Optional
ftp_username * A FTP user name for FTP syndication Optional
ftp_password * ftp_password Optional
ftp_directory * A FTP directory for FTP syndication Optional
ftp_protocol ftp, sftp Optional
use_s3 true, false Turn on / off S3 syndication Optional
s3_trigger processed, approved, rejected, featured CameraTag will syndicate assets to S3 after they have reached the specified state Optional
bucket_name * The name of your S3 Bucket (for S3 Syndication) Optional
s3_directory * An optional subdirectry into which assets should be placed Optional
s3_privacy public-read, private, authenticated-read The privacy settings for assets created in your S3 bucket Optional
s3_use_sse true, false Use server side encryption on S3 Optional
s3_key * An AWS Key with access to create objects and set ACLs Optional
s3_secret * An AWS Secret with access to create objects and set ACLs Optional
use_youtube true, false Turn on / off YouTube syndication Optional
youtube_trigger processed, approved, rejected, featured CameraTag will synicate assets after they have reached the sspecified state Optional
youtube_privacy public, private The privacy setting to videos created in your youtube account Optional
use_slack true, false Turn on / off Slack notifications Optional
slack_trigger processed, approved, rejected, featured CameraTag will notify your slack room after an asset reaches the specified state Optional
slack_url * The URL provided by the Slack webhook add-on Optional
slack_channel * The channel you would like us ti post to (starts with a #) Optional

Example Response

{
  "uuid": "63f9c870-72c4-0130-04c5-123139045d73",
  "name": "Homepage",
  "callback_url": "http://postb.in/4c5DrNQy",
  "notification_email": "chris@cameratag.com",
  "bucket_name": "cameratagtest",
  "crop_length": null,
  "s3_privacy": "public-read",
  "s3_directory": "terst",
  "s3_use_sse": false,
  "publish_signature_required": false,
  "playback_signature_required": false,
  "ftp_server": "danzig-media.smartfile.com",
  "ftp_username": "cdanzig",
  "ftp_password": "424D.86K/7N?949iyp9;CJ{}=CL{w,Y+",
  "ftp_directory": "cameratag/directory/",
  "use_ftp": false,
  "use_s3": false,
  "use_youtube": true,
  "ftp_trigger": "processed",
  "email_trigger": "processed",
  "s3_trigger": "processed",
  "youtube_trigger": "processed",
  "wall_privacy": "none",
  "photo_width": 640,
  "photo_height": 480,
  "media_factories": [
    {
      "camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
      "id": 8,
      "uuid": null,
      "name": "720p",
      "width": 1280,
      "height": 720,
      "area": 921600,
      "extension": "mp4",
      "length": "",
      "bitrate": null,
      "asset_class": "Video",
      "is_system": null,
      "created_at": "2017-05-07T07:22:58.000Z",
      "updated_at": "2017-06-02T02:33:11.000Z",
      "fg_color": null,
      "deleted_at": null,
      "language": null,
      "fps": null,
      "offset": null,
      "source": "camera",
      "media_source": null,
      "auto_rotate": true
    },
    {
      "camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
      "id": 10,
      "uuid": null,
      "name": "vga_thumb",
      "width": 1280,
      "height": 720,
      "area": 921600,
      "extension": "jpg",
      "length": "",
      "bitrate": null,
      "asset_class": "Video",
      "is_system": true,
      "created_at": "2017-05-07T07:23:16.000Z",
      "updated_at": "2017-06-02T02:33:25.000Z",
      "fg_color": null,
      "deleted_at": null,
      "language": null,
      "fps": null,
      "offset": null,
      "source": "camera",
      "media_source": null,
      "auto_rotate": true
    },
    {
      "camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
      "id": 11,
      "uuid": null,
      "name": "vga_filmstrip",
      "width": 1280,
      "height": 720,
      "area": 921600,
      "extension": "jpg",
      "length": 30,
      "bitrate": null,
      "asset_class": "Video",
      "is_system": true,
      "created_at": "2017-05-07T07:23:17.000Z",
      "updated_at": "2017-06-02T02:33:37.000Z",
      "fg_color": null,
      "deleted_at": null,
      "language": null,
      "fps": null,
      "offset": null,
      "source": "camera",
      "media_source": null,
      "auto_rotate": true
    },
    {
      "camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
      "id": 82916,
      "uuid": null,
      "name": "vertical",
      "width": 720,
      "height": 1280,
      "area": 921600,
      "extension": "mp4",
      "length": "",
      "bitrate": null,
      "asset_class": "Video",
      "is_system": null,
      "created_at": "2019-04-16T13:20:00.000Z",
      "updated_at": "2019-04-16T13:20:00.000Z",
      "fg_color": null,
      "deleted_at": null,
      "language": null,
      "fps": null,
      "offset": null,
      "source": "camera",
      "media_source": null,
      "auto_rotate": true
    },
    {
      "camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
      "id": 25,
      "uuid": null,
      "name": "waveform",
      "width": 2000,
      "height": 375,
      "area": 750000,
      "extension": "png",
      "length": null,
      "bitrate": null,
      "asset_class": "Audio",
      "is_system": true,
      "created_at": "2017-05-07T07:25:21.000Z",
      "updated_at": "2017-05-16T14:26:16.000Z",
      "fg_color": null,
      "deleted_at": null,
      "language": null,
      "fps": null,
      "offset": null,
      "source": "microphone",
      "media_source": null,
      "auto_rotate": true
    },
    {
      "camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
      "id": 26,
      "uuid": null,
      "name": "negative_waveform",
      "width": 2000,
      "height": 375,
      "area": 750000,
      "extension": "png",
      "length": null,
      "bitrate": null,
      "asset_class": "Audio",
      "is_system": true,
      "created_at": "2017-05-07T07:25:21.000Z",
      "updated_at": "2017-05-16T14:26:16.000Z",
      "fg_color": null,
      "deleted_at": null,
      "language": null,
      "fps": null,
      "offset": null,
      "source": "microphone",
      "media_source": null,
      "auto_rotate": true
    },
    {
      "camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
      "id": 27,
      "uuid": null,
      "name": "photo",
      "width": 640,
      "height": 480,
      "area": 307200,
      "extension": "jpg",
      "length": null,
      "bitrate": null,
      "asset_class": "Photo",
      "is_system": true,
      "created_at": "2017-05-07T07:25:21.000Z",
      "updated_at": "2017-05-16T14:26:16.000Z",
      "fg_color": null,
      "deleted_at": null,
      "language": null,
      "fps": null,
      "offset": null,
      "source": "photobooth",
      "media_source": null,
      "auto_rotate": true
    },
    {
      "camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
      "id": 109876,
      "uuid": null,
      "name": "Giphy",
      "width": 640,
      "height": 480,
      "area": 307200,
      "extension": "gif",
      "length": "10",
      "bitrate": null,
      "asset_class": "Video",
      "is_system": null,
      "created_at": "2020-05-05T01:01:03.000Z",
      "updated_at": "2020-05-05T01:01:03.000Z",
      "fg_color": null,
      "deleted_at": null,
      "language": null,
      "fps": 12.0,
      "offset": 0.0,
      "source": "camera",
      "media_source": null,
      "auto_rotate": true
    },
    {
      "camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
      "id": 134277,
      "uuid": null,
      "name": "user_stream",
      "width": 640,
      "height": 480,
      "area": 307200,
      "extension": "mp4",
      "length": null,
      "bitrate": null,
      "asset_class": "Video",
      "is_system": true,
      "created_at": "2020-07-01T10:57:42.000Z",
      "updated_at": "2020-07-01T10:57:42.000Z",
      "fg_color": null,
      "deleted_at": null,
      "language": null,
      "fps": null,
      "offset": null,
      "source": "room",
      "media_source": "composite",
      "auto_rotate": true
    },
    {
      "camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
      "id": 134278,
      "uuid": null,
      "name": "user_thumb",
      "width": 640,
      "height": 480,
      "area": 307200,
      "extension": "jpg",
      "length": null,
      "bitrate": null,
      "asset_class": "Video",
      "is_system": true,
      "created_at": "2020-07-01T10:57:42.000Z",
      "updated_at": "2020-07-01T10:57:42.000Z",
      "fg_color": null,
      "deleted_at": null,
      "language": null,
      "fps": null,
      "offset": null,
      "source": "room",
      "media_source": "composite",
      "auto_rotate": true
    },
    {
      "camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
      "id": 134279,
      "uuid": null,
      "name": "user_filmstrip",
      "width": 640,
      "height": 480,
      "area": 307200,
      "extension": "jpg",
      "length": 30,
      "bitrate": null,
      "asset_class": "Video",
      "is_system": true,
      "created_at": "2020-07-01T10:57:42.000Z",
      "updated_at": "2020-07-01T10:57:42.000Z",
      "fg_color": null,
      "deleted_at": null,
      "language": null,
      "fps": null,
      "offset": null,
      "source": "room",
      "media_source": "composite",
      "auto_rotate": true
    },
    {
      "camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
      "id": 92166,
      "uuid": null,
      "name": "Original",
      "width": null,
      "height": null,
      "area": null,
      "extension": null,
      "length": null,
      "bitrate": null,
      "asset_class": "Video",
      "is_system": null,
      "created_at": "2019-11-25T14:49:10.000Z",
      "updated_at": "2019-11-25T14:49:10.000Z",
      "fg_color": null,
      "deleted_at": null,
      "language": null,
      "fps": null,
      "offset": null,
      "source": "camera",
      "media_source": null,
      "auto_rotate": true
    },
    {
      "camera_id": "63f9c870-72c4-0130-04c5-123139045d73",
      "id": 24,
      "uuid": null,
      "name": "mp3",
      "width": null,
      "height": null,
      "area": null,
      "extension": "mp3",
      "length": null,
      "bitrate": null,
      "asset_class": "Audio",
      "is_system": true,
      "created_at": "2017-05-07T07:25:21.000Z",
      "updated_at": "2017-05-07T07:25:21.000Z",
      "fg_color": null,
      "deleted_at": null,
      "language": null,
      "fps": null,
      "offset": null,
      "source": "microphone",
      "media_source": null,
      "auto_rotate": true
    }
  ],
  "domains": [

  ]
}