Create a new Task

POST

/customer-api/v1/task-management/task

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://your-instance.seventhings.com/customer-api/v1/task-management/task");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{ \"title\": \"Refill the printer.\", \"comment\": \"The printer is running low on ink.\", \"deadline\": \"2022-04-01\", \"reminders\": [ { \"unit\": \"days\", \"value\": 2 } ], \"recurring_schedule\": { \"unit\": \"days\", \"value\": 2 }, \"assignees\": [ \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\" ], \"references\": [ { \"type\": \"asset\", \"uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\", \"status\": \"open\" } ], \"attachments\": [ \"7d8296ad-da7c-45f7-b676-9220b3a9d4dc\" ], \"notify\": true }");

CURLcode ret = curl_easy_perform(hnd);

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Post,
    RequestUri = new Uri("https://your-instance.seventhings.com/customer-api/v1/task-management/task"),
    Headers =
    {
        { "Authorization", "Bearer <token>" },
    },
    Content = new StringContent("{ \"title\": \"Refill the printer.\", \"comment\": \"The printer is running low on ink.\", \"deadline\": \"2022-04-01\", \"reminders\": [ { \"unit\": \"days\", \"value\": 2 } ], \"recurring_schedule\": { \"unit\": \"days\", \"value\": 2 }, \"assignees\": [ \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\" ], \"references\": [ { \"type\": \"asset\", \"uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\", \"status\": \"open\" } ], \"attachments\": [ \"7d8296ad-da7c-45f7-b676-9220b3a9d4dc\" ], \"notify\": true }")
    {
        Headers =
        {
            ContentType = new MediaTypeHeaderValue("application/json")
        }
    }
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://your-instance.seventhings.com/customer-api/v1/task-management/task"

  payload := strings.NewReader("{ \"title\": \"Refill the printer.\", \"comment\": \"The printer is running low on ink.\", \"deadline\": \"2022-04-01\", \"reminders\": [ { \"unit\": \"days\", \"value\": 2 } ], \"recurring_schedule\": { \"unit\": \"days\", \"value\": 2 }, \"assignees\": [ \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\" ], \"references\": [ { \"type\": \"asset\", \"uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\", \"status\": \"open\" } ], \"attachments\": [ \"7d8296ad-da7c-45f7-b676-9220b3a9d4dc\" ], \"notify\": true }")

  req, _ := http.NewRequest("POST", url, payload)

  req.Header.Add("Authorization", "Bearer <token>")
  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://your-instance.seventhings.com/customer-api/v1/task-management/task"))
    .header("Authorization", "Bearer <token>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{ \"title\": \"Refill the printer.\", \"comment\": \"The printer is running low on ink.\", \"deadline\": \"2022-04-01\", \"reminders\": [ { \"unit\": \"days\", \"value\": 2 } ], \"recurring_schedule\": { \"unit\": \"days\", \"value\": 2 }, \"assignees\": [ \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\" ], \"references\": [ { \"type\": \"asset\", \"uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\", \"status\": \"open\" } ], \"attachments\": [ \"7d8296ad-da7c-45f7-b676-9220b3a9d4dc\" ], \"notify\": true }"))
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{ \"title\": \"Refill the printer.\", \"comment\": \"The printer is running low on ink.\", \"deadline\": \"2022-04-01\", \"reminders\": [ { \"unit\": \"days\", \"value\": 2 } ], \"recurring_schedule\": { \"unit\": \"days\", \"value\": 2 }, \"assignees\": [ \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\" ], \"references\": [ { \"type\": \"asset\", \"uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\", \"status\": \"open\" } ], \"attachments\": [ \"7d8296ad-da7c-45f7-b676-9220b3a9d4dc\" ], \"notify\": true }");
Request request = new Request.Builder()
  .url("https://your-instance.seventhings.com/customer-api/v1/task-management/task")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .build();

Response response = client.newCall(request).execute();

import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://your-instance.seventhings.com/customer-api/v1/task-management/task',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  data: {
    title: 'Refill the printer.',
    comment: 'The printer is running low on ink.',
    deadline: '2022-04-01',
    reminders: [{unit: 'days', value: 2}],
    recurring_schedule: {unit: 'days', value: 2},
    assignees: ['a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11'],
    references: [{type: 'asset', uuid: 'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11', status: 'open'}],
    attachments: ['7d8296ad-da7c-45f7-b676-9220b3a9d4dc'],
    notify: true
  }
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

const url = 'https://your-instance.seventhings.com/customer-api/v1/task-management/task';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"title":"Refill the printer.","comment":"The printer is running low on ink.","deadline":"2022-04-01","reminders":[{"unit":"days","value":2}],"recurring_schedule":{"unit":"days","value":2},"assignees":["a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11"],"references":[{"type":"asset","uuid":"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11","status":"open"}],"attachments":["7d8296ad-da7c-45f7-b676-9220b3a9d4dc"],"notify":true}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

val client = OkHttpClient()

val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{ \"title\": \"Refill the printer.\", \"comment\": \"The printer is running low on ink.\", \"deadline\": \"2022-04-01\", \"reminders\": [ { \"unit\": \"days\", \"value\": 2 } ], \"recurring_schedule\": { \"unit\": \"days\", \"value\": 2 }, \"assignees\": [ \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\" ], \"references\": [ { \"type\": \"asset\", \"uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\", \"status\": \"open\" } ], \"attachments\": [ \"7d8296ad-da7c-45f7-b676-9220b3a9d4dc\" ], \"notify\": true }")
val request = Request.Builder()
  .url("https://your-instance.seventhings.com/customer-api/v1/task-management/task")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .build()

val response = client.newCall(request).execute()

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://your-instance.seventhings.com/customer-api/v1/task-management/task",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'Refill the printer.',
    'comment' => 'The printer is running low on ink.',
    'deadline' => '2022-04-01',
    'reminders' => [
        [
                'unit' => 'days',
                'value' => 2
        ]
    ],
    'recurring_schedule' => [
        'unit' => 'days',
        'value' => 2
    ],
    'assignees' => [
        'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11'
    ],
    'references' => [
        [
                'type' => 'asset',
                'uuid' => 'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11',
                'status' => 'open'
        ]
    ],
    'attachments' => [
        '7d8296ad-da7c-45f7-b676-9220b3a9d4dc'
    ],
    'notify' => null
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://your-instance.seventhings.com/customer-api/v1/task-management/task', [
  'body' => '{ "title": "Refill the printer.", "comment": "The printer is running low on ink.", "deadline": "2022-04-01", "reminders": [ { "unit": "days", "value": 2 } ], "recurring_schedule": { "unit": "days", "value": 2 }, "assignees": [ "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11" ], "references": [ { "type": "asset", "uuid": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11", "status": "open" } ], "attachments": [ "7d8296ad-da7c-45f7-b676-9220b3a9d4dc" ], "notify": true }',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();

import http.client

conn = http.client.HTTPSConnection("your-instance.seventhings.com")

payload = "{ \"title\": \"Refill the printer.\", \"comment\": \"The printer is running low on ink.\", \"deadline\": \"2022-04-01\", \"reminders\": [ { \"unit\": \"days\", \"value\": 2 } ], \"recurring_schedule\": { \"unit\": \"days\", \"value\": 2 }, \"assignees\": [ \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\" ], \"references\": [ { \"type\": \"asset\", \"uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\", \"status\": \"open\" } ], \"attachments\": [ \"7d8296ad-da7c-45f7-b676-9220b3a9d4dc\" ], \"notify\": true }"

headers = {
    'Authorization': "Bearer <token>",
    'Content-Type': "application/json"
}

conn.request("POST", "/customer-api/v1/task-management/task", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

import requests

url = "https://your-instance.seventhings.com/customer-api/v1/task-management/task"

payload = {
    "title": "Refill the printer.",
    "comment": "The printer is running low on ink.",
    "deadline": "2022-04-01",
    "reminders": [
        {
            "unit": "days",
            "value": 2
        }
    ],
    "recurring_schedule": {
        "unit": "days",
        "value": 2
    },
    "assignees": ["a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11"],
    "references": [
        {
            "type": "asset",
            "uuid": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
            "status": "open"
        }
    ],
    "attachments": ["7d8296ad-da7c-45f7-b676-9220b3a9d4dc"],
    "notify": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

use serde_json::json;
use reqwest;

#[tokio::main]
pub async fn main() {
    let url = "https://your-instance.seventhings.com/customer-api/v1/task-management/task";

    let payload = json!({
        "title": "Refill the printer.",
        "comment": "The printer is running low on ink.",
        "deadline": "2022-04-01",
        "reminders": (
            json!({
                "unit": "days",
                "value": 2
            })
        ),
        "recurring_schedule": json!({
            "unit": "days",
            "value": 2
        }),
        "assignees": ("a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11"),
        "references": (
            json!({
                "type": "asset",
                "uuid": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
                "status": "open"
            })
        ),
        "attachments": ("7d8296ad-da7c-45f7-b676-9220b3a9d4dc"),
        "notify": true
    });

    let mut headers = reqwest::header::HeaderMap::new();
    headers.insert("Authorization", "Bearer <token>".parse().unwrap());
    headers.insert("Content-Type", "application/json".parse().unwrap());

    let client = reqwest::Client::new();
    let response = client.post(url)
        .headers(headers)
        .json(&payload)
        .send()
        .await;

    let results = response.unwrap()
        .json::<serde_json::Value>()
        .await
        .unwrap();

    dbg!(results);
}

curl --request POST \
  --url https://your-instance.seventhings.com/customer-api/v1/task-management/task \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "title": "Refill the printer.", "comment": "The printer is running low on ink.", "deadline": "2022-04-01", "reminders": [ { "unit": "days", "value": 2 } ], "recurring_schedule": { "unit": "days", "value": 2 }, "assignees": [ "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11" ], "references": [ { "type": "asset", "uuid": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11", "status": "open" } ], "attachments": [ "7d8296ad-da7c-45f7-b676-9220b3a9d4dc" ], "notify": true }'

wget --quiet \
  --method POST \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --body-data '{ "title": "Refill the printer.", "comment": "The printer is running low on ink.", "deadline": "2022-04-01", "reminders": [ { "unit": "days", "value": 2 } ], "recurring_schedule": { "unit": "days", "value": 2 }, "assignees": [ "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11" ], "references": [ { "type": "asset", "uuid": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11", "status": "open" } ], "attachments": [ "7d8296ad-da7c-45f7-b676-9220b3a9d4dc" ], "notify": true }' \
  --output-document \
  - https://your-instance.seventhings.com/customer-api/v1/task-management/task

Create a new Task.

Authorizations

bearerAuth

Request Body^required

Task to be created

application/json

The payload for creating a new task.

object

title

required

The title of the task.

string

Example

Refill the printer.

comment

A comment that is displayed in the task details.

string

nullable

Example

The printer is running low on ink.

deadline

required

The date and time of the deadline.

string format: date

Example

2022-04-01

reminders

required

Array<object>

>= 1 items <= 2 items

A time interval that is used to trigger a task.

object

unit

required

The unit of the time interval.

string

Allowed values: days weeks months years

Example

weeks

value

required

The value of the time interval.

integer

Example

recurring_schedule

required

object

unit

required

The unit of the time interval.

string

Allowed values: days weeks months years

Example

weeks

value

required

The value of the time interval.

integer

Example

assignees

required

Array<string>

>= 1 items <= 1 items

references

required

Array<object>

The reference of the task.

object

type

required

The type of the referenced object.

string

Allowed values: asset

Example

asset

uuid

required

The UUID of the referenced object.

string format: uuid

Example

a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11

name

Display name of the referenced object.

string

Example

Assset name (asset barcode)

The id of the referenced object.

integer

Example

status

The status of the referenced object.

string

Allowed values: open done

Example

open

attachments

Array<string>

notify

boolean

Responses

201

Success

Headers

Location

string

Location of the newly created Task

Location-UUID

uuid

The UUID of the newly created object.

400

Request body is missing or invalid or request data is invalid.

401

Access token is missing or invalid.

403

You are not permitted to perform the requested operation.

500

Internal Server Error.

Create a new Task

Authorizations

Request Bodyrequired

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Responses

201

Headers

400

401

403

500

Request Body^required