Skip to main content
PATCH
/
orgs
/
{org_id}
/
tables
/
positions
Reorder tables
curl --request PATCH \
  --url https://api.useinvent.com/orgs/{org_id}/tables/positions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "positions": [
    {
      "id": "<string>",
      "position": 1
    }
  ]
}
'
import requests

url = "https://api.useinvent.com/orgs/{org_id}/tables/positions"

payload = { "positions": [
{
"id": "<string>",
"position": 1
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}

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

print(response.text)
const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({positions: [{id: '<string>', position: 1}]})
};

fetch('https://api.useinvent.com/orgs/{org_id}/tables/positions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.useinvent.com/orgs/{org_id}/tables/positions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'positions' => [
[
'id' => '<string>',
'position' => 1
]
]
]),
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;
}
package main

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

func main() {

url := "https://api.useinvent.com/orgs/{org_id}/tables/positions"

payload := strings.NewReader("{\n \"positions\": [\n {\n \"id\": \"<string>\",\n \"position\": 1\n }\n ]\n}")

req, _ := http.NewRequest("PATCH", 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(string(body))

}
HttpResponse<String> response = Unirest.patch("https://api.useinvent.com/orgs/{org_id}/tables/positions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"positions\": [\n {\n \"id\": \"<string>\",\n \"position\": 1\n }\n ]\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.useinvent.com/orgs/{org_id}/tables/positions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"positions\": [\n {\n \"id\": \"<string>\",\n \"position\": 1\n }\n ]\n}"

response = http.request(request)
puts response.read_body
[
  {
    "id": "<string>",
    "name": "Companies",
    "description": "Companies are organizations that own and manage other organizations.",
    "record_prefix": "LEAD",
    "icon": "<string>",
    "display_field_id": "<string>",
    "archived": true,
    "position": 123,
    "fields": [
      {
        "id": "<string>",
        "table_id": "<string>",
        "key": "<string>",
        "schema": {
          "type": "file",
          "name": "<string>",
          "description": "<string>",
          "optional": true,
          "array": true,
          "placeholder": "<string>",
          "display": {},
          "order": 1,
          "link": "<string>",
          "metadata": {},
          "allowed_modes": [],
          "broadcast_field": true,
          "integration_field": true,
          "display_field": true,
          "conditions": [
            {
              "field": "<string>",
              "value": "<unknown>"
            }
          ],
          "hidden": true,
          "picker": {
            "type": "google_drive",
            "views": [],
            "selectable_mime_types": [
              "<string>"
            ]
          },
          "requires": [
            "<string>"
          ],
          "disable_variables": true,
          "allowed_types": [
            "<string>"
          ],
          "visibility": "PRIVATE"
        },
        "readonly": true,
        "kind": "system"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
]

Authorizations

Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

org_id
string
required

The ID of the org

Query Parameters

page
number

Page number

take
number

Number of items to take

next
string

Next page token (Only used on special endpoints)

Body

positions
object[]
required

New positions for the tables.

Response

200 - application/json
id
string
required
type
enum<string>
required
Available options:
custom,
contacts,
chats,
users
name
string | null
required

The name of the table.

Example:

"Companies"

description
string | null
required

The description of the table.

Example:

"Companies are organizations that own and manage other organizations."

record_prefix
string | null
required

The prefix of the record.

Example:

"LEAD"

icon
required

The picked icon. Null renders the default table icon.

display_field_id
string | null
required

The id of the display field.

archived
boolean
required

Whether the table is archived.

position
integer
required

Manual display order within the org.

fields
object[]
required
created_at
string<date-time> | null
required
updated_at
string<date-time> | null
required