Configuration
Get Configuration
Returns all configuration settings for your company, organized into five categories: shift options, worker interaction, worker communication, admin, and time tracking.
GET
/
config
Get Configuration
curl --request GET \
--url https://api.roostedhr.com/api/1_12/config \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.roostedhr.com/api/1_12/config"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.roostedhr.com/api/1_12/config', 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.roostedhr.com/api/1_12/config",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.roostedhr.com/api/1_12/config"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.roostedhr.com/api/1_12/config")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.roostedhr.com/api/1_12/config")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"premium": true,
"shift_options": {
"shift_requests": {},
"split_shifts": {
"endless_ern_hour_assumption": 123
},
"shift_equalizer": {},
"shift_visibility": {
"defaultDaysOut": 123
},
"worker_limits": {
"soft_worker_hour_limit": 123,
"soft_worker_hour_limit_min_period": 123,
"hard_worker_hour_limit": 123,
"soft_worker_shift_limit": 123,
"soft_worker_shift_limit_min_period": 123,
"hard_worker_shift_limit": 123
}
},
"worker_interaction": {
"bailouts": {
"bailouts_email_max": 123,
"bailouts_min": 123,
"bailouts_warning_message": "<string>"
},
"availability": {},
"time_off": {},
"reviews_and_stars": {},
"blogs": {},
"coworker_display": {},
"calendar_sync": {}
},
"worker_communication": {
"autotext": {
"blackout_before": {
"hour": 123,
"minute": 123
},
"blackout_after": {
"hour": 123,
"minute": 123
},
"hoursBeforeAutoSolicitation": 123
},
"web_checkin": {
"hours_before_event": 123,
"hours_before_summary": 123,
"additional_checkins": [
{}
]
},
"silence_mode": {},
"text_communication": {
"clock_in_forgotten_minutes_after_shift_start": 123,
"clock_in_reminder_minutes_before_shift_start": 123,
"clock_out_forgotten_minutes_after_shift_end": 123,
"clock_out_soon_reminder_minutes_before_shift_end": 123
},
"custom_messages": {
"account_status_error": "<string>"
},
"invite_to_work": {},
"event_updates": {
"text_limited_timeframe": 123
}
},
"admin": {
"daily_summary": {
"day_of_the_week": 123
},
"verbose_emails": {},
"list_view_options": {
"default_tab": 123
},
"list_view_verbose": {},
"worker_profile_control": {},
"publish_system": {},
"bailout_reason": {}
},
"time_tracking": {
"time_tracking": {
"time_punch_max_distance": 123,
"max_early_clock_in": 123,
"max_late_clock_out": 123,
"fiscal_start_of_week": 123,
"max_continuous_shift_time": 123,
"worker_signoff_checkbox_title": "<string>",
"worker_signoff_checkbox_description": "<string>",
"daily_overtime_hours": 123,
"daily_doubletime_hours": 123,
"weekly_overtime_hours": 123,
"weekly_doubletime_hours": 123,
"fiscal_every_2_weeks_start": "<string>"
},
"show_workers_hours": {},
"client_sign": {},
"reimbursements": {},
"deductions": {
"deductions": [
{}
]
},
"personnel_orders": {
"orderables": [
{}
]
}
}
}Returns all configuration settings for your company. The response is organized into five top-level categories, each containing subcategories of individual settings.
| Category | Description | Subcategories |
|---|---|---|
shift_options | Shift behavior and limits | shift_requests, split_shifts, shift_equalizer, shift_visibility, worker_limits |
worker_interaction | Worker-facing features | bailouts, availability, time_off, reviews_and_stars, blogs, coworker_display, calendar_sync |
worker_communication | Automated messaging | autotext, web_checkin, silence_mode, text_communication, custom_messages, invite_to_work, event_updates |
admin | Admin tools and display | daily_summary, verbose_emails, list_view_options, list_view_verbose, worker_profile_control, publish_system, bailout_reason |
time_tracking | Time punch and payroll | time_tracking, show_workers_hours, client_sign, reimbursements, deductions, personnel_orders |
The top-level
premium boolean indicates whether the company has premium features enabled. The personnel_orders subcategory contains the list of orderable items used by the Create Worker Order endpoint.Authorizations
Response
OK
Complete company configuration organized into five categories, plus a premium status flag. Each setting value is returned directly.
Whether the company has premium features enabled.
Settings controlling shift behavior: requests, split shifts, equalizer, visibility, and worker limits.
Show child attributes
Show child attributes
Settings for worker-facing features: bailouts, availability, time off, reviews, blogs, coworker display, and calendar sync.
Show child attributes
Show child attributes
Settings for automated messaging: autotext solicitation, web check-in, silence mode, text options, custom messages, invitations, and event updates.
Show child attributes
Show child attributes
Settings for admin tools: daily summaries, verbose emails, list view options, worker profile control, publish system, and bailout reasons.
Show child attributes
Show child attributes
Settings for time tracking: punch system, worker hours display, client sign-off, reimbursements, deductions, and personnel orders.
Show child attributes
Show child attributes
Previous
Edit ConfigurationUpdates a single configuration setting. Settings are identified by their category, subcategory, and item name.
Next
⌘I
Get Configuration
curl --request GET \
--url https://api.roostedhr.com/api/1_12/config \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.roostedhr.com/api/1_12/config"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.roostedhr.com/api/1_12/config', 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.roostedhr.com/api/1_12/config",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.roostedhr.com/api/1_12/config"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.roostedhr.com/api/1_12/config")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.roostedhr.com/api/1_12/config")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"premium": true,
"shift_options": {
"shift_requests": {},
"split_shifts": {
"endless_ern_hour_assumption": 123
},
"shift_equalizer": {},
"shift_visibility": {
"defaultDaysOut": 123
},
"worker_limits": {
"soft_worker_hour_limit": 123,
"soft_worker_hour_limit_min_period": 123,
"hard_worker_hour_limit": 123,
"soft_worker_shift_limit": 123,
"soft_worker_shift_limit_min_period": 123,
"hard_worker_shift_limit": 123
}
},
"worker_interaction": {
"bailouts": {
"bailouts_email_max": 123,
"bailouts_min": 123,
"bailouts_warning_message": "<string>"
},
"availability": {},
"time_off": {},
"reviews_and_stars": {},
"blogs": {},
"coworker_display": {},
"calendar_sync": {}
},
"worker_communication": {
"autotext": {
"blackout_before": {
"hour": 123,
"minute": 123
},
"blackout_after": {
"hour": 123,
"minute": 123
},
"hoursBeforeAutoSolicitation": 123
},
"web_checkin": {
"hours_before_event": 123,
"hours_before_summary": 123,
"additional_checkins": [
{}
]
},
"silence_mode": {},
"text_communication": {
"clock_in_forgotten_minutes_after_shift_start": 123,
"clock_in_reminder_minutes_before_shift_start": 123,
"clock_out_forgotten_minutes_after_shift_end": 123,
"clock_out_soon_reminder_minutes_before_shift_end": 123
},
"custom_messages": {
"account_status_error": "<string>"
},
"invite_to_work": {},
"event_updates": {
"text_limited_timeframe": 123
}
},
"admin": {
"daily_summary": {
"day_of_the_week": 123
},
"verbose_emails": {},
"list_view_options": {
"default_tab": 123
},
"list_view_verbose": {},
"worker_profile_control": {},
"publish_system": {},
"bailout_reason": {}
},
"time_tracking": {
"time_tracking": {
"time_punch_max_distance": 123,
"max_early_clock_in": 123,
"max_late_clock_out": 123,
"fiscal_start_of_week": 123,
"max_continuous_shift_time": 123,
"worker_signoff_checkbox_title": "<string>",
"worker_signoff_checkbox_description": "<string>",
"daily_overtime_hours": 123,
"daily_doubletime_hours": 123,
"weekly_overtime_hours": 123,
"weekly_doubletime_hours": 123,
"fiscal_every_2_weeks_start": "<string>"
},
"show_workers_hours": {},
"client_sign": {},
"reimbursements": {},
"deductions": {
"deductions": [
{}
]
},
"personnel_orders": {
"orderables": [
{}
]
}
}
}