HTTP Flow Create


Required Fields


path
The path member can be a string of up to 128 characters. The path is always referenced by a / and an account id, and at least one other identifier, with each identifier is seperated by a /; much like a file system.

Optional Fields


capactiy
The maximum number of Drops stored within the Flow. The default value is 1,000, maximum is 100,000. A value of 0 will store no data. When the Flow exceeds its capacity of Drops, older Drops will be deleted automatically.
description
A more detailed description of the Flow.
filter
A filter which is used as a pass/fail test for writing new Drops to the Flow. See Flow Filter Language for more information.

Request


POST https://api.flowthings.io/v0.1/<account_id>/flow

Headers

NameDescription
Content-Typeapplication/json
X-Auth-TokenAuthentication Token

Example

POST https://api.flowthings.io/v0.1/<account_id>/flow

{
  "path": "/my_account_id/drink_recipes",
  "description": "My Drink Recipies",
  "filter": "EXISTS title"
}

Response


HTTP Codes

CodeDescription
201Resource Created
400Bad Request
401Unauthorized
503Service Unavailable

Example Response Body

{
  "head": {
    "status": 201,
    "ok": true,
    "errors": [],
    "messages": [ "Your request has been processed successfully. A new resource has been created." ]
  },
  "body": {
      "id": "f53b1d1600cf27b75148de02e",
      "creationDate": 1409764633330,
      "capacity" : 1000,
      "path": "/my_account_id/drink_recipes",
      "description": "My Drink Recipies",
      "filter": "EXISTS title"
  }
}