10. Organizations¶

10.1. List/Query Organizations¶

A list of matching organizations may be queried by the system. The optional query parameters are as follows:

To query for organizations, add query parameters after the sensors URL as follows:

10.2. Viewing a Single Organization¶

To view a single organization, query by name:

curl "https://smartstreets.sensetecnic.com/wotkit/api/orgs/electric-inc"

Output:

{
        "id": 4764,
        "name": "electric-inc",
        "longName": "Electric, Inc.",
        "description": "Electric, Inc. was established in 1970.",
        "imageUrl": "http://www.example.com/electric-inc-logo.png"
}

10.3. Creating/Registering an Organization¶

To register a new organization, you POST an organization resource to the url /org.

• The organization resources is a JSON object.
• The “name” and “longName” fields are required and must both be at least 4 characters long.
• The “imageUrl” and “description” fields are optional.

To create an organization:

10.4. Updating an Organization¶

• You may update any fields except “id” and “name”.
• Only fields that are present in the JSON object will be updated.

To update an organization:

10.5. Deleting an Organization¶

Deleting an organization is done by deleting the organization resource.

To delete a user:

10.6. Organization Membership¶

curl --user {id}:{password} --request POST
--header "Content-Type: application/json" --data-binary @users-list.txt
'https://smartstreets.sensetecnic.com/wotkit/api/orgs/electric-inc/members'

["abe", "beth", "cecilia", "dylan"]