Upsert a workspace record
curl --request PUT \
--url https://api.attio.com/v2/objects/workspaces/records \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"data": {
"values": {
"workspace_id": "123",
"name": "Customer.com",
"avatar_url": "https://example.com/avatar.png",
"users": [
{
"target_object": "users",
"target_record_id": "5e3fb280-007b-495a-a530-9354bde01de1"
}
],
"company": {
"target_object": "companies",
"target_record_id": "99a03ff3-0435-47da-95cc-76b2caeb4dab"
}
}
}
}
'import requests
url = "https://api.attio.com/v2/objects/workspaces/records"
payload = { "data": { "values": {
"workspace_id": "123",
"name": "Customer.com",
"avatar_url": "https://example.com/avatar.png",
"users": [
{
"target_object": "users",
"target_record_id": "5e3fb280-007b-495a-a530-9354bde01de1"
}
],
"company": {
"target_object": "companies",
"target_record_id": "99a03ff3-0435-47da-95cc-76b2caeb4dab"
}
} } }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
data: {
values: {
workspace_id: '123',
name: 'Customer.com',
avatar_url: 'https://example.com/avatar.png',
users: [
{
target_object: 'users',
target_record_id: '5e3fb280-007b-495a-a530-9354bde01de1'
}
],
company: {
target_object: 'companies',
target_record_id: '99a03ff3-0435-47da-95cc-76b2caeb4dab'
}
}
}
})
};
fetch('https://api.attio.com/v2/objects/workspaces/records', 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.attio.com/v2/objects/workspaces/records",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'data' => [
'values' => [
'workspace_id' => '123',
'name' => 'Customer.com',
'avatar_url' => 'https://example.com/avatar.png',
'users' => [
[
'target_object' => 'users',
'target_record_id' => '5e3fb280-007b-495a-a530-9354bde01de1'
]
],
'company' => [
'target_object' => 'companies',
'target_record_id' => '99a03ff3-0435-47da-95cc-76b2caeb4dab'
]
]
]
]),
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.attio.com/v2/objects/workspaces/records"
payload := strings.NewReader("{\n \"data\": {\n \"values\": {\n \"workspace_id\": \"123\",\n \"name\": \"Customer.com\",\n \"avatar_url\": \"https://example.com/avatar.png\",\n \"users\": [\n {\n \"target_object\": \"users\",\n \"target_record_id\": \"5e3fb280-007b-495a-a530-9354bde01de1\"\n }\n ],\n \"company\": {\n \"target_object\": \"companies\",\n \"target_record_id\": \"99a03ff3-0435-47da-95cc-76b2caeb4dab\"\n }\n }\n }\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.attio.com/v2/objects/workspaces/records")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"data\": {\n \"values\": {\n \"workspace_id\": \"123\",\n \"name\": \"Customer.com\",\n \"avatar_url\": \"https://example.com/avatar.png\",\n \"users\": [\n {\n \"target_object\": \"users\",\n \"target_record_id\": \"5e3fb280-007b-495a-a530-9354bde01de1\"\n }\n ],\n \"company\": {\n \"target_object\": \"companies\",\n \"target_record_id\": \"99a03ff3-0435-47da-95cc-76b2caeb4dab\"\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.attio.com/v2/objects/workspaces/records")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"data\": {\n \"values\": {\n \"workspace_id\": \"123\",\n \"name\": \"Customer.com\",\n \"avatar_url\": \"https://example.com/avatar.png\",\n \"users\": [\n {\n \"target_object\": \"users\",\n \"target_record_id\": \"5e3fb280-007b-495a-a530-9354bde01de1\"\n }\n ],\n \"company\": {\n \"target_object\": \"companies\",\n \"target_record_id\": \"99a03ff3-0435-47da-95cc-76b2caeb4dab\"\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": {
"workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
"object_id": "97052eb9-e65e-443f-a297-f2d9a4a7f795",
"record_id": "bf071e1f-6035-429d-b874-d83ea64ea13b"
},
"created_at": "2022-11-21T13:22:49.061281000Z",
"web_url": "https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b",
"values": {
"workspace_id": [
{
"active_from": "2023-01-01T15:00:00.000000000Z",
"active_until": null,
"created_by_actor": {
"type": "system",
"id": null
},
"value": "123",
"attribute_type": "text"
}
],
"name": [
{
"active_from": "2023-01-01T15:00:00.000000000Z",
"active_until": null,
"created_by_actor": {
"type": "system",
"id": null
},
"value": "Fundstack",
"attribute_type": "text"
}
],
"users": [
{
"active_from": "2023-01-01T15:00:00.000000000Z",
"active_until": null,
"created_by_actor": {
"type": "system",
"id": null
},
"target_object": "users",
"target_record_id": "5e3fb280-007b-495a-a530-9354bde01de1",
"attribute_type": "record-reference"
}
],
"company": [
{
"active_from": "2023-01-01T15:00:00.000000000Z",
"active_until": null,
"created_by_actor": {
"type": "system",
"id": null
},
"target_object": "companies",
"target_record_id": "99a03ff3-0435-47da-95cc-76b2caeb4dab",
"attribute_type": "record-reference"
}
],
"avatar_url": [
{
"active_from": "2023-01-01T15:00:00.000000000Z",
"active_until": null,
"created_by_actor": {
"type": "system",
"id": null
},
"value": "https://example.com/avatar.png",
"attribute_type": "text"
}
]
}
}
}{
"status_code": 400,
"type": "invalid_request_error",
"code": "value_not_found",
"message": "No attribute was found for matching_attribute slug/ID \"my_attribute\"."
}{
"status_code": 403,
"type": "auth_error",
"code": "unauthorized",
"message": "You do not have the necessary permissions to create or update records of this object."
}{
"status_code": 404,
"type": "invalid_request_error",
"code": "not_found",
"message": "Object with slug/ID \"people\" not found."
}{
"status_code": 409,
"type": "invalid_request_error",
"code": "concurrent_write_conflict",
"message": "The record was modified by another request while this write was being validated. Please try again."
}Workspaces
Upsert a workspace record
Use this endpoint to create or update workspace records, using a matching attribute to search for existing workspaces (for example the workspace_id attribute). If a workspace is found with the same value for the matching attribute, that workspace will be updated, otherwise a new workspace will be created instead. If the matching attribute is a multiselect attribute, new values will be added and existing values will not be deleted. For any other multiselect attribute, all values will be either created or deleted as necessary to match the list of supplied values.
Required scopes: record_permission:read-write, object_configuration:read.
Supported token levels: workspace, user.
PUT
/
v2
/
objects
/
workspaces
/
records
Upsert a workspace record
curl --request PUT \
--url https://api.attio.com/v2/objects/workspaces/records \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"data": {
"values": {
"workspace_id": "123",
"name": "Customer.com",
"avatar_url": "https://example.com/avatar.png",
"users": [
{
"target_object": "users",
"target_record_id": "5e3fb280-007b-495a-a530-9354bde01de1"
}
],
"company": {
"target_object": "companies",
"target_record_id": "99a03ff3-0435-47da-95cc-76b2caeb4dab"
}
}
}
}
'import requests
url = "https://api.attio.com/v2/objects/workspaces/records"
payload = { "data": { "values": {
"workspace_id": "123",
"name": "Customer.com",
"avatar_url": "https://example.com/avatar.png",
"users": [
{
"target_object": "users",
"target_record_id": "5e3fb280-007b-495a-a530-9354bde01de1"
}
],
"company": {
"target_object": "companies",
"target_record_id": "99a03ff3-0435-47da-95cc-76b2caeb4dab"
}
} } }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
data: {
values: {
workspace_id: '123',
name: 'Customer.com',
avatar_url: 'https://example.com/avatar.png',
users: [
{
target_object: 'users',
target_record_id: '5e3fb280-007b-495a-a530-9354bde01de1'
}
],
company: {
target_object: 'companies',
target_record_id: '99a03ff3-0435-47da-95cc-76b2caeb4dab'
}
}
}
})
};
fetch('https://api.attio.com/v2/objects/workspaces/records', 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.attio.com/v2/objects/workspaces/records",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'data' => [
'values' => [
'workspace_id' => '123',
'name' => 'Customer.com',
'avatar_url' => 'https://example.com/avatar.png',
'users' => [
[
'target_object' => 'users',
'target_record_id' => '5e3fb280-007b-495a-a530-9354bde01de1'
]
],
'company' => [
'target_object' => 'companies',
'target_record_id' => '99a03ff3-0435-47da-95cc-76b2caeb4dab'
]
]
]
]),
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.attio.com/v2/objects/workspaces/records"
payload := strings.NewReader("{\n \"data\": {\n \"values\": {\n \"workspace_id\": \"123\",\n \"name\": \"Customer.com\",\n \"avatar_url\": \"https://example.com/avatar.png\",\n \"users\": [\n {\n \"target_object\": \"users\",\n \"target_record_id\": \"5e3fb280-007b-495a-a530-9354bde01de1\"\n }\n ],\n \"company\": {\n \"target_object\": \"companies\",\n \"target_record_id\": \"99a03ff3-0435-47da-95cc-76b2caeb4dab\"\n }\n }\n }\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.attio.com/v2/objects/workspaces/records")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"data\": {\n \"values\": {\n \"workspace_id\": \"123\",\n \"name\": \"Customer.com\",\n \"avatar_url\": \"https://example.com/avatar.png\",\n \"users\": [\n {\n \"target_object\": \"users\",\n \"target_record_id\": \"5e3fb280-007b-495a-a530-9354bde01de1\"\n }\n ],\n \"company\": {\n \"target_object\": \"companies\",\n \"target_record_id\": \"99a03ff3-0435-47da-95cc-76b2caeb4dab\"\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.attio.com/v2/objects/workspaces/records")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"data\": {\n \"values\": {\n \"workspace_id\": \"123\",\n \"name\": \"Customer.com\",\n \"avatar_url\": \"https://example.com/avatar.png\",\n \"users\": [\n {\n \"target_object\": \"users\",\n \"target_record_id\": \"5e3fb280-007b-495a-a530-9354bde01de1\"\n }\n ],\n \"company\": {\n \"target_object\": \"companies\",\n \"target_record_id\": \"99a03ff3-0435-47da-95cc-76b2caeb4dab\"\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": {
"workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
"object_id": "97052eb9-e65e-443f-a297-f2d9a4a7f795",
"record_id": "bf071e1f-6035-429d-b874-d83ea64ea13b"
},
"created_at": "2022-11-21T13:22:49.061281000Z",
"web_url": "https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b",
"values": {
"workspace_id": [
{
"active_from": "2023-01-01T15:00:00.000000000Z",
"active_until": null,
"created_by_actor": {
"type": "system",
"id": null
},
"value": "123",
"attribute_type": "text"
}
],
"name": [
{
"active_from": "2023-01-01T15:00:00.000000000Z",
"active_until": null,
"created_by_actor": {
"type": "system",
"id": null
},
"value": "Fundstack",
"attribute_type": "text"
}
],
"users": [
{
"active_from": "2023-01-01T15:00:00.000000000Z",
"active_until": null,
"created_by_actor": {
"type": "system",
"id": null
},
"target_object": "users",
"target_record_id": "5e3fb280-007b-495a-a530-9354bde01de1",
"attribute_type": "record-reference"
}
],
"company": [
{
"active_from": "2023-01-01T15:00:00.000000000Z",
"active_until": null,
"created_by_actor": {
"type": "system",
"id": null
},
"target_object": "companies",
"target_record_id": "99a03ff3-0435-47da-95cc-76b2caeb4dab",
"attribute_type": "record-reference"
}
],
"avatar_url": [
{
"active_from": "2023-01-01T15:00:00.000000000Z",
"active_until": null,
"created_by_actor": {
"type": "system",
"id": null
},
"value": "https://example.com/avatar.png",
"attribute_type": "text"
}
]
}
}
}{
"status_code": 400,
"type": "invalid_request_error",
"code": "value_not_found",
"message": "No attribute was found for matching_attribute slug/ID \"my_attribute\"."
}{
"status_code": 403,
"type": "auth_error",
"code": "unauthorized",
"message": "You do not have the necessary permissions to create or update records of this object."
}{
"status_code": 404,
"type": "invalid_request_error",
"code": "not_found",
"message": "Object with slug/ID \"people\" not found."
}{
"status_code": 409,
"type": "invalid_request_error",
"code": "concurrent_write_conflict",
"message": "The record was modified by another request while this write was being validated. Please try again."
}Authorizations
This API uses OAuth 2.0 with the authorization code grant flow.
Scopes
record_permission:read-write
View, and optionally write, records.
object_configuration:read
View, and optionally write, the configuration and attributes of objects.
Query Parameters
The ID or slug of the attribute to use to check if a workspace already exists. The attribute does not have to be unique, but a value that matches more than one record is rejected. For workspace records, you can use workspace_id or any other matchable attribute.
Example:
"workspace_id"
Body
application/json
Show child attributes
Show child attributes
Response
Success
Success
Show child attributes
Show child attributes
Was this page helpful?