Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

to access the Api directly through the URL:

replace 'USER NAME' with Troi User Name and 'USER PASSWORD' with Troi Password and run the following script

Code Block
languagephp
<?php
$user = 'USER NAME';
$password = 'USER PASSWORD';
$hashString = base64_encode($user.':'.md5($password));
print_r($hashString);
?>

then add your $hashString to the URL.

Example:

https://example.troi.de/TroiSubDomain/api/v2/rest/contacts/?auth=Basic+EMPTY SPACE+YOUR GENERATED HASH

Like:

https://example.troi.de/TroiSubDomain/api/v2/rest/contacts/?auth=Basic abcdefghijk1234abcdefg


URIDescriptionMethod NameMethod Return ValueParameter NameRequired/OptionalParameter ValueParameter RemarkExampleTest Units

Absences

/api/v2/rest/absences/
Status
colourBlue
titleGET
ApiAbsence[]start
Status
subtletrue
colourRed
titleREQUIRED
string (yyyymmdd)Fetch all absences for the given Start Date and End Date/api/v2/rest/absences?start=20150401&end=20160601

Status
colourGreen
titleyes

/api/v2/rest/absences/

Status
colourBlue
titleGET

 end
Status
subtletrue
colourRed
titleREQUIRED
string (yyyymmdd)Fetch all absences for the given Start Date and End Date/api/v2/rest/absences?start=20150401&end=20160601

 

Status
colourGreen
titleyes

 

/api/v2/rest/absences/

Status
colourBlue
titleGET

 employeeId
Status
subtletrue
colourGreen
titleOptional
intFetch all Absences for the given employeeId/api/v2/rest/absences?start=20150401&end=20160601&employeeId=33

 

Status
colourGreen
titleyes

 

/api/v2/rest/absences/[id]
Status
colourBlue
titleGET
ApiAbsence   Fetch Absence for the given Absence ID/api/v2/rest/absences/1

Status
colourGreen
titleyes

Account Groups

/api/v2/rest/accountGroups/
Status
colourBlue
titleGET
ApiAccountGroup[]clientId
Status
subtletrue
colourRed
titleREQUIRED
intFetch all Account Groups for the given clientId/api/v2/rest/accountGroups?clientId=1

Status
colourGreen
titleyes

/api/v2/rest/accountGroups/[id]
Status
colourBlue
titleGET
ApiAccountGroup   Fetch Account Group for the given Account Group ID/api/v2/rest/accountGroups/1

Status
colourGreen
titleyes

/api/v2/rest/accountGroups/

Status
colourGreen
titlePOST

ApiSyncItem   Save Absence Groups Object/api/v2/rest/accountGroups/[accountGroups Object]

Status
colourGreen
titleyes

/api/v2/rest/accountGroups/

Status
colourYellow
titlePUT

ApiSyncItem   Update Absence Groups Object/api/v2/rest/accountGroups/[accountGroups Object]

Status
colourGreen
titleyes

/api/v2/rest/accountGroups/

Status
colourRed
titleDELETE

Account Group ID   Delete Absence Groups/api/v2/rest/accountGroups/[accountGroups ID]

Status
colourGreen
titleyes

Accounting Entries

/api/v2/rest/accountingEntries/
Status
colourBlue
titleGET
ApiAccountingEntry[]clientId
Status
subtletrue
colourRed
titleREQUIRED
intFetch all Accounting Entries for the given clientId/api/v2/rest/accountingEntries?clientId=1

Status
colourGreen
titleyes

/api/v2/rest/accountingEntries/

Status
colourBlue
titleGET

 cpId

Status
subtletrue
colourGreen
titleOptional

intFetch all Accounting Entries for the given CalculationPosition ID/api/v2/rest/accountingEntries?clientId=1&cpId=1

Status
colourGreen
titleyes

/api/v2/rest/accountingEntries/

Status
colourBlue
titleGET

 projectId

Status
subtletrue
colourGreen
titleOptional

intFetch all Accounting Entries for the given Project ID/api/v2/rest/accountingEntries?clientId=1&projectId=1

Status
colourGreen
titleyes

/api/v2/rest/accountingEntries/

Status
colourBlue
titleGET

 accountingEntryCollectionId

Status
subtletrue
colourGreen
titleOptional

intFetch all Accounting Entries for the given AccountingEntryCollection ID/api/v2/rest/accountingEntries?clientId=1&accountingEntryCollectionId=1

Status
colourGreen
titleyes

/api/v2/rest/accountingEntries/[id]

Status
colourBlue
titleGET

ApiAccountingEntry   Fetch Accounting Entry for the given Accounting Entry ID/api/v2/rest/accountingEntries/1

Status
colourGreen
titleyes

/api/v2/rest/accountingEntries/

Status
colourGreen
titlePOST

ApiSyncItem   Save Accounting Entry Object/api/v2/rest/accountingEntries/[accountingEntries Object]

Status
colourGreen
titleyes

/api/v2/rest/accountingEntries/

Status
colourYellow
titlePUT

ApiSyncItem   Update Accounting Entry Object/api/v2/rest/accountingEntries/[accountingEntries Object]

Status
colourGreen
titleyes

/api/v2/rest/accountingEntries/

Status
colourRed
titleDELETE

Accounting Entry ID   Delete Accounting Entry/api/v2/rest/accountingEntries/[accountingEntries ID]

Status
colourGreen
titleyes

Accounting Entry Collections

/api/v2/rest/accountingEntryCollections/
Status
colourBlue
titleGET
ApiAccountingEntryCollection[]clientId
Status
subtletrue
colourRed
titleREQUIRED
intFetch All Accounting Entry Collections for the given clientId/api/v2/rest/accountingEntryCollections?clientId=1

Status
colourGreen
titleyes

/api/v2/rest/accountingEntryCollections/

Status
colourBlue
titleGET

 type

Status
subtletrue
colourGreen
titleOptional

int

Fetch All Accounting Entry Collections for the given type

0 = export collections, 1 = import collections

/api/v2/rest/accountingEntryCollections?clientId=1&type=1

Status
colourGreen
titleyes

/api/v2/rest/accountingEntryCollections/

Status
colourBlue
titleGET

 year

Status
subtletrue
colourGreen
titleOptional

stringFetch All Accounting Entry Collections for the given year/api/v2/rest/accountingEntryCollections?clientId=1&year=2016

Status
colourGreen
titleyes

/api/v2/rest/accountingEntryCollections/[id]

Status
colourBlue
titleGET

ApiAccountingEntryCollection    /api/v2/rest/accountingEntryCollections/1

Status
colourGreen
titleyes

/api/v2/rest/accountingEntryCollections/

Status
colourGreen
titlePOST

ApiSyncItem   Save Accounting Entry Collections/api/v2/rest/accountingEntryCollections/[accountingEntryCollections Object]

Status
colourGreen
titleyes

/api/v2/rest/accountingEntryCollections/

Status
colourYellow
titlePUT

ApiSyncItem   Update Accounting Entry Collections/api/v2/rest/accountingEntryCollections/[accountingEntryCollections Object]

Status
colourGreen
titleyes

/api/v2/rest/accountingEntryCollections/

Status
colourRed
titleDELETE

Accounting Entry Collection ID   Delete Accounting Entry Collections/api/v2/rest/accountingEntryCollections/[accountingEntryCollections ID]

Status
colourGreen
titleyes

Accounts

/api/v2/rest/accounts/
Status
colourBlue
titleGET
ApiAccount[]clientId
Status
subtletrue
colourRed
titleREQUIRED
int /api/v2/rest/accounts?clientId=1

Status
colourGreen
titleyes

/api/v2/rest/accounts/

Status
colourBlue
titleGET

 accountGroupId
Status
subtletrue
colourGreen
titleOptional
int /api/v2/rest/accounts?clientId=1&accountGroupId=1

Status
colourGreen
titleyes

/api/v2/rest/accounts/

Status
colourBlue
titleGET

 account_is_cash_or_bank

Status
subtletrue
colourGreen
titleOptional

boolean (true/false) /api/v2/rest/accounts?clientId=1&account_is_cash_or_bank=true

Status
colourGreen
titleyes

/api/v2/rest/accounts/[id]

Status
colourBlue
titleGET

ApiAccount    /api/v2/rest/accounts/[Id]

Status
colourGreen
titleyes

/api/v2/rest/accounts/

Status
colourGreen
titlePOST

ApiSyncItem    /api/v2/rest/accounts/[accounts Object]

Status
colourGreen
titleyes

/api/v2/rest/accounts/

Status
colourYellow
titlePUT

ApiSyncItem    /api/v2/rest/accounts/[accounts Object]

Status
colourGreen
titleyes

/api/v2/rest/accounts/

Status
colourRed
titleDELETE

Account ID    /api/v2/rest/accounts/[accounts ID]

Status
colourGreen
titleyes

Billings - Hours

/api/v2/rest/billings/hours/
Status
colourBlue
titleGET
ApiHourBilling[]employeeId
Status
subtletrue
colourRed
titleREQUIRED
int

employeeId or calculationPositionId or projectId or subprojectId or startDate+endDate is mandatory

Fetch all Billings for the given parameter

/api/v2/rest/billings/hours?employeeId=1

Status
colourGreen
titleyes

/api/v2/rest/billings/hours/

Status
colourBlue
titleGET

 calculationPositionId
Status
subtletrue
colourGreen
titleOptional 1
intFetch all Billings for the given Calculation Position ID/api/v2/rest/billings/hours?calculationPositionId=1

Status
colourGreen
titleyes

/api/v2/rest/billings/hours/

Status
colourBlue
titleGET

 projectId
Status
subtletrue
colourGreen
titleOptional 1
intFetch all Billings for the given Project ID/api/v2/rest/billings/hours?projectId=1

Status
colourGreen
titleyes

/api/v2/rest/billings/hours/

Status
colourBlue
titleGET

 subprojectId
Status
subtletrue
colourGreen
titleOptional 1
intFetch all Billings for the given Subproject ID/api/v2/rest/billings/hours?subprojectId=1

Status
colourGreen
titleyes

/api/v2/rest/billings/hours/

Status
colourBlue
titleGET

 startDate
Status
subtletrue
colourGreen
titleOptional 1
string (yyyymmdd)Fetch all Billings for the given Start Date/api/v2/rest/billings/hours?startDate=20160101&endDate=20160120

Status
colourGreen
titleyes

/api/v2/rest/billings/hours/

Status
colourBlue
titleGET

 endDate
Status
subtletrue
colourGreen
titleOptional 1
string (yyyymmdd)Fetch all Billings for the given End Date/api/v2/rest/billings/hours?startDate=20160101&endDate=20160120

Status
colourGreen
titleyes

/api/v2/rest/billings/hours/

Status
colourBlue
titleGET

ApiHourBillingExt[]extendedObject
Status
subtletrue
colourGreen
titleOptional
boolean (true/false)

extended object contains the full calculation position display path

/api/v2/rest/billings/hours?employeeId=1&extendedObject=true

Status
colourGreen
titleyes

/api/v2/rest/billings/hours/

Status
colourBlue
titleGET

 fillsyncitems

Status
subtletrue
colourGreen
titleOptional

boolean (true/false)Fetch all Billings and fill the empty objects if there is any/api/v2/rest/billings/hours?employeeId=1&fillsyncitems=true

Status
colourGreen
titleyes

/api/v2/rest/billings/hours/

Status
colourGreen
titlePOST

ApiSyncItem   Save Billing 

Status
colourGreen
titleyes

/api/v2/rest/billings/hours/[id]
Status
colourBlue
titleGET
ApiHourBilling   Fetch Billing for the given Billing ID/api/v2/rest/billings/hours/1

Status
colourGreen
titleyes

/api/v2/rest/billings/hours/[id] ApiHourBillingExtextendedObject
Status
subtletrue
colourGreen
titleOptional
boolean (true/false)extended object contains the full calculation position display path/api/v2/rest/billings/hours/1?extendedObject=true 
/api/v2/rest/billings/hours/
Status
colourYellow
titlePUT
ApiSyncItem   Update Billing/api/v2/rest/billings/hours/[Billing Object]

Status
colourGreen
titleyes

/api/v2/rest/billings/hours/
Status
colourRed
titleDELETE
Billing Hour ID   Delete Billing/api/v2/rest/billings/hours/[Billing ID]

Status
colourGreen
titleyes

Booking Year

/api/v2/rest/bookingYears/

Status
colourBlue
titleGET

ApiBookingYearclientId
Status
subtletrue
colourRed
titleREQUIRED
 Fetch all Booking Years for the given client ID/api/v2/rest/bookingYears?clientId=1

Status
colourGreen
titleyes

/api/v2/rest/bookingYears/[id]

Status
colourBlue
titleGET

ApiBookingYear   Fetch Booking Year for the given ID/api/v2/rest/bookingYears/1

Status
colourGreen
titleyes

/api/v2/rest/bookingYears/

Status
colourGreen
titlePOST

ApiSyncItem   Save Booking Year/api/v2/rest/bookingYears/[Booking Year Object]

Status
colourGreen
titleyes

/api/v2/rest/bookingYears/

Status
colourYellow
titlePUT

ApiSyncItem   Update Booking Year/api/v2/rest/bookingYears/[Booking Year Object]

Status
colourGreen
titleyes

/api/v2/rest/bookingYears/

Status
colourRed
titleDELETE

Booking Year ID   Delete Booking Year/api/v2/rest/bookingYears/[Booking Year ID]

Status
colourGreen
titleyes

Calculation Positions

/api/v2/rest/calculationPositions/
Status
colourBlue
titleGET
ApiCalculationPosition[]clientId
Status
subtletrue
colourRed
titleREQUIRED
intFetch All all Calculation Positions for the given Client ID/api/v2/rest/calculationPositions?clientId=1

Status
colourGreen
titleyes

/api/v2/rest/calculationPositions/

Status
colourBlue
titleGET

 projectId
Status
subtletrue
colourGreen
titleOptional
intFetch All all Calculation Positions for the given Project ID/api/v2/rest/calculationPositions?clientId=1&projectId=1

Status
colourGreen
titleyes

/api/v2/rest/calculationPositions/

Status
colourBlue
titleGET

 subprojectId
Status
subtletrue
colourGreen
titleOptional
intFetch All all Calculation Positions for the given Subproject ID/api/v2/rest/calculationPositions?clientId=1&subprojectId=1

Status
colourGreen
titleyes

/api/v2/rest/calculationPositions/

Status
colourBlue
titleGET

 search
Status
subtletrue
colourGreen
titleOptional
stringFetch All all Calculation Positions for the given Search Term/api/v2/rest/calculationPositions?clientId=1&search=Calculation Position Name

Status
colourGreen
titleyes

/api/v2/rest/calculationPositions/

Status
colourBlue
titleGET

 timeRecording
Status
subtletrue
colourGreen
titleOptional
boolean (true/false)returns on valid time recording positions for the user/api/v2/rest/calculationPositions?clientId=1&timeRecording=true

Status
colourGreen
titleyes

/api/v2/rest/calculationPositions/

Status
colourBlue
titleGET

 favoritesOnly
Status
subtletrue
colourGreen
titleOptional
boolean (true/false)returns on favorite time recording positions for the user/api/v2/rest/calculationPositions?clientId=1&favoritesOnly=true

Status
colourGreen
titleyes

/api/v2/rest/calculationPositions/

Status
colourBlue
titleGET

 withoutHourClosed
Status
subtletrue
colourGreen
titleOptional
boolean (true/false)returns only cp that are not closed for time recording/api/v2/rest/calculationPositions?clientId=1&withoutHourClosed=true

Status
colourGreen
titleyes

/api/v2/rest/calculationPositions/

Status
colourBlue
titleGET

 ree_date

Status
subtletrue
colourGreen
titleOptional

String (yyyymmdd OR dd.mm.yyyy OR current_date)return Rest Expenses Estimation for the given Calculation Position/api/v2/rest/calculationPositions?clientId=1&ree_date=20160101

Status
colourGreen
titleyes

/api/v2/rest/calculationPositions/

Status
colourBlue
titleGET

 projectStatusId

Status
subtletrue
colourGreen
titleOptional

intFetch all Calculation Positions for the given Project Status ID/api/v2/rest/calculationPositions?clientId=1&projectStatusId=11

Status
colourGreen
titleyes

/api/v2/rest/calculationPositions/

Status
colourBlue
titleGET

 bookKeeping

Status
subtletrue
colourGreen
titleOptional

boolean (true/false)Fetch all Calculation Positions for the given Book keeping/api/v2/rest/calculationPositions?clientId=1&bookKeeping=true

Status
colourGreen
titleyes

/api/v2/rest/calculationPositions/

Status
colourBlue
titleGET

 projectIds

Status
subtletrue
colourGreen
titleOptional

stringFetch all Calculation Positions for the given Project IDs/api/v2/rest/calculationPositions?clientId=1&projectIds=1,2,3

Status
colourGreen
titleyes

/api/v2/rest/calculationPositions/

Status
colourBlue
titleGET

 issueTrackerProjectKey

Status
subtletrue
colourGreen
titleOptional

stringFetch all Calculation Positions for the given issue Tracker Project Key/api/v2/rest/calculationPositions?clientId=1&issueTrackerProjectKey=test

Status
colourGreen
titleyes

/api/v2/rest/calculationPositions/
Status
colourGreen
titlePOST
ApiSyncItemsynctoken
Status
subtletrue
colourRed
titleREQUIRED
string (ApiCalculationPosition)Save Calculation Position/api/v2/rest/calculationPositions/[Calculation Positions Object]

Status
colourGreen
titleyes

/api/v2/rest/calculationPositions/[id]
Status
colourBlue
titleGET
ApiCalculationPosition   Fetch Calculation Position for the given Calculation Position ID/api/v2/rest/calculationPositions/[Calculation Positions ID]

Status
colourGreen
titleyes

/api/v2/rest/calculationPositions/
Status
colourYellow
titlePUT
ApiSyncItem 

 

(ApiCalculationPosition)Update Calculation Position/api/v2/rest/calculationPositions/[Calculation Positions Object]

Status
colourGreen
titleyes

/api/v2/rest/calculationPositions/
Status
colourRed
titleDELETE
Calculation Position IDsynctoken

Status
subtletrue
colourRed
titleREQUIRED

(ApiCalculationPosition)Delete Calculation Position/api/v2/rest/calculationPositions/[Calculation Positions ID]

Status
colourGreen
titleyes

Calendar Events

/api/v2/rest/calendarEvents/
Status
colourBlue
titleGET
ApiCalendarEvent[]start
Status
subtletrue
colourRed
titleREQUIRED
string(8)YYYYMMDD/api/v2/rest/calendarEvents?start=20121119&end=20121125

Status
colourGreen
titleyes

/api/v2/rest/calendarEvents/

Status
colourBlue
titleGET

 end
Status
subtletrue
colourRed
titleREQUIRED
string(8)YYYYMMDD/api/v2/rest/calendarEvents?start=20121119&end=20121125 
/api/v2/rest/calendarEvents/

Status
colourBlue
titleGET

 search_key
Status
subtletrue
colourGreen
titleOptional
string /api/v2/rest/calendarEvents?start=20121119&end=20121125&search_key=Calender Event Description

Status
colourGreen
titleyes

/api/v2/rest/calendarEvents/

Status
colourBlue
titleGET

 owner_employee_id
Status
subtletrue
colourGreen
titleOptional
int /api/v2/rest/calendarEvents?start=20121119&end=20121125&owner_employee_id=33

Status
colourGreen
titleyes

/api/v2/rest/calendarEvents/

Status
colourBlue
titleGET

 type
Status
subtletrue
colourGreen
titleOptional
["R","H","G","P","T"]R=regular, H=holiday, G=general, P=private, T=assigment/api/v2/rest/calendarEvents?start=20121119&end=20121125&type=["R","H","G","P","T"]

Status
colourGreen
titleyes

/api/v2/rest/calendarEvents/

Status
colourBlue
titleGET

 withoutAbsences

Status
subtletrue
colourGreen
titleOptional

boolean (true/false) /api/v2/rest/calendarEvents?start=20121119&end=20121125&withoutAbsences=true

Status
colourGreen
titleyes

/api/v2/rest/calendarEvents/
Status
colourGreen
titlePOST
ApiSyncItem   Save Calendar Event/api/v2/rest/calendarEvents/[Calendar Event Object]

Status
colourGreen
titleyes

/api/v2/rest/calendarEvents/[id]
Status
colourBlue
titleGET
ApiCalendarEvent   Fetch Calendar Event for the given ID/api/v2/rest/calendarEvents/1

Status
colourGreen
titleyes

/api/v2/rest/calendarEvents/
Status
colourYellow
titlePUT
ApiSyncItem   Update Calendar Events/api/v2/rest/calendarEvents/[Calendar Event Object]

Status
colourGreen
titleyes

/api/v2/rest/calendarEvents/
Status
colourRed
titleDELETE
Calendar Event ID   Delete Calendar Events/api/v2/rest/calendarEvents/1

Status
colourGreen
titleyes

Calendar Event Participants

/api/v2/rest/calendarEventParticipants/
Status
colourBlue
titleGET
ApiCalendarEventParticipant[]calendarEventId
Status
subtletrue
colourGreen
titleOptional
intFetch all Calendar Event Participants for the given Calendar Event ID/api/v2/rest/calendarEventParticipants?calendarEventId=1

Status
colourGreen
titleyes

/api/v2/rest/calendarEventParticipants/

Status
colourBlue
titleGET

 employeeId
Status
subtletrue
colourGreen
titleOptional
intFetch all Calendar Event Participants for the givenEmployee ID/api/v2/rest/calendarEventParticipants?employeeId=1

Status
colourGreen
titleyes

/api/v2/rest/calendarEventParticipants/
Status
colourGreen
titlePOST
ApiSyncItem   Save Calendar Event Participants/api/v2/rest/calendarEventParticipants/[Calendar Event Participant Object]

Status
colourGreen
titleyes

/api/v2/rest/calendarEventParticipants/[id]
Status
colourBlue
titleGET
ApiCalendarEventParticipant   Fetch Calendar Event Participant for the given Calendar Event Participant ID/api/v2/rest/calendarEventParticipants/1

Status
colourGreen
titleyes

/api/v2/rest/calendarEventParticipants/
Status
colourYellow
titlePUT
ApiSyncItem   Update Calendar Event Participant/api/v2/rest/calendarEventParticipants/[Calendar Event Participant Object]

Status
colourGreen
titleyes

/api/v2/rest/calendarEventParticipants/
Status
colourRed
titleDELETE
Calendar Event Participant ID   Delete Calendar Event Participant/api/v2/rest/calendarEventParticipants/1

Status
colourGreen
titleyes

Tenants (formerly Clients)

/api/v2/rest/clients/
Status
colourBlue
titleGET
ApiClient[]   Fetch all Clients/api/v2/rest/clients/

Status
colourGreen
titleyes

/api/v2/rest/clients/[id]
Status
colourBlue
titleGET
ApiClient   Fetch Client for the Given Client ID/api/v2/rest/clients/[Client ID]

Status
colourGreen
titleyes

Contacts

/api/v2/rest/contacts/
Status
colourBlue
titleGET
ApiContact[], ApiSyncItem[]syncItem
Status
subtletrue
colourGreen
titleOptional
boolean (true/false)Fetch Contacts and return them as Sync Item/api/v2/rest/contacts?syncItem=true

Status
colourGreen
titleyes

/api/v2/rest/contacts/

Status
colourBlue
titleGET

 from
Status
subtletrue
colourGreen
titleOptional
intFetch Contacts from the given ID, use togehter with "size"/api/v2/rest/contacts?from=100&size=50

Status
colourGreen
titleyes

/api/v2/rest/contacts/

Status
colourBlue
titleGET

 size
Status
subtletrue
colourGreen
titleOptional
intFetch Contacts for the given size use together with "from"/api/v2/rest/contacts?from=100&size=50

Status
colourGreen
titleyes

/api/v2/rest/contacts/

Status
colourBlue
titleGET

 since
Status
subtletrue
colourGreen
titleOptional
valid ETag (yymmddhhmmss)Fetch Contacts for the given date time (only items modified since ETag will be returned)/api/v2/rest/contacts?since=20110722153556

Status
colourGreen
titleyes

/api/v2/rest/contacts/

Status
colourBlue
titleGET

 favoritesOnly
Status
subtletrue
colourGreen
titleOptional
boolean (true/false)Fetch favorites Contacts only/api/v2/rest/contacts?favoritesOnly=true

Status
colourGreen
titleyes

/api/v2/rest/contacts/

Status
colourBlue
titleGET

 contactType
Status
subtletrue
colourGreen
titleOptional
ApiContact:Person, ApiContact:Department, ApiContact:CompanyFetch Contacts for the given Contact Type/api/v2/rest/contacts?contactType=ApiContact:Person

Status
colourGreen
titleyes

/api/v2/rest/contacts/

Status
colourBlue
titleGET

 search
Status
subtletrue
colourGreen
titleOptional
stringFetch Contacts for the given Search Term/api/v2/rest/contacts?search=test

Status
colourGreen
titleyes

/api/v2/rest/contacts/

Status
colourBlue
titleGET

 searchField
Status
subtletrue
colourGreen
titleOptional
JSON

Fetch Contacts for the given Search Field

single value:
searchField={"categoryId":392}

multiple values:
searchField={"categoryId":[392,396]} 

/api/v2/rest/contacts?searchField={"categoryId":392} 

Status
colourGreen
titleyes

/api/v2/rest/contacts/

Status
colourBlue
titleGET

 withCustomFields
Status
subtletrue
colourGreen
titleOptional
int

Fetch Contacts for the given with Custom Field

/api/v2/rest/contacts?withCustomFields=1

Status
colourGreen
titleyes

/api/v2/rest/contacts/

Status
colourBlue
titleGET

 parentId

Status
subtletrue
colourGreen
titleOptional

intFetch Contacts for the given parent ID/api/v2/rest/contacts?parentId=1234

Status
colourGreen
titleyes

/api/v2/rest/contacts/
Status
colourBlue
titleGET
 isAssociatedWithCustomer

Status
subtletrue
colourGreen
titleOptional

boolean (true/false)

show all contacts that associated with some customer

/api/v2/rest/contacts?isAssociatedWithCustomer=true

Status
colourGreen
titleyes

/api/v2/rest/contacts/

Status
colourBlue
titleGET

 onlyInactive

Status
subtletrue
colourGreen
titleOptional

boolean (true/false)show all inactive contacts/api/v2/rest/contacts?onlyInactive=true 
/api/v2/rest/contacts/
Status
colourGreen
titlePOST
ApiSyncItem   Save Contact 

Status
colourGreen
titleyes

/api/v2/rest/contacts/[id]

Status
colourBlue
titleGET

ApiSyncItemwithCustomFields
Status
subtletrue
colourGreen
titleOptional
 Fetch Contact for the given with custom Field/api/v2/rest/contacts/1?withCustomFields=1

Status
colourGreen
titleyes

/api/v2/rest/contacts/
Status
colourYellow
titlePUT
ApiSyncItem   Update Contact/api/v2/rest/contacts/[Contact Object]

Status
colourGreen
titleyes

/api/v2/rest/contacts/
Status
colourRed
titleDELETE
Contact ID   Delete Contact/api/v2/rest/contacts/1

Status
colourGreen
titleyes

Contacts Logical Database

 

 

/api/v2/rest/contactCategories/
Status
colourBlue
titleGET
ApiContactCategory[]contactId
Status
subtletrue
colourGreen
titleOptional
intFetch all Contact Categories for the given Contact ID/api/v2/rest/contactCategories?contactId=123

Status
colourGreen
titleyes

/api/v2/rest/contactCategories/

Status
colourBlue
titleGET

 categoryId
Status
subtletrue
colourGreen
titleOptional
intFetch all Contact Categories for the given Category ID/api/v2/rest/contactCategories?categoryId=123

Status
colourGreen
titleyes

/api/v2/rest/contactCategories/

Status
colourBlue
titleGET

 size
Status
subtletrue
colourGreen
titleOptional
intFetch Contact Categories for the given size use together with "from"/api/v2/rest/contactCategories?size=100

Status
colourGreen
titleyes

/api/v2/rest/contactCategories/

Status
colourBlue
titleGET

 from
Status
subtletrue
colourGreen
titleOptional
intFetch Contact Category from the given ID use together with "size"/api/v2/rest/contactCategories?size=100&from=200

Status
colourGreen
titleyes

/api/v2/rest/contactCategories/
Status
colourGreen
titlePOST
ApiSyncItem   Save Contact Category/api/v2/rest/contactCategories/[Contact Category Object]

Status
colourGreen
titleyes

/api/v2/rest/contactCategories/[id]
Status
colourBlue
titleGET
ApiContactCategory   Fetch Contact Category for the given ID/api/v2/rest/contactCategories/123

Status
colourGreen
titleyes

/api/v2/rest/contactCategories/
Status
colourRed
titleDELETE
ContactCategory ID   Delete Contact Category/api/v2/rest/contactCategories/123

Status
colourGreen
titleyes

Customers

/api/v2/rest/customers/
Status
colourBlue
titleGET
ApiCustomer[]clientId
Status
subtletrue
colourRed
titleREQUIRED
intFetch all Customers for the given Client ID/api/v2/rest/customers?clientId=1

Status
colourGreen
titleyes

/api/v2/rest/customers/

Status
colourBlue
titleGET

ApiSyncItem[]syncItem
Status
subtletrue
colourGreen
titleOptional
boolean (true/false)Fetch all Customers for the given Client ID and return them as SyncItems/api/v2/rest/customers?clientId=1&syncItem=true

Status
colourGreen
titleyes

/api/v2/rest/customers/

Status
colourBlue
titleGET

 isActive
Status
subtletrue
colourGreen
titleOptional
boolean (true/false)

Fetch all active Customers

if ommited, all customers are returned

/api/v2/rest/customers?clientId=1&isActive=true

Status
colourGreen
titleyes

/api/v2/rest/customers/
Status
colourGreen
titlePOST
ApiSyncItem   Save Customer/api/v2/rest/customers/[Customer Object]

Status
colourGreen
titleyes

/api/v2/rest/customers/[id]
Status
colourBlue
titleGET
ApiCustomer   Fetch Customer for the given Customer ID/api/v2/rest/customers/1

Status
colourGreen
titleyes

/api/v2/rest/customers/
Status
colourYellow
titlePUT
ApiSyncItem   Update Customer/api/v2/rest/customers/[Customer Object]

Status
colourGreen
titleyes

Suppliers

/api/v2/rest/suppliers/
Status
colourBlue
titleGET
ApiSupplier[]clientId
Status
subtletrue
colourRed
titleREQUIRED
intFetch all Suppliers for the given Client ID/api/v2/rest/suppliers?clientId=1

Status
colourGreen
titleyes

/api/v2/rest/suppliers/

Status
colourBlue
titleGET

 returnApiSyncItems

Status
subtletrue
colourGreen
titleOptional

boolean (true/false)Fetch all Suppliers and return them as SyncItems/api/v2/rest/suppliers?clientId=1&returnApiSyncItems=true

Status
colourGreen
titleyes

/api/v2/rest/suppliers/

Status
colourBlue
titleGET

 search

Status
subtletrue
colourGreen
titleOptional

stringFetch all Suppliers for the given Search term/api/v2/rest/suppliers?clientId=1&search=Supplier Name

Status
colourGreen
titleyes

/api/v2/rest/suppliers/

Status
colourBlue
titleGET

 isActive

Status
subtletrue
colourGreen
titleOptional

boolean (true/false)Fetch all Active Suppliers/api/v2/rest/suppliers?clientId=1&isActive=true

Status
colourGreen
titleyes

/api/v2/rest/suppliers/

Status
colourBlue
titleGET

 showReferenceDetails

Status
subtletrue
colourGreen
titleOptional

boolean (true/false)Fetch all Suppliers and return extended payment term array/api/v2/rest/suppliers?clientId=1&showReferenceDetails=true 
/api/v2/rest/suppliers/
Status
colourGreen
titlePOST
ApiSyncItem   Save Supplier/api/v2/rest/suppliers/[Supplier Object]

Status
colourGreen
titleyes

/api/v2/rest/suppliers/[id]
Status
colourBlue
titleGET
ApiSupplier   Fetch supplier for the given ID/api/v2/rest/suppliers/1

Status
colourGreen
titleyes

/api/v2/rest/suppliers/
Status
colourYellow
titlePUT
ApiSyncItem   Update Supplier/api/v2/rest/suppliers/[Supplier Object]

Status
colourGreen
titleyes

EmployeeProjects

/api/v2/rest/employeeProjects/
Status
colourBlue
titleGET
ApiEmployeeProject[]employeeId
Status
subtletrue
colourRed
titleREQUIRED 1
intFetch all Employee Projects for the given employee ID/api/v2/rest/employeeProjects?employeeId=123

Status
colourGreen
titleyes

/api/v2/rest/employeeProjects/[id]
Status
colourBlue
titleGET
ApiEmployeeProject   Fetch Employee Project for the given ID/api/v2/rest/employeeProjects/1

Status
colourGreen
titleyes

/api/v2/rest/employeeProjects/
Status
colourYellow
titlePUT
ApiSyncItem   Update Employee Project/api/v2/rest/employeeProjects/[Employee Project Object]

Status
colourGreen
titleyes

/api/v2/rest/employeeProjects/
Status
colourRed
titleDELETE
EmployeeProject ID   Delete Employee Project/api/v2/rest/employeeProjects/1

Status
colourGreen
titleyes

/api/v2/rest/employeeProjects/

Status
colourGreen
titlePOST

ApiSyncItem   Save Employee Project/api/v2/rest/employeeProjects/[Employee Project Object]

Status
colourGreen
titleyes

Employees

/api/v2/rest/employees/
Status
colourBlue
titleGET
ApiEmployee[]clientId
Status
subtletrue
colourRed
titleREQUIRED
intFetch Employees for the given Client ID/api/v2/rest/employees?clientId=1

Status
colourGreen
titleyes

/api/v2/rest/employees/

Status
colourBlue
titleGET

 employeeBrand
Status
subtletrue
colourGreen
titleOptional
stringFetch Employees for the given Client ID and Employee Brand/api/v2/rest/employees?clientId=1&employeeBrand=N,E

Status
colourGreen
titleyes

/api/v2/rest/employees/

Status
colourBlue
titleGET

 employeeLoginName
Status
subtletrue
colourGreen
titleOptional
stringFetch Employees for the given Client ID and Employee Login Name/api/v2/rest/employees?clientId=1&employeeLoginName=USER

Status
colourGreen
titleyes

/api/v2/rest/employees/

Status
colourBlue
titleGET

 checkForEnabledExchangeSync
Status
subtletrue
colourGreen
titleOptional
boolean (true/false)Fetch Employees for the given Client ID and employees with activated exchange sync/api/v2/rest/employees?clientId=1&checkForEnabledExchangeSync=true

Status
colourGreen
titleyes

/api/v2/rest/employees/

Status
colourBlue
titleGET

 ignoreClient
Status
subtletrue
colourGreen
titleOptional
 Fetch Employees for the given Client ID and return employees without client check/api/v2/rest/employees?clientId=1&ignoreClient

Status
colourGreen
titleyes

/api/v2/rest/employees/
Status
colourGreen
titlePOST
ApiSyncItem   Save Employee/api/v2/rest/employees/[Employee Object]

Status
colourGreen
titleyes

/api/v2/rest/employees/[id]
Status
colourBlue
titleGET
ApiEmployee   Fetch Employee for the given Employee ID/api/v2/rest/employees/1

Status
colourGreen
titleyes

/api/v2/rest/employees/
Status
colourYellow
titlePUT
ApiSyncItem   Update Employee/api/v2/rest/employees/[Employee Object]

Status
colourGreen
titleyes

Projects

/api/v2/rest/projects/
Status
colourBlue
titleGET
ApiProject[], ApiSyncItem[]clientId

 

Status
subtletrue
colourRed
titleREQUIRED

 

intFetch All Projects for the given Client ID/api/v2/rest/project?clientId=1

Status
colourGreen
titleyes

/api/v2/rest/projects/

Status
colourBlue
titleGET

 from
Status
subtletrue
colourGreen
titleOptional
intFetch All Projects for the given Client ID and start with given Project ID, use togehter with "size"/api/v2/rest/projects?clientId=1&from=100&size=50

Status
colourGreen
titleyes

/api/v2/rest/projects/

Status
colourBlue
titleGET

 size
Status
subtletrue
colourGreen
titleOptional
intFetch All Projects for the given Client ID and the given limit, use together with "from"/api/v2/rest/projects?clientId=1&from=100&size=50

Status
colourGreen
titleyes

/api/v2/rest/projects/

Status
colourBlue
titleGET

 since
Status
subtletrue
colourGreen
titleOptional
valid ETagFetch All Projects for the given Client ID and given date, only items modified since ETag will be returned/api/v2/rest/projects?clientId=1&since=20110722153556

Status
colourGreen
titleyes

/api/v2/rest/projects/

Status
colourBlue
titleGET

 syncItem

Status
subtletrue
colourGreen
titleOptional

boolean (true/false)Fetch All Projects for the given Client ID and set syncitems "true" to return ApiSyncItems/api/v2/rest/projects?clientId=1&syncItem=true

Status
colourGreen
titleyes

/api/v2/rest/projects/

Status
colourBlue
titleGET

 customerId
Status
subtletrue
colourGreen
titleOptional
stringFetch All Projects for the given Client ID and given Customer ID/api/v2/rest/projects?clientId=1&customerId=1

Status
colourGreen
titleyes

/api/v2/rest/projects/

Status
colourBlue
titleGET

 customerIsActive
Status
subtletrue
colourGreen
titleOptional
boolean (true/false)Fetch All Projects for the given Client ID and given Parameter, set to "true" to get only projects of active customers/api/v2/rest/projects?clientId=1&customerIsActive=true

Status
colourGreen
titleyes

/api/v2/rest/projects/

Status
colourBlue
titleGET

 projectIsInProcess
Status
subtletrue
colourGreen
titleOptional
boolean (true/false)Fetch All Projects for the given Client ID and given Parameter, set to "true" to get only "in process" projects/api/v2/rest/projects?clientId=1&projectIsInProcess=true

Status
colourGreen
titleyes

/api/v2/rest/projects/

Status
colourBlue
titleGET

 projectStatusId
Status
subtletrue
colourGreen
titleOptional
int or arrayFetch All Projects for the given Client ID and given Project status ID/api/v2/rest/projects?clientId=1&projectStatusId=[11, 12, 16, 35, 97, 108, 116]

Status
colourGreen
titleyes

/api/v2/rest/projects/

Status
colourBlue
titleGET

 projectTypeId
Status
subtletrue
colourGreen
titleOptional
int or arrayFetch All Projects for the given Client ID and given Project Type ID/api/v2/rest/projects?clientId=1&projectTypeId=[24, 25, 26, 29, 30]

Status
colourGreen
titleyes

/api/v2/rest/projects/

Status
colourBlue
titleGET

 projectLeaderId
Status
subtletrue
colourGreen
titleOptional
intFetch All Projects for the given Client ID and given Leader ID/api/v2/rest/projects?clientId=1&projectLeaderId=1

Status
colourGreen
titleyes

/api/v2/rest/projects/

Status
colourBlue
titleGET

 search
Status
subtletrue
colourGreen
titleOptional
stringFetch All Projects for the given Client ID and givenSearch Term/api/v2/rest/projects?clientId=1&search=Project Name

Status
colourGreen
titleyes

/api/v2/rest/projects/
Status
colourGreen
titlePOST
ApiSyncItemsynctoken
Status
subtletrue
colourRed
titleREQUIRED
string  (ApiProject)Save Project/api/v2/rest/projects/[Project Object]

Status
colourGreen
titleyes

/api/v2/rest/projects/[id]
Status
colourBlue
titleGET
ApiProject, ApiSyncItemsyncItem
Status
subtletrue
colourGreen
titleOptional
boolean (true/false)set "true" to return ApiSyncItem/api/v2/rest/projects/1&syncItem=true

Status
colourGreen
titleyes

/api/v2/rest/projects/
Status
colourYellow
titlePUT
ApiSyncItem  (ApiProject)Update Project/api/v2/rest/projects/[Project Object]

Status
colourGreen
titleyes

/api/v2/rest/projects/
Status
colourRed
titleDELETE
ApiSyncItemsynctoken

Status
subtletrue
colourRed
titleREQUIRED

(ApiProject)Delete Project/api/v2/rest/projects/1

Status
colourGreen
titleyes

projectFolders

/api/v2/rest/projectFolders/
Status
colourBlue
titleGET
ApiProjectFolder[]clientId
Status
subtletrue
colourRed
titleREQUIRED
int  

Status
colourGreen
titleyes

/api/v2/rest/projectFolders/  customerId
Status
subtletrue
colourGreen
titleOptional
string   
/api/v2/rest/projectFolders/  onlyActive
Status
subtletrue
colourGreen
titleOptional
boolean (true/false)set to "true" to get only project folders  
/api/v2/rest/projectFolders/  type
Status
subtletrue
colourGreen
titleOptional
string folder type, P = project, SS = service - service, SM = service - material, SP = service - position, ALL = returns all type, if you ommit this parameter only P-types will return  
/api/v2/rest/projectFolders/
Status
colourGreen
titlePOST
ApiSyncItemsynctoken
Status
subtletrue
colourRed
titleREQUIRED
string (ApiProjectFolder)  

Status
colourGreen
titleyes

/api/v2/rest/projectFolders/[id]
Status
colourBlue
titleGET
ApiProjectFolder     

Status
colourGreen
titleyes

/api/v2/rest/projectFolders/
Status
colourYellow
titlePUT
ApiSyncItem   (ApiProjectFolder)  

Status
colourGreen
titleyes

/api/v2/rest/projectFolders/
Status
colourRed
titleDELETE
ApiSyncItem   (ApiProjectFolder)  

Status
colourGreen
titleyes

projectUnits

/api/v2/rest/projectUnits
Status
colourBlue
titleGET
ApiProjectUnit[]clientId
Status
subtletrue
colourRed
titleREQUIRED
intFetch all Project Units for the given clientId/api/v2/rest/projectUnits

Status
colourGreen
titleyes

/api/v2/rest/projectUnit/[id]
Status
colourBlue
titleGET
ApiProjectUnit   Fetch Project Unit for the given Project Unit ID/api/v2/rest/projectUnits/1

Status
colourGreen
titleyes

categories

/api/v2/rest/categories
Status
colourBlue
titleGET
ApiCrmCategory[]     

Status
colourGreen
titleyes

/api/v2/rest/categories/[id]
Status
colourBlue
titleGET
ApiCrmCategory     

Status
colourGreen
titleyes

services

/api/v2/rest/services
Status
colourBlue
titleGET
ApiService[]clientId
Status
subtletrue
colourRed
titleREQUIRED
intFetch all Services for the given Client ID/api/v2/rest/services?clientId=1

Status
colourGreen
titleyes

/api/v2/rest/services/[id]
Status
colourBlue
titleGET
ApiService   Fetch Service for the given Service ID/api/v2/rest/services/1

Status
colourGreen
titleyes

serviceFees

/api/v2/rest/serviceFees
Status
colourBlue
titleGET
ApiServiceFee[]clientId
Status
subtletrue
colourRed
titleREQUIRED
intFetch all Service Fees for the given clientId/api/v2/rest/serviceFees

Status
colourGreen
titleyes

/api/v2/rest/serviceFees/[id]
Status
colourBlue
titleGET
ApiServiceFee   Fetch Service Fee for the given Service/api/v2/rest/serviceFees/1

Status
colourGreen
titleyes

Subproject




 
Status
colourBlue
titleGET
ApiSubproject[]clientId
Status
subtletrue
colourRed
titleREQUIRED
int  

Status
colourGreen
titleyes

   projectId
Status
subtletrue
colourGreen
titleOptional
int  

Status
colourGreen
titleyes

   parentId
Status
subtletrue
colourGreen
titleOptional
int  

Status
colourGreen
titleyes

  ApiSyncItem[]syncItem
Status
subtletrue
colourGreen
titleOptional
boolean (true/false)  

Status
colourGreen
titleyes

 
Status
colourGreen
titlePOST
ApiSyncItemsynctoken
Status
subtletrue
colourRed
titleREQUIRED
string (ApiSubproject)  

Status
colourGreen
titleyes

/api/v2/rest/subprojects/[id]
Status
colourBlue
titleGET
ApiSubproject     

Status
colourGreen
titleyes

 
Status
colourYellow
titlePUT
ApiSyncItem  (ApiSubproject)  

Status
colourGreen
titleyes

 
Status
colourRed
titleDELETE
ApiSyncItem  (ApiSubproject)  

Status
colourGreen
titleyes

/api/v2/rest/tasks
  
Status
colourBlue
titleGET
ApiTask[]fromEmployeeId

Status
subtletrue
colourGreen
titleOptional

int  

Status
colourGreen
titleyes

    toEmployeeId
Status
subtletrue
colourGreen
titleOptional
int   
    type
Status
subtletrue
colourGreen
titleOptional
string (ApiTask:Task, ApiTask:ProjectTask, ApiTask:ProjectWarning)   
  
Status
colourGreen
titlePOST
ApiSyncItem     

Status
colourGreen
titleyes

/api/v2/rest/tasks/[id]
  
Status
colourBlue
titleGET
ApiTask     

Status
colourGreen
titleyes

  
Status
colourYellow
titlePUT
ApiSyncItem     

Status
colourGreen
titleyes

  
Status
colourRed
titleDELETE
boolean     

Status
colourGreen
titleyes

/api/v2/rest/texts
  
Status
colourBlue
titleGET
ApiText[]parentType
Status
subtletrue
colourRed
titleREQUIRED
type: A = assignment, C = calculation position, D = document, E = document position, F = cover footer, I = client, X = text, P = project, S = subproject, L = cover letter, T = milestone  

Status
colourGreen
titleyes

    parentId
Status
subtletrue
colourRed
titleREQUIRED
int   
  
Status
colourGreen
titlePOST
ApiSyncItem     

Status
colourGreen
titleyes

/api/v2/rest/texts/[id]
  
Status
colourBlue
titleGET
ApiText     

Status
colourGreen
titleyes

  

Status
colourYellow
titlePUT

ApiSyncItem     

Status
colourGreen
titleyes

  
Status
colourRed
titleDELETE
boolean     

Status
colourGreen
titleyes

/api/v2/rest/misc/availablePaths
 return a list of available paths
Status
colourBlue
titleGET
string array     

Status
colourGreen
titleyes

/api/v2/rest/misc/categories
  
Status
colourBlue
titleGET
ApiSyncItem[]     

Status
colourGreen
titleyes

/api/v2/rest/misc/costCenters
  
Status
colourBlue
titleGET
ApiCostCenter[]clientId
Status
subtletrue
colourRed
titleREQUIRED
int  

Status
colourGreen
titleyes

/api/v2/rest/misc/costCenters/[id]
  
Status
colourBlue
titleGET
ApiCostCenter     

Status
colourGreen
titleyes

/api/v2/rest/misc/countries
  
Status
colourBlue
titleGET
string array     

Status
colourGreen
titleyes

/api/v2/rest/misc/currentEmployee
  
Status
colourBlue
titleGET
ApiEmployee     

Status
colourGreen
titleyes

/api/v2/rest/misc/currentEmployee/accessRoles
  
Status
colourBlue
titleGET
arrayroles
Status
subtletrue
colourRed
titleREQUIRED
["contacts","projectTasks","timeRecording","timeReporting"] api/v2/rest/misc/currentEmployee/accessRoles?roles=["contacts","projectTasks","timeRecording","timeReporting"]

Status
colourGreen
titleyes

/api/v2/rest/misc/projectStatuses
  
Status
colourBlue
titleGET
ApiProjectStatus[]clientId
Status
subtletrue
colourRed
titleREQUIRED
int  

Status
colourGreen
titleyes

/api/v2/rest/misc/projectTypes
  
Status
colourBlue
titleGET
ApiProjectType[]clientId
Status
subtletrue
colourRed
titleREQUIRED
int  

Status
colourGreen
titleyes

/api/v2/rest/misc/salutations
  
Status
colourBlue
titleGET
string array     

Status
colourGreen
titleyes

/api/v2/rest/misc/settings
  
Status
colourBlue
titleGET
arrayclientId
Status
subtletrue
colourRed
titleREQUIRED
int  

Status
colourGreen
titleyes

    scope
Status
subtletrue
colourRed
titleREQUIRED
billing api/v2/rest/misc/settings?scope=billing&clientId=1 
/api/v2/rest/misc/taxRates
  
Status
colourBlue
titleGET
ApiTaxRate[]clientId
Status
subtletrue
colourRed
titleREQUIRED
int  

Status
colourGreen
titleyes

/api/v2/rest/misc/taxRates/[id]
  
Status
colourBlue
titleGET
ApiTaxRate     

Status
colourGreen
titleyes

Units

/api/v2/rest/misc/units 
Status
colourBlue
titleGET
ApiUnit[]clientId
Status
subtletrue
colourRed
titleREQUIRED
int  

Status
colourGreen
titleyes

/api/v2/rest/misc/units/[Id]
Status
colourBlue
titleGET
ApiUnit     

Status
colourGreen
titleyes

Credentials Verification

/api/v2/rest/misc/verifyCredentials 
Status
colourBlue
titleGET
boolean or ApiErrorDataauth

Status
subtletrue
colourRed
titleREQUIRED

string api/v2/rest/misc/verifyCredentials?auth=Basic bHVkd2lnOjA5NDVmYzk2MTFmNTVmZDBlMTgzZmI4YjA0NGYxYWZl

Status
colourGreen
titleyes

Approval Groups

api/v2/rest/misc/approvalGroups 

Status
colourBlue
titleGET

ApiApprovalGroup[]clientId

Status
subtletrue
colourRed
titleREQUIRED

intFetch all Approval Groups given Client.api/v2/rest/misc/approvalGroups?clientId=1

Status
colourGreen
titleyes

 /api/v2/rest/misc/approvalGroups/[Id]

Status
colourBlue
titleGET

ApiApprovalGroup    api/v2/rest/misc/approvalGroups/1

Status
colourGreen
titleyes

User Groups

api/v2/rest/misc/userGroups 

Status
colourBlue
titleGET

ApiSyncItem[]   Fetch all User Groupsapi/v2/rest/misc/userGroups

Status
colourGreen
titleyes

Currencies

api/v2/rest/misc/currencies 

Status
colourBlue
titleGET

ApiCurrency[]clientId

Status
subtletrue
colourRed
titleREQUIRED

intFetch all Currencies given Client.api/v2/rest/misc/currencies

Status
colourGreen
titleyes

 /api/v2/rest/misc/currencies/[Id]

Status
colourBlue
titleGET

ApiCurrency[]   Fetch Currency By IDapi/v2/rest/misc/currencies/1

Status
colourGreen
titleyes

Project Leaders

api/v2/rest/misc/projectLeaders/api/v2/rest/misc/projectLeaders

Status
colourBlue
titleGET

ApiEmployee[]clientId

Status
subtletrue
colourRed
titleREQUIRED

intFetch all Project Leaders for the given Client.api/v2/rest/misc/projectLeaders

Status
colourGreen
titleyes

Version

api/v2/rest/misc/version/api/v2/rest/misc/version

Status
colourBlue
titleGET

string Array[]   Fetch Current Troi Versionapi/v2/rest/misc/version

Status
colourGreen
titleyes

Settings

api/v2/rest/misc/settings/api/v2/rest/misc/settings

Status
colourBlue
titleGET

string Array[]clientId

Status
subtletrue
colourRed
titleREQUIRED

intFetch all Settings for the given Scopeapi/v2/rest/misc/settings?clientId=1&scope=accounting

Status
colourGreen
titleyes

    scope

Status
subtletrue
colourRed
titleREQUIRED

string - available parameters (accounting, billing, BOOKKEEPING_VAT_IN_PRICE_LIST)   

Sync for Offline Client

 

Status
colourBlue
titleGET

ApiOfflineClientsSync     

Status
colourGreen
titleyes

WorkingTimeLog

/api/v2/rest/checkincheckout

Status
colourBlue
titleGET

ApiWorkingTimeLog[]getCurrentCheckIn

Status
subtletrue
colourRed
titleREQUIRED

booleanFetch All WorkingTimeLog/api/v2/rest/checkincheckout?getCurrentCheckIn=true

Status
colourGreen
titleyes

/api/v2/rest/checkincheckout

Status
colourGreen
titlePOST

ApiSyncItem   Save WorkTimeLog/api/v2/rest/checkincheckout/[WorkTimeLog Object]

Status
colourGreen
titleyes

 

Hermes Settings

/api/v2/rest/hermes/settings

Status
colourBlue
titleGET

ApiHermesSettings[]   Fetch All Hermes Settings/api/v2/rest/hermes/settings

Status
colourGreen
titleyes

Hermes Projects

/api/v2/rest/hermes/projects

Status
colourBlue
titleGET

ApiHermesProjects[]search

Status
subtletrue
colourRed
titleREQUIRED

string (search=* , search=projectname)

2 search patterns are available (*) → for all projects and

a part of Project Name like (test project)

Fetch All Hermes Projects

/api/v2/rest/hermes/projects?search=*

/api/v2/rest/hermes/projects?search=projectName

Status
colourGreen
titleyes

/api/v2/rest/hermes/projects/[id]

Status
colourBlue
titleGET

ApiHermesProjects[]   Fetch Hermes Project By ID/api/v2/rest/hermes/projects/123

Status
colourGreen
titleyes

Hermes / E-Mail Management - Mails Attachment

/api/v2/rest/hermes/mails/attachments/[id]

Status
colourBlue
titleGET

ApiHermesEmaiAttachment[]   Fetch Hermes Mail Attachment By ID/api/v2/rest/hermes/mails/attachments/1

Status
colourGreen
titleyes

/api/v2/rest/hermes/mails/attachments/

Status
colourGreen
titlePOST

ApiSyncItem   Save Hermes Email Attachment/api/v2/rest/hermes/mails/attachments/[Hermes EmaiAttachment Object]

Status
colourGreen
titleyes

 

Hermes / E-Mail Management - Tags

/api/v2/rest/hermes/tags

Status
colourGreen
titlePOST

ApiHermesTagEx   Save Hermes Tag/api/v2/rest/hermes/tags/[HermesTagObject]

Status
colourGreen
titleyes

/api/v2/rest/hermes/tags/[id]

Status
colourBlue
titleGET

 

 

ApiHermesTagEx   Fetch Hermes Tag by ID/api/v2/rest/hermes/tags/[id]

Status
colourGreen
titleyes

/api/v2/rest/hermes/tags/[object]

tagParticipants as Hermes Contact Object (see Hermes / E-Mail Management - Contacts Object)

Status
colourYellow
titlePUT

ApiHermesTagEx   Update Hermes Participant For Hermes Tag/api/v2/rest/hermes/tags/[HermesTagObject]

Status
colourGreen
titleyes

Hermes / E-Mail Management - Contacts

/api/v2/rest/hermes/contacts

Status
colourBlue
titleGET

ApiHermesTagParticipant[]search

Status
subtletrue
colourRed
titlerequired

string

search for contacts that will be participants of Hermes Tag

* to get all entries

OR Contact Name

/api/v2/rest/hermes/contacts?search=ludwig

/api/v2/rest/hermes/contacts?search=*

Status
colourGreen
titleyes

/api/v2/rest/hermes/contacts[id]

Status
colourBlue
titleGET

ApiHermesTagParticipant   Fetch Hermes Contact By ID/api/v2/rest/hermes/contacts/[id]

Status
colourGreen
titleyes

Hermes / E-Mail Management - Mails

/api/v2/rest/hermes/mails

Status
colourGreen
titlePOST

ApiSyncItem

   add new mail tagged by Hermes to be stored in Troi/api/v2/rest/hermes/mails/[ApiHermesMail Object]

Status
colourGreen
titleyes

/api/v2/rest/hermes/mails

Status
colourBlue
titleGET

ApiHermesMail[]messageId

Status
subtletrue
colourRed
titlerequired

string

search for Hermes Mail that fit given criteria message id (header); MUST be url-encoded

/api/v2/rest/hermes/mails?messageId=%3csample%3aid%40mail%3e

Status
colourGreen
titleyes

 

/api/v2/rest/hermes/mails  tagId

Status
subtletrue
colourGreen
titleOptional

intID or HermesTag that was assigned with mail/api/v2/rest/hermes/mails?messageId=%3csample%3aid%40mail%3e&tagId=123

Status
colourGreen
titleyes

 

/api/v2/rest/hermes/mails/[id]

Status
colourBlue
titleGET

ApiHermesMail   Fetch Hermes Mail By ID/api/v2/rest/hermes/mails/123

Status
colourGreen
titleyes

 

Documents

 
Status
colourBlue
titleGET
ApiDocuments[]clientId
Status
subtletrue
colourRed
titleREQUIRED
int  

Status
colourGreen
titleyes

   projectId
Status
subtletrue
colourRed
titleREQUIRED
int  

Status
colourGreen
titleyes

   document_type

Status
subtletrue
colourGreen
titleOptional

I (invoice) or O (offer)  

Status
colourGreen
titleyes

   onlyIds

Status
subtletrue
colourGreen
titleOptional

1  

Status
colourGreen
titleyes

   size

Status
subtletrue
colourGreen
titleOptional

int  

Status
colourGreen
titleyes

   from

Status
subtletrue
colourGreen
titleOptional

int  

Status
colourGreen
titleyes

   since

Status
subtletrue
colourGreen
titleOptional

string (YYMMDDHHMMSS) fromat  

Status
colourGreen
titleyes

/api/v2/rest/documents/[id]

Status
colourBlue
titleGET

 

 

     

Status
colourGreen
titleyes

/api/v2/rest/documents/[id]


Documents can just be updated when document has no number

Status
colourYellow
titlePUT

ApiSyncItem

    

Status
colourGreen
titleyes