Update user idea

Update User Idea

Execute the process of creating Idea by making a PUT request to endpoint /api/v0.9/ideas/{id} .

Request Header

 Request Headers
Name Description Type Example
Authorization Access token of user. In the format ‘Bearer xxxxxxxxxxx’  String Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImQ1ZjQzYWEwNjFiZGM5NzYwMTQ2ZGY4ZjE2NWMzZTE0NGQ1ZjM0N2Y0OTYyYzEyNzA2OGYzYzlmYzM1N2E5NDNiMWNmNWY4NjZhNTVjMzMzIn0.eyJhdWQiOiIxNjc4NCIsImp0aSI6ImQ1ZjQzYWEwNjFiZGM5NzYwMTQ2ZGY4ZjE2NWMzZTE0NGQ1ZjM0N2Y0OTYyYzEyNzA2OGYzYzlmYzM1N2E5NDNiMWNmNWY4NjZhNTVjMzMzIiwiaWF0IjoxNTAwMzc0MTc4LCJuYmYiOjE1MDAzNzQxNzgsImV4cCI6MTUzMTkxMDE3OCwic3ViIjoiNDg1Iiwic2NvcGVzIjpbXX0.qE5_mShXUftne7i2YHkjiu_LvN626_YYk7dnTfhm7H8VMcDyYvf-a4lw5XZBvXEeMLXsPkyxwXT0XDr9BzR1zZaQf9WU8CuOu_98cBeOIwgrviVtHFPDwo68go9AgI3QNIof6CM37QO_wDkeXQQHF8StG03bzMURvH_eMBmO9GoRexwVsanxtROJWlEuvDgvG9fK28d1376Ff5fkpMMvGWyGLW5EZinpXzhF7UObKTFRQJHHjuTPElKJfiA0eEeQOhCsU5dl5riKjJaAO7248OwXvAXSHZfshrRKb_aQs03OWu2Hq2tWhav8x6_tVKCZmpTlvR6-DAKQJf6_YDF5w3f5Som2yn8kR8lCpB6s2vp9nFnI2TXHCWdUxDvRYm9Vf_bd0qd4fXrSVb2_SYiARC-Tda2yDT4pPRv_6P-30fesB9dU9A3QqeIX47N7iHpIN1stu3MrgFKcZDbhy9ZZqb6a6qjPz2YOvkoWscBDdiBm1TqwTFfREYlUUxJReyjIs4DokuDXUEO60P6F97LbYitjYwd5DaqR94vMPuzcN8sU2Oc9Bpd6iGOc29CCxjdySw1JxdWcZUjzGEE00vuuggXNUNI5W5h0xI1S3OPGXlXNhYEZ1zCDiiIj5YYPU_P4j9xqLKusjrlRBUuJWsLVRy25cb2hX00GJfW7kIr3-rE9xqLKusjrlRBUuJWsLVRy25cb2hX00GJfW7kIr3-rE9xqLKusjrlRBUuJWsLVRy25cb2hX00GJfW7kIr3-rE
X-Benlly-Request-Device Type of the device in use. Available options included
  • ios
  • android
  • web
  • infoboard
  • windows
 String android
X-Benlly-Udid Unique ID for each device. Could be generated by using SDK. String 7f0abbcd-fb03-4484-aaba-a0211d9c14e2

URL Parameters

 URL Parameters
Name Description Type Example
id ID of the UserIdea Integer 1

Request Parameters

 Request Parameters
Name Description Type
oauth_client_idea_id If this Idea was created base on a pre-set Idea, this field should contain its ID. If not, then leave NULL. String
trigger An Trigger Object. Description below. Object
actions An array of Action Object. Description below. Array
executed_days A String contains all days of week that this User Idea would be executed, seperate by comma. Ex : ‘Mon,Tue’ String
executed_time Specify at which time of day should this idea be executed. String
 Trigger Object
Name Description Type
device_ids An array of Integer, contains the IDs of all UserChannel that user want to use. Array
schema A Schema Object. Description below. Object
items An array that describe the user input content of the trigger. Each member is an array in the following format.
  • name : Name of this item. Type String. For example : ‘hashtag’
  • value : Content of this item. Type Mix. For example : ‘{{海}}’
 Array
type Type of this Trigger. 2 mean it’s a custom Trigger. 1 mean it’s not. Object
 Action Object
Name Description Type
device_ids An array of Integer, contains the IDs of all UserChannel that user want to use. Array
schema A Schema Object. Description below. Object
Items An array that describe the user input content of the action. Each member is an array in the following format.
  • name : Name of this item. Type String. For example : ‘message’
  • value : Content of this item. Type Mix. For example : ‘{{ツイート内容}}’
 Array
type Type of this Action. 4 means it’s a custom Trigger. 4 means it’s not. Object
 Schema Object
Name Description Type
id ID of the action or trigger that this UserTrigger or UserAction based on. Integer

Response Format

In case of successful, the server will return an UserIdea Object. Response will be of following format :
Sample Response

{
  data: {
    id: 123,
    oauth_client_idea: {
        id: 1,
        name: 'My Idea',
        icon: '/img/default.png',
        used: true,
    }
    trigger: {
      id: 22,
      schema: {
        id: 2,
        identifier: "post_with_hashtag",
        title: "あなたが特定のハッシュタグつきのツイートをしたら"
        items: [
          {
            "name": "hashtag",
            "label"; "ハッシュタグ"
            "type": "text",
            "max": 128
          }
        ],
        keywords: [
          {
            "name": "id",
            "label": "ツイートID",
            "type": "text",
          },
          {
            "name": "contents",
            "label": "ツイート内容",
            "type": "text",
          },
          {
            "name": "posted_at",
            "label": "ツイート日時",
            "type": "datetime",
          }
        ]
      },
      title: "あなたが #海 のツイートをしたら",
      items: [
        {
          "name": "hashtag",
          "label"; "ハッシュタグ"
          "type": "text",
          "value": "海",
          "max": 128
        }
      ]
    },
    actions: [
      {
        id: 12,
        title: "ツイートする",
        schema: {
          id: 1,
          identifier: "post",
          title: "ツイートする"
          items: [
            {
              "name": "message",
              "label"; "ツイート内容"
              "type": "text",
              "max": 140
            }
          ]
        },
        items: [
          {
            "name": "message",
            "label"; "ツイート内容"
            "type": "text",
            "value": "{{投稿内容}}"
            "max": 140
          }
        ]
      }
    ],
    used: false,
    status: "available",
    last_executed_at: "2016-10-02T12:15:00+09:00",
    last_manual_executed_at: null,
    created_at: "2016-10-01T12:30:31+09:00",
    updated_at: "2016-10-01T12:30:31+09:00"
  }
}
pageTop
Loading...