curl --request GET \
--url https://www.ruddr.io/api/workspace/allocations/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://www.ruddr.io/api/workspace/allocations/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.ruddr.io/api/workspace/allocations/{id}', 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://www.ruddr.io/api/workspace/allocations/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://www.ruddr.io/api/workspace/allocations/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://www.ruddr.io/api/workspace/allocations/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.ruddr.io/api/workspace/allocations/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "3f8a1d2e-7c4b-4e9f-a6d5-1b2c3d4e5f6a",
"resourceTypeId": "member",
"assignmentTypeId": "project",
"start": "2025-03-01",
"end": "2025-05-31",
"unit": "day",
"hoursPerDay": 6.5,
"hoursPerWeek": null,
"hoursPerMonth": null,
"hoursPerAllocation": null,
"hoursRatioOfCapacity": null,
"allocateOnTimeOffDays": false,
"totalHours": 422.5,
"isBillable": true,
"bookingTypeId": "confirmed",
"notes": "Q2 product roadmap delivery",
"readOnly": false,
"entity": "allocation",
"createdAt": "2025-01-10T14:22:35.418Z",
"modifiedAt": "2025-01-31T14:22:35.418Z",
"member": {
"id": "9b7e6d5c-4a3f-4b2e-8c1d-0e9f8a7b6c5d",
"name": "Jane Smith"
},
"placeholder": null,
"project": {
"id": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f",
"name": "Website Redesign",
"client": {
"id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
"name": "Acme Corp"
}
},
"role": {
"id": "d4e5f6a7-b8c9-4d0e-af1b-2c3d4e5f6a7b",
"name": "Senior Engineer"
},
"task": {
"id": "e5f6a7b8-c9d0-4e1f-b2a3-4c5d6e7f8a9b",
"name": "Backend Development"
},
"timeOffType": null
}{
"status": 400,
"message": "Parameter 'id' is not a valid UUID."
}{
"status": 403,
"message": "Feature 'Resource Allocations' is not enabled."
}{
"status": 404,
"message": "Object with id '3f8a1d2e-7c4b-4e9f-a6d5-1b2c3d4e5f6a' not found."
}Get an allocation
curl --request GET \
--url https://www.ruddr.io/api/workspace/allocations/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://www.ruddr.io/api/workspace/allocations/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.ruddr.io/api/workspace/allocations/{id}', 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://www.ruddr.io/api/workspace/allocations/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://www.ruddr.io/api/workspace/allocations/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://www.ruddr.io/api/workspace/allocations/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.ruddr.io/api/workspace/allocations/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "3f8a1d2e-7c4b-4e9f-a6d5-1b2c3d4e5f6a",
"resourceTypeId": "member",
"assignmentTypeId": "project",
"start": "2025-03-01",
"end": "2025-05-31",
"unit": "day",
"hoursPerDay": 6.5,
"hoursPerWeek": null,
"hoursPerMonth": null,
"hoursPerAllocation": null,
"hoursRatioOfCapacity": null,
"allocateOnTimeOffDays": false,
"totalHours": 422.5,
"isBillable": true,
"bookingTypeId": "confirmed",
"notes": "Q2 product roadmap delivery",
"readOnly": false,
"entity": "allocation",
"createdAt": "2025-01-10T14:22:35.418Z",
"modifiedAt": "2025-01-31T14:22:35.418Z",
"member": {
"id": "9b7e6d5c-4a3f-4b2e-8c1d-0e9f8a7b6c5d",
"name": "Jane Smith"
},
"placeholder": null,
"project": {
"id": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f",
"name": "Website Redesign",
"client": {
"id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
"name": "Acme Corp"
}
},
"role": {
"id": "d4e5f6a7-b8c9-4d0e-af1b-2c3d4e5f6a7b",
"name": "Senior Engineer"
},
"task": {
"id": "e5f6a7b8-c9d0-4e1f-b2a3-4c5d6e7f8a9b",
"name": "Backend Development"
},
"timeOffType": null
}{
"status": 400,
"message": "Parameter 'id' is not a valid UUID."
}{
"status": 403,
"message": "Feature 'Resource Allocations' is not enabled."
}{
"status": 404,
"message": "Object with id '3f8a1d2e-7c4b-4e9f-a6d5-1b2c3d4e5f6a' not found."
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The allocation uuid
Response
200
The unique identifier for the object.
The type of resource assigned to this allocation.
member, placeholder The type of assignment for this allocation.
project, time_off The start date of the allocation. Will be in the form YYYY-MM-DD.
The end date of the allocation. Will be in the form YYYY-MM-DD.
The time unit that determines how the allocation is measured.
day, week, month, allocation, ratio_of_capacity The number of hours allocated per day. Only present when unit is "day", otherwise null.
The number of hours allocated per week. Only present when unit is "week", otherwise null.
The number of hours allocated per month. Only present when unit is "month", otherwise null.
The total number of hours for the entire allocation duration. Only present when unit is "allocation", otherwise null.
The proportion of the member's available capacity allocated. Only present when unit is "ratio_of_capacity", otherwise null.
Whether time is allocated on days when the member has time off. Only present when assignmentTypeId is "project" and resourceTypeId is "member", otherwise null.
The total number of computed hours across all dates in the allocation.
Whether this allocation is billable.
The booking type of the allocation.
confirmed, soft Notes associated with the allocation.
Whether this allocation is read-only. Allocations sourced from time entries or holidays are read-only.
The source entity type.
allocation, time_entry, holiday The timestamp when the object was created.
The timestamp when the object was last modified. null for time-entry and holiday allocations, which are derived and have no modification timestamp.
The member assigned to this allocation. Present when resourceTypeId is "member", otherwise null.
Show child attributes
Show child attributes
The resource placeholder assigned to this allocation. Present when resourceTypeId is "placeholder", otherwise null.
Show child attributes
Show child attributes
The project this allocation is assigned to. Present when assignmentTypeId is "project", otherwise null.
Show child attributes
Show child attributes
The project role associated with this allocation, if any.
Show child attributes
Show child attributes
The project task associated with this allocation, if any.
Show child attributes
Show child attributes
The time off type associated with this allocation. Present when assignmentTypeId is "time_off", otherwise null.
Show child attributes
Show child attributes