Update a project

PUT/accounting/{connection_id}/project/{id}

Parameters

Payload

idstring

created_atdate-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

updated_atdate-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

namestring

codestring

provider-side project code/number (e.g. NetSuite entityId, Intacct PROJECTID, BC jobNumber)

descriptionstring

status enum

Valid values:

"NOT_STARTED"

"IN_PROGRESS"

"ON_HOLD"

"COMPLETED"

"CANCELLED"

"CLOSED"

is_activeboolean

is_billableboolean

contact_idstring

the customer the project is for (reference to AccountingContact)

parent_idstring

parent project / sub-project hierarchy

manager_user_idstring

references a HRIS employee/user (reference to HrisEmployee)

started_atdate-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

due_atdate-time

planned/target end date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

ended_atdate-time

actual completion (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

currencystring

estimate_amountnumber

estimated_cost_amountnumber

actual_cost_amountnumber

invoiced_amountnumber

to_be_invoiced_amountnumber

expense_amountnumber

deposit_amountnumber

deposit_applied_amountnumber

credit_note_amountnumber

minutes_loggednumber

integer minutes, not hours

minutes_to_be_invoicednumber

integer minutes, not hours

percent_completenumber

0-100

billing_type enum

Valid values:

"FIXED_PRICE"

"TIME_AND_MATERIALS"

"MILESTONE"

"NON_BILLABLE"

category_idsstring array

(reference to AccountingCategory)

location_idstring

organization_idstring

metadata array

raw

Returns

AccountingProject

Response field	Type	Required	Description
`id`	string	No
`created_at`	string (date-time)	No	(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
`updated_at`	string (date-time)	No	(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
`name`	string	No
`code`	string	No	provider-side project code/number (e.g. NetSuite entityId, Intacct PROJECTID, BC jobNumber)
`description`	string	No
`status`	enum	No	Values: `NOT_STARTED`, `IN_PROGRESS`, `ON_HOLD`, `COMPLETED`, `CANCELLED`, `CLOSED`
`is_active`	boolean	No
`is_billable`	boolean	No
`contact_id`	string	No	the customer the project is for (reference to AccountingContact)
`parent_id`	string	No	parent project / sub-project hierarchy
`manager_user_id`	string	No	references a HRIS employee/user (reference to HrisEmployee)
`started_at`	string (date-time)	No	(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
`due_at`	string (date-time)	No	planned/target end date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
`ended_at`	string (date-time)	No	actual completion (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
`currency`	string	No
`estimate_amount`	number	No
`estimated_cost_amount`	number	No
`actual_cost_amount`	number	No
`invoiced_amount`	number	No
`to_be_invoiced_amount`	number	No
`expense_amount`	number	No
`deposit_amount`	number	No
`deposit_applied_amount`	number	No
`credit_note_amount`	number	No
`minutes_logged`	number	No	integer minutes, not hours
`minutes_to_be_invoiced`	number	No	integer minutes, not hours
`percent_complete`	number	No	0-100
`billing_type`	enum	No	Values: `FIXED_PRICE`, `TIME_AND_MATERIALS`, `MILESTONE`, `NON_BILLABLE`
`category_ids`	string[]	No	(reference to AccountingCategory)
`location_id`	string	No
`organization_id`	string	No
`metadata`	AccountingMetadata[]	No
`metadata[].id`	string	No
`metadata[].slug`	string	No
`metadata[].value`	object	No
`metadata[].namespace`	string	No
`metadata[].format`	enum	No	Values: `TEXT`, `NUMBER`, `DATE`, `BOOLEAN`, `FILE`, `TEXTAREA`, `SINGLE_SELECT`, `MULTIPLE_SELECT`, `MEASUREMENT`, `PRICE`, `YES_NO`, `CURRENCY`, `URL`
`metadata[].extra_data`	object	No

Errors

Errors return the HTTP status code and a JSON body with statusCode, error (the short label) and message (a human-readable detail).

{
  "statusCode": 429,
  "error": "Too Many Requests",
  "message": "Too many requests to unified.to API; max requests per minute: N"
}

Status	Error	Meaning
`400`	Bad Request	The request was malformed or failed validation.
`401`	Unauthorized	The connection is likely broken; re-authorize it.
`403`	Forbidden	The connection is missing permissions or scopes.
`404`	Not Found	The requested resource does not exist.
`429`	Too Many Requests	Rate limit exceeded (see the two sources below).
`500`	Internal Server Error	An unexpected error occurred.
`501`	Not Implemented	Not supported by this integration.

Errors from the underlying integration pass through: the integration's status comes back as ours (429, 401, 403, 404 or 5xx), usually with its message. When the integration's error body is unclear, Unified extracts what it can and returns a clearer message.

429 Too Many Requests

A 429 has two possible sources:

The integration's own rate limit, passed through.
Unified's workspace limit: a rolling 60 seconds, set by plan, with the message Too many requests to unified.to API; max requests per minute: N.

const options = {
  method: 'PUT',
  url: 'https://api.unified.to/accounting/5de520f96e439b002043d8dc/project/5de520f96e439b002043d8d8',
  headers: {
    authorization: 'bearer .....'
  },
  data: undefined,
  params: {
    fields: '',
    raw: '',
  }
};

const results = await axios.request(options);

Code Samples

Node.js SDK

import { UnifiedTo } from '@unified-api/typescript-sdk';

const sdk = new UnifiedTo({
    security: {
        jwt: '<YOUR_API_KEY_HERE>',
    },
});

const connectionId = '5de520f96e439b002043d8dc';

const id = '1234';

const results = await sdk.accounting.updateAccountingProject({ connectionId, id, accountingProject: { }, 
    fields: '',
    raw: '',
 });

Node.js (axios)

const options = {
  method: 'PUT',
  url: 'https://api.unified.to/accounting/5de520f96e439b002043d8dc/project/5de520f96e439b002043d8d8',
  headers: {
    authorization: 'bearer .....'
  },
  data: undefined,
  params: {
    fields: '',
    raw: '',
  }
};

const results = await axios.request(options);

Java

AsyncHttpClient client = new DefaultAsyncHttpClient();

client.prepare("PUT", "https://api.unified.to/accounting/5de520f96e439b002043d8dc/project/5de520f96e439b002043d8d8?fields=&raw=")
  .setHeader("accept", "application/json")
  .setHeader("authorization", ".....")
  .execute()
  .toCompletableFuture()
  .thenAccept(System.out::println)
  .join();

client.close();

Go

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

url := `https://api.unified.to/accounting/5de520f96e439b002043d8dc/project/5de520f96e439b002043d8d8?fields=&raw=

req, _ := http.NewRequest("PUT", url, nil)

req.Header.Add("accept", "application/json")
req.Header.Add("authorization", ".....")

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

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

Python

import requests

url = "https://api.unified.to/accounting/5de520f96e439b002043d8dc/project/5de520f96e439b002043d8d8?fields=&raw="

headers = {
    "accept": "application/json",
    "authorization": "....."
}

response = requests.put(url, headers=headers)

PHP

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.unified.to/accounting/5de520f96e439b002043d8dc/project/5de520f96e439b002043d8d8?fields=&raw=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: ....."
  ],
]);

Ruby

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.unified.to/accounting/5de520f96e439b002043d8dc/project/5de520f96e439b002043d8d8?fields=&raw=")

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

request = Net::HTTP::Put.new(url)
request["accept"] = 'application/json'
request["authorization"] = '....'

response = http.request(request)
puts response.read_body

cURL

curl --request PUT \
  --url 'https://api.unified.to/accounting/5de520f96e439b002043d8dc/project/5de520f96e439b002043d8d8?fields=&raw=' \
  --header 'accept: application/json' \
  --header 'authorization: .....'

Are we missing anything? Let us know

Was this page helpful?