Rocketlane is a professional-services automation platform for customer onboarding and project delivery. It keeps projects, phases, tasks, templates, time tracking, and billing in one system so services teams and their customers work from the same plan.
With the Rocketlane integration in Sim, you can:
- Manage projects: Create, get, list, update, archive, and delete projects, and add or remove project members
- Work with templates: Import a template into a project, then list, assign, and unassign its placeholders
- Manage tasks: Create, get, list, update, and delete tasks, move them between phases, and manage assignees, followers, and dependencies
- Structure delivery: Create, get, list, update, and delete project phases
- Configure custom fields: Create, get, list, update, and delete fields, and add or update their options
- Track time: Create, get, list, search, update, and delete time entries, and list time-entry categories
- Handle time-off: Create, get, list, and delete time-off records
- Organize knowledge: Create, get, list, update, and delete spaces and space documents
- Review capacity and billing: List resource allocations, and retrieve invoices with their line items and payments
In Sim, the Rocketlane integration enables your agents to run onboarding as an automated process. An agent can spin up a project from a signed deal, apply the right template, assign placeholders to real people, keep tasks and phases moving, log time, and pull invoice and allocation data for reporting.
Integrate Rocketlane into your workflow. Rocketlane is a professional-services automation platform for client onboarding and project delivery. Create and manage projects, tasks, phases, custom fields, time entries, time-offs, spaces, documents, resource allocations, and invoices.
Create a new Rocketlane project with a customer, owner, dates, team members, templates, financials, and custom fields
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
projectName | string | Yes | Name of the project |
customerCompanyName | string | Yes | Name of the customer company (case-sensitive exact match; cannot be changed after creation) |
ownerUserId | number | No | User ID of the project owner (either ownerUserId or ownerEmailId must be provided) |
ownerEmailId | string | No | Email of the project owner (either ownerUserId or ownerEmailId must be provided) |
startDate | string | No | Date on which the project begins (YYYY-MM-DD); required when sources are provided |
dueDate | string | No | Date on which the project is planned to complete (YYYY-MM-DD, on or after startDate) |
visibility | string | No | Who can see the project: EVERYONE or MEMBERS |
statusValue | number | No | Value (identifier) of the project status |
memberUserIds | array | No | User IDs of team members from your organization to add to the project |
customerUserIds | array | No | User IDs of customer stakeholders to add to the project |
customerChampionUserId | number | No | User ID of the customer champion |
fields | array | No | Custom field assignments, each with fieldId and fieldValue (string, number, or number array matching the field type) |
sources | array | No | Project templates to import at creation, each with templateId, startDate (YYYY-MM-DD), and optional prefix |
placeholders | array | No | Placeholder-to-user mappings, each with placeholderId and user ({ userId } or { emailId }); ignored unless the project is built from sources |
assignProjectOwner | boolean | No | Automatically assign unassigned tasks to the project owner (skipped when no sources are used) |
annualizedRecurringRevenue | number | No | Recurring revenue of the customer subscriptions for a single calendar year |
projectFee | number | No | Total fee charged for the project |
autoAllocation | boolean | No | Whether auto allocation is enabled for the project |
autoCreateCompany | boolean | No | Create the customer company if it does not already exist |
budgetedHours | number | No | Total hours allocated for project execution (decimal, up to two places) |
contractType | string | No | Contract type for the project financials: FIXED_FEE, TIME_AND_MATERIAL, NON_BILLABLE, or SUBSCRIPTION |
fixedFee | number | No | Project fee for FIXED_FEE contract type projects |
projectBudget | number | No | Project budget for TIME_AND_MATERIAL contract type projects |
rateCardId | number | No | Rate card ID for TIME_AND_MATERIAL contract type projects |
subscriptionFrequency | string | No | Subscription renewal interval for SUBSCRIPTION contracts: MONTHLY, QUARTERLY, HALF_YEARLY, or YEARLY |
subscriptionStartDate | string | No | Date when the subscription interval begins (YYYY-MM-DD) |
periodMinutes | number | No | Budgeted minutes for each subscription period |
periodBudget | number | No | Fixed budget of every subscription period |
noOfPeriods | number | No | Number of periods in the subscription |
currency | string | No | Currency for the project financials (ISO code, e.g. USD); cannot be changed once set |
externalReferenceId | string | No | Identifier linking the project to an external system |
includeFields | string | No | Comma-separated extra fields to return in the response (e.g. budgetedHours,progressPercentage) |
includeAllFields | boolean | No | Return all fields in the response body |
| Parameter | Type | Description |
|---|
project | object | The created project |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ startDate | string | Date on which the project execution begins (YYYY-MM-DD) |
↳ dueDate | string | Date on which the project execution is planned to complete (YYYY-MM-DD) |
↳ createdAt | number | Time when the project was created (epoch millis) |
↳ updatedAt | number | Time when the project was last updated (epoch millis) |
↳ owner | object | Project owner |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ teamMembers | object | Project members, customers, and customer champion |
↳ members | array | Team members working on the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customers | array | Customer stakeholders involved in the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customerChampion | object | Customer champion of the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ status | object | Project status value and label |
↳ value | number | Unique identifier of the status |
↳ label | string | Name of the status |
↳ fields | array | Custom project field values |
↳ fieldId | number | Unique identifier of the custom field |
↳ fieldLabel | string | Name of the custom project field |
↳ fieldValue | string | Value assigned to the field |
↳ fieldValueLabel | string | String representation of the field value |
↳ customer | object | Customer company of the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ partnerCompanies | array | Partner companies on the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ archived | boolean | Whether the project is archived |
↳ visibility | string | Project visibility (EVERYONE, MEMBERS, or GROUP) |
↳ createdBy | object | Team member who created the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ currency | string | Currency for the project financials (ISO code) |
↳ financials | object | Project financials (contract type and per-contract-type fields) |
↳ contractType | string | Contract type for the project financials (FIXED_FEE, TIME_AND_MATERIAL, SUBSCRIPTION, or NON_BILLABLE) |
↳ revenueRecognitionType | string | Method used for revenue recognition |
↳ fixedFee | number | Project fee for Fixed fee contract type projects |
↳ projectBudget | number | Budget allocated for Time & Material contract type projects |
↳ rateCardId | number | Unique identifier of the rate card |
↳ rateCardName | string | Name of the rate card |
↳ subscriptionFrequency | string | Interval at which the subscription renews (MONTHLY, QUARTERLY, HALF_YEARLY, YEARLY) |
↳ subscriptionStartDate | string | Date when the subscription interval begins (YYYY-MM-DD) |
↳ periodMinutes | number | Budgeted minutes for each subscription period |
↳ periodBudget | number | Fixed budget of every subscription period |
↳ noOfPeriods | number | Number of periods in the subscription |
↳ startDateActual | string | Date on which the project status changed to in progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date on which the project status changed to completed (YYYY-MM-DD) |
↳ annualizedRecurringRevenue | number | Recurring revenue of the customer subscriptions for a single calendar year |
↳ projectFee | number | Total fee charged for the project |
↳ budgetedHours | number | Total hours allocated for project execution |
↳ percentageBudgetedHoursConsumed | number | Budgeted hours consumed percentage |
↳ percentageBudgetConsumed | number | Budget consumed percentage |
↳ trackedHours | number | Hours tracked as part of submitted time entries |
↳ trackedMinutes | number | Minutes tracked as part of submitted time entries |
↳ allocatedHours | number | Allocated hours against users or placeholders |
↳ allocatedMinutes | number | Allocated minutes against users or placeholders |
↳ billableHours | number | Hours of time entries tracked as billable |
↳ billableMinutes | number | Minutes of time entries tracked as billable |
↳ nonBillableHours | number | Hours of time entries tracked as non-billable |
↳ nonBillableMinutes | number | Minutes of time entries tracked as non-billable |
↳ remainingHours | number | Hours left to complete the project based on tracked and budgeted hours |
↳ remainingMinutes | number | Minutes left to complete the project (complements remainingHours) |
↳ progressPercentage | number | Progress based on completed tasks vs total tasks |
↳ currentPhases | array | Phases currently marked as in progress |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ autoAllocation | boolean | Whether auto allocation is enabled for the project |
↳ sources | array | Project templates imported into the project |
↳ prefix | string | Prefix distinguishing which phase or task corresponds to which template |
↳ startDate | string | Date on which the template goes into effect (YYYY-MM-DD) |
↳ templateId | number | Unique identifier of the template |
↳ templateName | string | Name of the template |
↳ plannedDurationInDays | number | Difference between startDate and dueDate in days |
↳ inferredProgress | string | Inferred progress (ON_TRACK, AHEAD_OF_TIME, RUNNING_LATE, or NONE) |
↳ projectAgeInDays | number | Age of the project in days based on actual dates |
↳ customersInvited | number | Number of customers invited to the project |
↳ customersJoined | number | Number of customers who joined the project |
↳ externalReferenceId | string | Identifier linking the project to an external system |
Retrieve a Rocketlane project by its unique identifier
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
projectId | number | Yes | Unique identifier of the project |
includeFields | string | No | Comma-separated extra fields to return in the response (e.g. budgetedHours,progressPercentage) |
includeAllFields | boolean | No | Return all fields in the response body |
| Parameter | Type | Description |
|---|
project | object | The requested project |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ startDate | string | Date on which the project execution begins (YYYY-MM-DD) |
↳ dueDate | string | Date on which the project execution is planned to complete (YYYY-MM-DD) |
↳ createdAt | number | Time when the project was created (epoch millis) |
↳ updatedAt | number | Time when the project was last updated (epoch millis) |
↳ owner | object | Project owner |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ teamMembers | object | Project members, customers, and customer champion |
↳ members | array | Team members working on the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customers | array | Customer stakeholders involved in the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customerChampion | object | Customer champion of the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ status | object | Project status value and label |
↳ value | number | Unique identifier of the status |
↳ label | string | Name of the status |
↳ fields | array | Custom project field values |
↳ fieldId | number | Unique identifier of the custom field |
↳ fieldLabel | string | Name of the custom project field |
↳ fieldValue | string | Value assigned to the field |
↳ fieldValueLabel | string | String representation of the field value |
↳ customer | object | Customer company of the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ partnerCompanies | array | Partner companies on the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ archived | boolean | Whether the project is archived |
↳ visibility | string | Project visibility (EVERYONE, MEMBERS, or GROUP) |
↳ createdBy | object | Team member who created the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ currency | string | Currency for the project financials (ISO code) |
↳ financials | object | Project financials (contract type and per-contract-type fields) |
↳ contractType | string | Contract type for the project financials (FIXED_FEE, TIME_AND_MATERIAL, SUBSCRIPTION, or NON_BILLABLE) |
↳ revenueRecognitionType | string | Method used for revenue recognition |
↳ fixedFee | number | Project fee for Fixed fee contract type projects |
↳ projectBudget | number | Budget allocated for Time & Material contract type projects |
↳ rateCardId | number | Unique identifier of the rate card |
↳ rateCardName | string | Name of the rate card |
↳ subscriptionFrequency | string | Interval at which the subscription renews (MONTHLY, QUARTERLY, HALF_YEARLY, YEARLY) |
↳ subscriptionStartDate | string | Date when the subscription interval begins (YYYY-MM-DD) |
↳ periodMinutes | number | Budgeted minutes for each subscription period |
↳ periodBudget | number | Fixed budget of every subscription period |
↳ noOfPeriods | number | Number of periods in the subscription |
↳ startDateActual | string | Date on which the project status changed to in progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date on which the project status changed to completed (YYYY-MM-DD) |
↳ annualizedRecurringRevenue | number | Recurring revenue of the customer subscriptions for a single calendar year |
↳ projectFee | number | Total fee charged for the project |
↳ budgetedHours | number | Total hours allocated for project execution |
↳ percentageBudgetedHoursConsumed | number | Budgeted hours consumed percentage |
↳ percentageBudgetConsumed | number | Budget consumed percentage |
↳ trackedHours | number | Hours tracked as part of submitted time entries |
↳ trackedMinutes | number | Minutes tracked as part of submitted time entries |
↳ allocatedHours | number | Allocated hours against users or placeholders |
↳ allocatedMinutes | number | Allocated minutes against users or placeholders |
↳ billableHours | number | Hours of time entries tracked as billable |
↳ billableMinutes | number | Minutes of time entries tracked as billable |
↳ nonBillableHours | number | Hours of time entries tracked as non-billable |
↳ nonBillableMinutes | number | Minutes of time entries tracked as non-billable |
↳ remainingHours | number | Hours left to complete the project based on tracked and budgeted hours |
↳ remainingMinutes | number | Minutes left to complete the project (complements remainingHours) |
↳ progressPercentage | number | Progress based on completed tasks vs total tasks |
↳ currentPhases | array | Phases currently marked as in progress |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ autoAllocation | boolean | Whether auto allocation is enabled for the project |
↳ sources | array | Project templates imported into the project |
↳ prefix | string | Prefix distinguishing which phase or task corresponds to which template |
↳ startDate | string | Date on which the template goes into effect (YYYY-MM-DD) |
↳ templateId | number | Unique identifier of the template |
↳ templateName | string | Name of the template |
↳ plannedDurationInDays | number | Difference between startDate and dueDate in days |
↳ inferredProgress | string | Inferred progress (ON_TRACK, AHEAD_OF_TIME, RUNNING_LATE, or NONE) |
↳ projectAgeInDays | number | Age of the project in days based on actual dates |
↳ customersInvited | number | Number of customers invited to the project |
↳ customersJoined | number | Number of customers who joined the project |
↳ externalReferenceId | string | Identifier linking the project to an external system |
List Rocketlane projects with optional filters, sorting, and token-based pagination
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
pageSize | number | No | Maximum number of projects per page (defaults to 100) |
pageToken | string | No | Page token from a previous response (valid for 15 minutes) |
includeFields | string | No | Comma-separated extra fields to return in the response (e.g. budgetedHours,progressPercentage) |
includeAllFields | boolean | No | Return all fields in the response body |
sortBy | string | No | Field to sort by: projectName, startDate, dueDate, startDateActual, dueDateActual, annualizedRecurringRevenue, or projectFee |
sortOrder | string | No | Sort order: ASC or DESC (defaults to DESC) |
match | string | No | Combine filters with AND (all) or OR (any); defaults to all |
projectNameContains | string | No | Only return projects whose name contains this value |
projectNameEquals | string | No | Only return projects whose name exactly matches this value |
statusEquals | string | No | Only return projects with this status value |
statusOneOf | string | No | Comma-separated status values; returns projects matching any of them |
customerIdEquals | string | No | Only return projects for this customer company ID |
customerIdOneOf | string | No | Comma-separated customer company IDs; returns projects matching any of them |
teamMemberIdEquals | string | No | Only return projects that include this team member ID |
contractTypeEquals | string | No | Only return projects with this contract type: FIXED_FEE, TIME_AND_MATERIAL, SUBSCRIPTION, or NON_BILLABLE |
includeArchived | boolean | No | Whether to include archived projects in the results |
externalReferenceIdEquals | string | No | Only return projects with this external reference ID |
startDateAfter | string | No | Only return projects whose start date is after this date (YYYY-MM-DD) |
startDateBefore | string | No | Only return projects whose start date is before this date (YYYY-MM-DD) |
dueDateAfter | string | No | Only return projects whose due date is after this date (YYYY-MM-DD) |
dueDateBefore | string | No | Only return projects whose due date is before this date (YYYY-MM-DD) |
| Parameter | Type | Description |
|---|
projects | array | List of projects |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ startDate | string | Date on which the project execution begins (YYYY-MM-DD) |
↳ dueDate | string | Date on which the project execution is planned to complete (YYYY-MM-DD) |
↳ createdAt | number | Time when the project was created (epoch millis) |
↳ updatedAt | number | Time when the project was last updated (epoch millis) |
↳ owner | object | Project owner |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ teamMembers | object | Project members, customers, and customer champion |
↳ members | array | Team members working on the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customers | array | Customer stakeholders involved in the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customerChampion | object | Customer champion of the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ status | object | Project status value and label |
↳ value | number | Unique identifier of the status |
↳ label | string | Name of the status |
↳ fields | array | Custom project field values |
↳ fieldId | number | Unique identifier of the custom field |
↳ fieldLabel | string | Name of the custom project field |
↳ fieldValue | string | Value assigned to the field |
↳ fieldValueLabel | string | String representation of the field value |
↳ customer | object | Customer company of the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ partnerCompanies | array | Partner companies on the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ archived | boolean | Whether the project is archived |
↳ visibility | string | Project visibility (EVERYONE, MEMBERS, or GROUP) |
↳ createdBy | object | Team member who created the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ currency | string | Currency for the project financials (ISO code) |
↳ financials | object | Project financials (contract type and per-contract-type fields) |
↳ contractType | string | Contract type for the project financials (FIXED_FEE, TIME_AND_MATERIAL, SUBSCRIPTION, or NON_BILLABLE) |
↳ revenueRecognitionType | string | Method used for revenue recognition |
↳ fixedFee | number | Project fee for Fixed fee contract type projects |
↳ projectBudget | number | Budget allocated for Time & Material contract type projects |
↳ rateCardId | number | Unique identifier of the rate card |
↳ rateCardName | string | Name of the rate card |
↳ subscriptionFrequency | string | Interval at which the subscription renews (MONTHLY, QUARTERLY, HALF_YEARLY, YEARLY) |
↳ subscriptionStartDate | string | Date when the subscription interval begins (YYYY-MM-DD) |
↳ periodMinutes | number | Budgeted minutes for each subscription period |
↳ periodBudget | number | Fixed budget of every subscription period |
↳ noOfPeriods | number | Number of periods in the subscription |
↳ startDateActual | string | Date on which the project status changed to in progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date on which the project status changed to completed (YYYY-MM-DD) |
↳ annualizedRecurringRevenue | number | Recurring revenue of the customer subscriptions for a single calendar year |
↳ projectFee | number | Total fee charged for the project |
↳ budgetedHours | number | Total hours allocated for project execution |
↳ percentageBudgetedHoursConsumed | number | Budgeted hours consumed percentage |
↳ percentageBudgetConsumed | number | Budget consumed percentage |
↳ trackedHours | number | Hours tracked as part of submitted time entries |
↳ trackedMinutes | number | Minutes tracked as part of submitted time entries |
↳ allocatedHours | number | Allocated hours against users or placeholders |
↳ allocatedMinutes | number | Allocated minutes against users or placeholders |
↳ billableHours | number | Hours of time entries tracked as billable |
↳ billableMinutes | number | Minutes of time entries tracked as billable |
↳ nonBillableHours | number | Hours of time entries tracked as non-billable |
↳ nonBillableMinutes | number | Minutes of time entries tracked as non-billable |
↳ remainingHours | number | Hours left to complete the project based on tracked and budgeted hours |
↳ remainingMinutes | number | Minutes left to complete the project (complements remainingHours) |
↳ progressPercentage | number | Progress based on completed tasks vs total tasks |
↳ currentPhases | array | Phases currently marked as in progress |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ autoAllocation | boolean | Whether auto allocation is enabled for the project |
↳ sources | array | Project templates imported into the project |
↳ prefix | string | Prefix distinguishing which phase or task corresponds to which template |
↳ startDate | string | Date on which the template goes into effect (YYYY-MM-DD) |
↳ templateId | number | Unique identifier of the template |
↳ templateName | string | Name of the template |
↳ plannedDurationInDays | number | Difference between startDate and dueDate in days |
↳ inferredProgress | string | Inferred progress (ON_TRACK, AHEAD_OF_TIME, RUNNING_LATE, or NONE) |
↳ projectAgeInDays | number | Age of the project in days based on actual dates |
↳ customersInvited | number | Number of customers invited to the project |
↳ customersJoined | number | Number of customers who joined the project |
↳ externalReferenceId | string | Identifier linking the project to an external system |
pagination | object | Pagination details for fetching further pages |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |
Update a Rocketlane project by ID, including name, dates, visibility, owner, status, and custom fields
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
projectId | number | Yes | Unique identifier of the project to update |
projectName | string | No | New name of the project |
startDate | string | No | Date on which the project begins (YYYY-MM-DD) |
dueDate | string | No | Date on which the project is planned to complete (YYYY-MM-DD, on or after startDate) |
visibility | string | No | Who can see the project: EVERYONE or MEMBERS |
ownerUserId | number | No | User ID of the new project owner (transfers ownership and revokes access for the previous owner) |
ownerEmailId | string | No | Email of the new project owner |
statusValue | number | No | Value (identifier) of the project status |
fields | array | No | Custom field assignments, each with fieldId and fieldValue (string, number, or number array matching the field type) |
annualizedRecurringRevenue | number | No | Recurring revenue of the customer subscriptions for a single calendar year |
projectFee | number | No | Total fee charged for the project |
autoAllocation | boolean | No | Whether auto allocation is enabled for the project |
budgetedHours | number | No | Total hours allocated for project execution (decimal, up to two places) |
externalReferenceId | string | No | Identifier linking the project to an external system |
includeFields | string | No | Comma-separated extra fields to return in the response (e.g. budgetedHours,progressPercentage) |
includeAllFields | boolean | No | Return all fields in the response body |
| Parameter | Type | Description |
|---|
project | object | The updated project |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ startDate | string | Date on which the project execution begins (YYYY-MM-DD) |
↳ dueDate | string | Date on which the project execution is planned to complete (YYYY-MM-DD) |
↳ createdAt | number | Time when the project was created (epoch millis) |
↳ updatedAt | number | Time when the project was last updated (epoch millis) |
↳ owner | object | Project owner |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ teamMembers | object | Project members, customers, and customer champion |
↳ members | array | Team members working on the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customers | array | Customer stakeholders involved in the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customerChampion | object | Customer champion of the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ status | object | Project status value and label |
↳ value | number | Unique identifier of the status |
↳ label | string | Name of the status |
↳ fields | array | Custom project field values |
↳ fieldId | number | Unique identifier of the custom field |
↳ fieldLabel | string | Name of the custom project field |
↳ fieldValue | string | Value assigned to the field |
↳ fieldValueLabel | string | String representation of the field value |
↳ customer | object | Customer company of the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ partnerCompanies | array | Partner companies on the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ archived | boolean | Whether the project is archived |
↳ visibility | string | Project visibility (EVERYONE, MEMBERS, or GROUP) |
↳ createdBy | object | Team member who created the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ currency | string | Currency for the project financials (ISO code) |
↳ financials | object | Project financials (contract type and per-contract-type fields) |
↳ contractType | string | Contract type for the project financials (FIXED_FEE, TIME_AND_MATERIAL, SUBSCRIPTION, or NON_BILLABLE) |
↳ revenueRecognitionType | string | Method used for revenue recognition |
↳ fixedFee | number | Project fee for Fixed fee contract type projects |
↳ projectBudget | number | Budget allocated for Time & Material contract type projects |
↳ rateCardId | number | Unique identifier of the rate card |
↳ rateCardName | string | Name of the rate card |
↳ subscriptionFrequency | string | Interval at which the subscription renews (MONTHLY, QUARTERLY, HALF_YEARLY, YEARLY) |
↳ subscriptionStartDate | string | Date when the subscription interval begins (YYYY-MM-DD) |
↳ periodMinutes | number | Budgeted minutes for each subscription period |
↳ periodBudget | number | Fixed budget of every subscription period |
↳ noOfPeriods | number | Number of periods in the subscription |
↳ startDateActual | string | Date on which the project status changed to in progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date on which the project status changed to completed (YYYY-MM-DD) |
↳ annualizedRecurringRevenue | number | Recurring revenue of the customer subscriptions for a single calendar year |
↳ projectFee | number | Total fee charged for the project |
↳ budgetedHours | number | Total hours allocated for project execution |
↳ percentageBudgetedHoursConsumed | number | Budgeted hours consumed percentage |
↳ percentageBudgetConsumed | number | Budget consumed percentage |
↳ trackedHours | number | Hours tracked as part of submitted time entries |
↳ trackedMinutes | number | Minutes tracked as part of submitted time entries |
↳ allocatedHours | number | Allocated hours against users or placeholders |
↳ allocatedMinutes | number | Allocated minutes against users or placeholders |
↳ billableHours | number | Hours of time entries tracked as billable |
↳ billableMinutes | number | Minutes of time entries tracked as billable |
↳ nonBillableHours | number | Hours of time entries tracked as non-billable |
↳ nonBillableMinutes | number | Minutes of time entries tracked as non-billable |
↳ remainingHours | number | Hours left to complete the project based on tracked and budgeted hours |
↳ remainingMinutes | number | Minutes left to complete the project (complements remainingHours) |
↳ progressPercentage | number | Progress based on completed tasks vs total tasks |
↳ currentPhases | array | Phases currently marked as in progress |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ autoAllocation | boolean | Whether auto allocation is enabled for the project |
↳ sources | array | Project templates imported into the project |
↳ prefix | string | Prefix distinguishing which phase or task corresponds to which template |
↳ startDate | string | Date on which the template goes into effect (YYYY-MM-DD) |
↳ templateId | number | Unique identifier of the template |
↳ templateName | string | Name of the template |
↳ plannedDurationInDays | number | Difference between startDate and dueDate in days |
↳ inferredProgress | string | Inferred progress (ON_TRACK, AHEAD_OF_TIME, RUNNING_LATE, or NONE) |
↳ projectAgeInDays | number | Age of the project in days based on actual dates |
↳ customersInvited | number | Number of customers invited to the project |
↳ customersJoined | number | Number of customers who joined the project |
↳ externalReferenceId | string | Identifier linking the project to an external system |
Archive a Rocketlane project by ID, making it dormant while preserving its details and history
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
projectId | number | Yes | Unique identifier of the project to archive |
| Parameter | Type | Description |
|---|
archived | boolean | Whether the project was archived |
projectId | number | Unique identifier of the archived project |
Permanently delete a Rocketlane project by ID (irreversible; only Admins, Super Users, and Project Owners can delete)
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
projectId | number | Yes | Unique identifier of the project to delete |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the project was deleted |
projectId | number | Unique identifier of the deleted project |
Add team members and customer stakeholders to a Rocketlane project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
projectId | number | Yes | Unique identifier of the project |
memberUserIds | array | No | User IDs of team members from your organization to add |
memberEmailIds | array | No | Emails of team members from your organization to add |
customerUserIds | array | No | User IDs of customer stakeholders to add |
customerEmailIds | array | No | Emails of customer stakeholders to add |
| Parameter | Type | Description |
|---|
project | object | The project with its updated team members |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ startDate | string | Date on which the project execution begins (YYYY-MM-DD) |
↳ dueDate | string | Date on which the project execution is planned to complete (YYYY-MM-DD) |
↳ createdAt | number | Time when the project was created (epoch millis) |
↳ updatedAt | number | Time when the project was last updated (epoch millis) |
↳ owner | object | Project owner |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ teamMembers | object | Project members, customers, and customer champion |
↳ members | array | Team members working on the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customers | array | Customer stakeholders involved in the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customerChampion | object | Customer champion of the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ status | object | Project status value and label |
↳ value | number | Unique identifier of the status |
↳ label | string | Name of the status |
↳ fields | array | Custom project field values |
↳ fieldId | number | Unique identifier of the custom field |
↳ fieldLabel | string | Name of the custom project field |
↳ fieldValue | string | Value assigned to the field |
↳ fieldValueLabel | string | String representation of the field value |
↳ customer | object | Customer company of the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ partnerCompanies | array | Partner companies on the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ archived | boolean | Whether the project is archived |
↳ visibility | string | Project visibility (EVERYONE, MEMBERS, or GROUP) |
↳ createdBy | object | Team member who created the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ currency | string | Currency for the project financials (ISO code) |
↳ financials | object | Project financials (contract type and per-contract-type fields) |
↳ contractType | string | Contract type for the project financials (FIXED_FEE, TIME_AND_MATERIAL, SUBSCRIPTION, or NON_BILLABLE) |
↳ revenueRecognitionType | string | Method used for revenue recognition |
↳ fixedFee | number | Project fee for Fixed fee contract type projects |
↳ projectBudget | number | Budget allocated for Time & Material contract type projects |
↳ rateCardId | number | Unique identifier of the rate card |
↳ rateCardName | string | Name of the rate card |
↳ subscriptionFrequency | string | Interval at which the subscription renews (MONTHLY, QUARTERLY, HALF_YEARLY, YEARLY) |
↳ subscriptionStartDate | string | Date when the subscription interval begins (YYYY-MM-DD) |
↳ periodMinutes | number | Budgeted minutes for each subscription period |
↳ periodBudget | number | Fixed budget of every subscription period |
↳ noOfPeriods | number | Number of periods in the subscription |
↳ startDateActual | string | Date on which the project status changed to in progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date on which the project status changed to completed (YYYY-MM-DD) |
↳ annualizedRecurringRevenue | number | Recurring revenue of the customer subscriptions for a single calendar year |
↳ projectFee | number | Total fee charged for the project |
↳ budgetedHours | number | Total hours allocated for project execution |
↳ percentageBudgetedHoursConsumed | number | Budgeted hours consumed percentage |
↳ percentageBudgetConsumed | number | Budget consumed percentage |
↳ trackedHours | number | Hours tracked as part of submitted time entries |
↳ trackedMinutes | number | Minutes tracked as part of submitted time entries |
↳ allocatedHours | number | Allocated hours against users or placeholders |
↳ allocatedMinutes | number | Allocated minutes against users or placeholders |
↳ billableHours | number | Hours of time entries tracked as billable |
↳ billableMinutes | number | Minutes of time entries tracked as billable |
↳ nonBillableHours | number | Hours of time entries tracked as non-billable |
↳ nonBillableMinutes | number | Minutes of time entries tracked as non-billable |
↳ remainingHours | number | Hours left to complete the project based on tracked and budgeted hours |
↳ remainingMinutes | number | Minutes left to complete the project (complements remainingHours) |
↳ progressPercentage | number | Progress based on completed tasks vs total tasks |
↳ currentPhases | array | Phases currently marked as in progress |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ autoAllocation | boolean | Whether auto allocation is enabled for the project |
↳ sources | array | Project templates imported into the project |
↳ prefix | string | Prefix distinguishing which phase or task corresponds to which template |
↳ startDate | string | Date on which the template goes into effect (YYYY-MM-DD) |
↳ templateId | number | Unique identifier of the template |
↳ templateName | string | Name of the template |
↳ plannedDurationInDays | number | Difference between startDate and dueDate in days |
↳ inferredProgress | string | Inferred progress (ON_TRACK, AHEAD_OF_TIME, RUNNING_LATE, or NONE) |
↳ projectAgeInDays | number | Age of the project in days based on actual dates |
↳ customersInvited | number | Number of customers invited to the project |
↳ customersJoined | number | Number of customers who joined the project |
↳ externalReferenceId | string | Identifier linking the project to an external system |
Remove team members from a Rocketlane project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
projectId | number | Yes | Unique identifier of the project |
memberUserIds | array | No | User IDs of team members to remove (at least one of memberUserIds or memberEmailIds is required) |
memberEmailIds | array | No | Emails of team members to remove (at least one of memberUserIds or memberEmailIds is required) |
| Parameter | Type | Description |
|---|
project | object | The project with its updated team members |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ startDate | string | Date on which the project execution begins (YYYY-MM-DD) |
↳ dueDate | string | Date on which the project execution is planned to complete (YYYY-MM-DD) |
↳ createdAt | number | Time when the project was created (epoch millis) |
↳ updatedAt | number | Time when the project was last updated (epoch millis) |
↳ owner | object | Project owner |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ teamMembers | object | Project members, customers, and customer champion |
↳ members | array | Team members working on the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customers | array | Customer stakeholders involved in the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customerChampion | object | Customer champion of the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ status | object | Project status value and label |
↳ value | number | Unique identifier of the status |
↳ label | string | Name of the status |
↳ fields | array | Custom project field values |
↳ fieldId | number | Unique identifier of the custom field |
↳ fieldLabel | string | Name of the custom project field |
↳ fieldValue | string | Value assigned to the field |
↳ fieldValueLabel | string | String representation of the field value |
↳ customer | object | Customer company of the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ partnerCompanies | array | Partner companies on the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ archived | boolean | Whether the project is archived |
↳ visibility | string | Project visibility (EVERYONE, MEMBERS, or GROUP) |
↳ createdBy | object | Team member who created the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ currency | string | Currency for the project financials (ISO code) |
↳ financials | object | Project financials (contract type and per-contract-type fields) |
↳ contractType | string | Contract type for the project financials (FIXED_FEE, TIME_AND_MATERIAL, SUBSCRIPTION, or NON_BILLABLE) |
↳ revenueRecognitionType | string | Method used for revenue recognition |
↳ fixedFee | number | Project fee for Fixed fee contract type projects |
↳ projectBudget | number | Budget allocated for Time & Material contract type projects |
↳ rateCardId | number | Unique identifier of the rate card |
↳ rateCardName | string | Name of the rate card |
↳ subscriptionFrequency | string | Interval at which the subscription renews (MONTHLY, QUARTERLY, HALF_YEARLY, YEARLY) |
↳ subscriptionStartDate | string | Date when the subscription interval begins (YYYY-MM-DD) |
↳ periodMinutes | number | Budgeted minutes for each subscription period |
↳ periodBudget | number | Fixed budget of every subscription period |
↳ noOfPeriods | number | Number of periods in the subscription |
↳ startDateActual | string | Date on which the project status changed to in progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date on which the project status changed to completed (YYYY-MM-DD) |
↳ annualizedRecurringRevenue | number | Recurring revenue of the customer subscriptions for a single calendar year |
↳ projectFee | number | Total fee charged for the project |
↳ budgetedHours | number | Total hours allocated for project execution |
↳ percentageBudgetedHoursConsumed | number | Budgeted hours consumed percentage |
↳ percentageBudgetConsumed | number | Budget consumed percentage |
↳ trackedHours | number | Hours tracked as part of submitted time entries |
↳ trackedMinutes | number | Minutes tracked as part of submitted time entries |
↳ allocatedHours | number | Allocated hours against users or placeholders |
↳ allocatedMinutes | number | Allocated minutes against users or placeholders |
↳ billableHours | number | Hours of time entries tracked as billable |
↳ billableMinutes | number | Minutes of time entries tracked as billable |
↳ nonBillableHours | number | Hours of time entries tracked as non-billable |
↳ nonBillableMinutes | number | Minutes of time entries tracked as non-billable |
↳ remainingHours | number | Hours left to complete the project based on tracked and budgeted hours |
↳ remainingMinutes | number | Minutes left to complete the project (complements remainingHours) |
↳ progressPercentage | number | Progress based on completed tasks vs total tasks |
↳ currentPhases | array | Phases currently marked as in progress |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ autoAllocation | boolean | Whether auto allocation is enabled for the project |
↳ sources | array | Project templates imported into the project |
↳ prefix | string | Prefix distinguishing which phase or task corresponds to which template |
↳ startDate | string | Date on which the template goes into effect (YYYY-MM-DD) |
↳ templateId | number | Unique identifier of the template |
↳ templateName | string | Name of the template |
↳ plannedDurationInDays | number | Difference between startDate and dueDate in days |
↳ inferredProgress | string | Inferred progress (ON_TRACK, AHEAD_OF_TIME, RUNNING_LATE, or NONE) |
↳ projectAgeInDays | number | Age of the project in days based on actual dates |
↳ customersInvited | number | Number of customers invited to the project |
↳ customersJoined | number | Number of customers who joined the project |
↳ externalReferenceId | string | Identifier linking the project to an external system |
Import a project template into an existing Rocketlane project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
projectId | number | Yes | Unique identifier of the project to import the template into |
templateId | number | Yes | Unique identifier of the template to import |
startDate | string | Yes | Date on which the template goes into effect for the project (YYYY-MM-DD) |
prefix | string | No | Prefix distinguishing which phase or task corresponds to this template when importing multiple templates |
| Parameter | Type | Description |
|---|
project | object | The project after the template import (including its sources) |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ startDate | string | Date on which the project execution begins (YYYY-MM-DD) |
↳ dueDate | string | Date on which the project execution is planned to complete (YYYY-MM-DD) |
↳ createdAt | number | Time when the project was created (epoch millis) |
↳ updatedAt | number | Time when the project was last updated (epoch millis) |
↳ owner | object | Project owner |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ teamMembers | object | Project members, customers, and customer champion |
↳ members | array | Team members working on the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customers | array | Customer stakeholders involved in the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customerChampion | object | Customer champion of the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ status | object | Project status value and label |
↳ value | number | Unique identifier of the status |
↳ label | string | Name of the status |
↳ fields | array | Custom project field values |
↳ fieldId | number | Unique identifier of the custom field |
↳ fieldLabel | string | Name of the custom project field |
↳ fieldValue | string | Value assigned to the field |
↳ fieldValueLabel | string | String representation of the field value |
↳ customer | object | Customer company of the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ partnerCompanies | array | Partner companies on the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ archived | boolean | Whether the project is archived |
↳ visibility | string | Project visibility (EVERYONE, MEMBERS, or GROUP) |
↳ createdBy | object | Team member who created the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ currency | string | Currency for the project financials (ISO code) |
↳ financials | object | Project financials (contract type and per-contract-type fields) |
↳ contractType | string | Contract type for the project financials (FIXED_FEE, TIME_AND_MATERIAL, SUBSCRIPTION, or NON_BILLABLE) |
↳ revenueRecognitionType | string | Method used for revenue recognition |
↳ fixedFee | number | Project fee for Fixed fee contract type projects |
↳ projectBudget | number | Budget allocated for Time & Material contract type projects |
↳ rateCardId | number | Unique identifier of the rate card |
↳ rateCardName | string | Name of the rate card |
↳ subscriptionFrequency | string | Interval at which the subscription renews (MONTHLY, QUARTERLY, HALF_YEARLY, YEARLY) |
↳ subscriptionStartDate | string | Date when the subscription interval begins (YYYY-MM-DD) |
↳ periodMinutes | number | Budgeted minutes for each subscription period |
↳ periodBudget | number | Fixed budget of every subscription period |
↳ noOfPeriods | number | Number of periods in the subscription |
↳ startDateActual | string | Date on which the project status changed to in progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date on which the project status changed to completed (YYYY-MM-DD) |
↳ annualizedRecurringRevenue | number | Recurring revenue of the customer subscriptions for a single calendar year |
↳ projectFee | number | Total fee charged for the project |
↳ budgetedHours | number | Total hours allocated for project execution |
↳ percentageBudgetedHoursConsumed | number | Budgeted hours consumed percentage |
↳ percentageBudgetConsumed | number | Budget consumed percentage |
↳ trackedHours | number | Hours tracked as part of submitted time entries |
↳ trackedMinutes | number | Minutes tracked as part of submitted time entries |
↳ allocatedHours | number | Allocated hours against users or placeholders |
↳ allocatedMinutes | number | Allocated minutes against users or placeholders |
↳ billableHours | number | Hours of time entries tracked as billable |
↳ billableMinutes | number | Minutes of time entries tracked as billable |
↳ nonBillableHours | number | Hours of time entries tracked as non-billable |
↳ nonBillableMinutes | number | Minutes of time entries tracked as non-billable |
↳ remainingHours | number | Hours left to complete the project based on tracked and budgeted hours |
↳ remainingMinutes | number | Minutes left to complete the project (complements remainingHours) |
↳ progressPercentage | number | Progress based on completed tasks vs total tasks |
↳ currentPhases | array | Phases currently marked as in progress |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ autoAllocation | boolean | Whether auto allocation is enabled for the project |
↳ sources | array | Project templates imported into the project |
↳ prefix | string | Prefix distinguishing which phase or task corresponds to which template |
↳ startDate | string | Date on which the template goes into effect (YYYY-MM-DD) |
↳ templateId | number | Unique identifier of the template |
↳ templateName | string | Name of the template |
↳ plannedDurationInDays | number | Difference between startDate and dueDate in days |
↳ inferredProgress | string | Inferred progress (ON_TRACK, AHEAD_OF_TIME, RUNNING_LATE, or NONE) |
↳ projectAgeInDays | number | Age of the project in days based on actual dates |
↳ customersInvited | number | Number of customers invited to the project |
↳ customersJoined | number | Number of customers who joined the project |
↳ externalReferenceId | string | Identifier linking the project to an external system |
List the placeholders of a Rocketlane project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
projectId | number | Yes | Unique identifier of the project |
| Parameter | Type | Description |
|---|
placeholders | array | Placeholders of the project |
↳ placeholderId | number | Unique identifier of the placeholder |
↳ placeholderName | string | Name of the placeholder |
↳ project | object | Project of the placeholder |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ role | object | Role of the placeholder |
↳ roleId | number | Unique identifier of the role |
↳ roleName | string | Name of the role |
↳ placeholderType | string | Type of the placeholder (NATIVE or EXTERNAL) |
↳ createdAt | number | Time when the placeholder was created (epoch millis) |
↳ updatedAt | number | Time when the placeholder was last updated (epoch millis) |
pagination | object | Pagination details for fetching further pages |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |
Assign a placeholder in a Rocketlane project to a user
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
projectId | number | Yes | Unique identifier of the project |
placeholderId | number | Yes | Unique identifier of the placeholder to assign |
userId | number | No | User ID of the project member to assign (either userId or userEmailId must be provided; must be a customer user for CUSTOMER placeholders) |
userEmailId | string | No | Email of the project member to assign (either userId or userEmailId must be provided) |
| Parameter | Type | Description |
|---|
project | object | The project after the placeholder assignment |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ startDate | string | Date on which the project execution begins (YYYY-MM-DD) |
↳ dueDate | string | Date on which the project execution is planned to complete (YYYY-MM-DD) |
↳ createdAt | number | Time when the project was created (epoch millis) |
↳ updatedAt | number | Time when the project was last updated (epoch millis) |
↳ owner | object | Project owner |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ teamMembers | object | Project members, customers, and customer champion |
↳ members | array | Team members working on the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customers | array | Customer stakeholders involved in the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customerChampion | object | Customer champion of the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ status | object | Project status value and label |
↳ value | number | Unique identifier of the status |
↳ label | string | Name of the status |
↳ fields | array | Custom project field values |
↳ fieldId | number | Unique identifier of the custom field |
↳ fieldLabel | string | Name of the custom project field |
↳ fieldValue | string | Value assigned to the field |
↳ fieldValueLabel | string | String representation of the field value |
↳ customer | object | Customer company of the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ partnerCompanies | array | Partner companies on the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ archived | boolean | Whether the project is archived |
↳ visibility | string | Project visibility (EVERYONE, MEMBERS, or GROUP) |
↳ createdBy | object | Team member who created the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ currency | string | Currency for the project financials (ISO code) |
↳ financials | object | Project financials (contract type and per-contract-type fields) |
↳ contractType | string | Contract type for the project financials (FIXED_FEE, TIME_AND_MATERIAL, SUBSCRIPTION, or NON_BILLABLE) |
↳ revenueRecognitionType | string | Method used for revenue recognition |
↳ fixedFee | number | Project fee for Fixed fee contract type projects |
↳ projectBudget | number | Budget allocated for Time & Material contract type projects |
↳ rateCardId | number | Unique identifier of the rate card |
↳ rateCardName | string | Name of the rate card |
↳ subscriptionFrequency | string | Interval at which the subscription renews (MONTHLY, QUARTERLY, HALF_YEARLY, YEARLY) |
↳ subscriptionStartDate | string | Date when the subscription interval begins (YYYY-MM-DD) |
↳ periodMinutes | number | Budgeted minutes for each subscription period |
↳ periodBudget | number | Fixed budget of every subscription period |
↳ noOfPeriods | number | Number of periods in the subscription |
↳ startDateActual | string | Date on which the project status changed to in progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date on which the project status changed to completed (YYYY-MM-DD) |
↳ annualizedRecurringRevenue | number | Recurring revenue of the customer subscriptions for a single calendar year |
↳ projectFee | number | Total fee charged for the project |
↳ budgetedHours | number | Total hours allocated for project execution |
↳ percentageBudgetedHoursConsumed | number | Budgeted hours consumed percentage |
↳ percentageBudgetConsumed | number | Budget consumed percentage |
↳ trackedHours | number | Hours tracked as part of submitted time entries |
↳ trackedMinutes | number | Minutes tracked as part of submitted time entries |
↳ allocatedHours | number | Allocated hours against users or placeholders |
↳ allocatedMinutes | number | Allocated minutes against users or placeholders |
↳ billableHours | number | Hours of time entries tracked as billable |
↳ billableMinutes | number | Minutes of time entries tracked as billable |
↳ nonBillableHours | number | Hours of time entries tracked as non-billable |
↳ nonBillableMinutes | number | Minutes of time entries tracked as non-billable |
↳ remainingHours | number | Hours left to complete the project based on tracked and budgeted hours |
↳ remainingMinutes | number | Minutes left to complete the project (complements remainingHours) |
↳ progressPercentage | number | Progress based on completed tasks vs total tasks |
↳ currentPhases | array | Phases currently marked as in progress |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ autoAllocation | boolean | Whether auto allocation is enabled for the project |
↳ sources | array | Project templates imported into the project |
↳ prefix | string | Prefix distinguishing which phase or task corresponds to which template |
↳ startDate | string | Date on which the template goes into effect (YYYY-MM-DD) |
↳ templateId | number | Unique identifier of the template |
↳ templateName | string | Name of the template |
↳ plannedDurationInDays | number | Difference between startDate and dueDate in days |
↳ inferredProgress | string | Inferred progress (ON_TRACK, AHEAD_OF_TIME, RUNNING_LATE, or NONE) |
↳ projectAgeInDays | number | Age of the project in days based on actual dates |
↳ customersInvited | number | Number of customers invited to the project |
↳ customersJoined | number | Number of customers who joined the project |
↳ externalReferenceId | string | Identifier linking the project to an external system |
placeholders | array | Placeholder-to-user mappings on the project |
↳ placeholder | object | Placeholder being mapped |
↳ placeholderId | number | Unique identifier of the placeholder |
↳ placeholderName | string | Name of the placeholder |
↳ placeholderStatus | string | Status of the placeholder (ASSIGNED or UNASSIGNED) |
↳ user | object | User assigned to the placeholder |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ role | string | Role name of the assigned user |
↳ hourlyCostRate | number | Latest hourly cost rate for the placeholder |
↳ costRateCurrency | string | Currency for the cost rate |
↳ hourlyBillRate | number | Latest hourly bill rate for the placeholder |
↳ billRateCurrency | string | Currency for the bill rate |
Unassign a placeholder from its user in a Rocketlane project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
projectId | number | Yes | Unique identifier of the project |
placeholderId | number | Yes | Unique identifier of the placeholder to unassign |
| Parameter | Type | Description |
|---|
project | object | The project after the placeholder was unassigned |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ startDate | string | Date on which the project execution begins (YYYY-MM-DD) |
↳ dueDate | string | Date on which the project execution is planned to complete (YYYY-MM-DD) |
↳ createdAt | number | Time when the project was created (epoch millis) |
↳ updatedAt | number | Time when the project was last updated (epoch millis) |
↳ owner | object | Project owner |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ teamMembers | object | Project members, customers, and customer champion |
↳ members | array | Team members working on the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customers | array | Customer stakeholders involved in the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ customerChampion | object | Customer champion of the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ status | object | Project status value and label |
↳ value | number | Unique identifier of the status |
↳ label | string | Name of the status |
↳ fields | array | Custom project field values |
↳ fieldId | number | Unique identifier of the custom field |
↳ fieldLabel | string | Name of the custom project field |
↳ fieldValue | string | Value assigned to the field |
↳ fieldValueLabel | string | String representation of the field value |
↳ customer | object | Customer company of the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ partnerCompanies | array | Partner companies on the project |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ companyUrl | string | Website URL of the company |
↳ archived | boolean | Whether the project is archived |
↳ visibility | string | Project visibility (EVERYONE, MEMBERS, or GROUP) |
↳ createdBy | object | Team member who created the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the project |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ currency | string | Currency for the project financials (ISO code) |
↳ financials | object | Project financials (contract type and per-contract-type fields) |
↳ contractType | string | Contract type for the project financials (FIXED_FEE, TIME_AND_MATERIAL, SUBSCRIPTION, or NON_BILLABLE) |
↳ revenueRecognitionType | string | Method used for revenue recognition |
↳ fixedFee | number | Project fee for Fixed fee contract type projects |
↳ projectBudget | number | Budget allocated for Time & Material contract type projects |
↳ rateCardId | number | Unique identifier of the rate card |
↳ rateCardName | string | Name of the rate card |
↳ subscriptionFrequency | string | Interval at which the subscription renews (MONTHLY, QUARTERLY, HALF_YEARLY, YEARLY) |
↳ subscriptionStartDate | string | Date when the subscription interval begins (YYYY-MM-DD) |
↳ periodMinutes | number | Budgeted minutes for each subscription period |
↳ periodBudget | number | Fixed budget of every subscription period |
↳ noOfPeriods | number | Number of periods in the subscription |
↳ startDateActual | string | Date on which the project status changed to in progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date on which the project status changed to completed (YYYY-MM-DD) |
↳ annualizedRecurringRevenue | number | Recurring revenue of the customer subscriptions for a single calendar year |
↳ projectFee | number | Total fee charged for the project |
↳ budgetedHours | number | Total hours allocated for project execution |
↳ percentageBudgetedHoursConsumed | number | Budgeted hours consumed percentage |
↳ percentageBudgetConsumed | number | Budget consumed percentage |
↳ trackedHours | number | Hours tracked as part of submitted time entries |
↳ trackedMinutes | number | Minutes tracked as part of submitted time entries |
↳ allocatedHours | number | Allocated hours against users or placeholders |
↳ allocatedMinutes | number | Allocated minutes against users or placeholders |
↳ billableHours | number | Hours of time entries tracked as billable |
↳ billableMinutes | number | Minutes of time entries tracked as billable |
↳ nonBillableHours | number | Hours of time entries tracked as non-billable |
↳ nonBillableMinutes | number | Minutes of time entries tracked as non-billable |
↳ remainingHours | number | Hours left to complete the project based on tracked and budgeted hours |
↳ remainingMinutes | number | Minutes left to complete the project (complements remainingHours) |
↳ progressPercentage | number | Progress based on completed tasks vs total tasks |
↳ currentPhases | array | Phases currently marked as in progress |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ autoAllocation | boolean | Whether auto allocation is enabled for the project |
↳ sources | array | Project templates imported into the project |
↳ prefix | string | Prefix distinguishing which phase or task corresponds to which template |
↳ startDate | string | Date on which the template goes into effect (YYYY-MM-DD) |
↳ templateId | number | Unique identifier of the template |
↳ templateName | string | Name of the template |
↳ plannedDurationInDays | number | Difference between startDate and dueDate in days |
↳ inferredProgress | string | Inferred progress (ON_TRACK, AHEAD_OF_TIME, RUNNING_LATE, or NONE) |
↳ projectAgeInDays | number | Age of the project in days based on actual dates |
↳ customersInvited | number | Number of customers invited to the project |
↳ customersJoined | number | Number of customers who joined the project |
↳ externalReferenceId | string | Identifier linking the project to an external system |
placeholders | array | Placeholder-to-user mappings on the project |
↳ placeholder | object | Placeholder being mapped |
↳ placeholderId | number | Unique identifier of the placeholder |
↳ placeholderName | string | Name of the placeholder |
↳ placeholderStatus | string | Status of the placeholder (ASSIGNED or UNASSIGNED) |
↳ user | object | User assigned to the placeholder |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ role | string | Role name of the assigned user |
↳ hourlyCostRate | number | Latest hourly cost rate for the placeholder |
↳ costRateCurrency | string | Currency for the cost rate |
↳ hourlyBillRate | number | Latest hourly bill rate for the placeholder |
↳ billRateCurrency | string | Currency for the bill rate |
Create a new task in a Rocketlane project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
taskName | string | Yes | Name of the task |
projectId | number | Yes | ID of the project the task belongs to |
taskDescription | string | No | Description of the task in HTML format |
taskPrivateNote | string | No | Private note visible only to team members, in HTML format |
startDate | string | No | Date when the task starts (YYYY-MM-DD) |
dueDate | string | No | Date when the task is due, on or after the start date (YYYY-MM-DD) |
effortInMinutes | number | No | Expected effort to complete the task, in minutes |
progress | number | No | Progress of the task (0-100) |
atRisk | boolean | No | Whether the task is marked as At Risk |
type | string | No | Type of the task: TASK or MILESTONE (defaults to TASK) |
phaseId | number | No | ID of the phase to associate the task with (must belong to the project) |
statusValue | number | No | Status value to set on the task |
assigneeUserIds | array | No | User IDs of members to assign to the task |
assigneeEmailIds | array | No | Email addresses of members to assign to the task |
followerUserIds | array | No | User IDs of members to add as followers of the task |
followerEmailIds | array | No | Email addresses of members to add as followers of the task |
parentTaskId | number | No | ID of the parent task |
externalReferenceId | string | No | External reference identifier linking the task to an external system |
private | boolean | No | Whether the task is private |
includeFields | array | No | Extra fields to include in the response (startDateActual, dueDateActual, type, phase, assignees, followers, dependencies, billable, csatEnabled, priority, timeEntryCategory, financialsBudget, taskPrivateNote, parent, externalReferenceId) |
includeAllFields | boolean | No | Whether all fields should be returned in the response |
| Parameter | Type | Description |
|---|
task | object | The created task |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ taskDescription | string | Description of the task in HTML format |
↳ taskPrivateNote | string | Private note visible only to team members, in HTML format |
↳ startDate | string | Date when the task starts (YYYY-MM-DD) |
↳ dueDate | string | Date when the task is due (YYYY-MM-DD) |
↳ startDateActual | string | Date the task status changed to In Progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date the task status changed to Completed (YYYY-MM-DD) |
↳ archived | boolean | Whether the task is archived |
↳ effortInMinutes | number | Expected effort to complete the task, in minutes |
↳ progress | number | Progress of the task (0-100) |
↳ atRisk | boolean | Whether the task is marked as At Risk |
↳ type | string | Type of the task: TASK or MILESTONE |
↳ createdAt | number | Time the task was created, in epoch millis |
↳ updatedAt | number | Time the task was last updated, in epoch millis |
↳ createdBy | object | User who created the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ project | object | Project associated with the task |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ phase | object | Phase associated with the task |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ status | object | Status of the task (value and label) |
↳ priority | object | Priority of the task (value and label) |
↳ fields | array | Custom field values set on the task |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field (string, number, or array) |
↳ fieldValueLabel | string | String representation of the field value |
↳ assignees | object | Assignees of the task (members and placeholders) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ followers | object | Followers of the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ dependencies | array | Tasks this task depends on (finish-to-start dependencies) |
↳ parent | object | Parent task of the task |
↳ externalReferenceId | string | External reference identifier linking the task to an external system |
↳ billable | boolean | Whether the task is billable |
↳ timeEntryCategory | object | Category in which the task time entries are added |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ financialsBudgets | array | Financials budgets in which the task time entries are added |
↳ budgetId | number | Unique identifier of the budget |
↳ budgetName | string | Name of the budget |
↳ csatEnabled | boolean | Whether a CSAT survey is sent on completion (milestone tasks) |
↳ private | boolean | Whether the task is private |
Retrieve detailed information about a Rocketlane task by its unique identifier
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
taskId | number | Yes | Unique identifier of the task to retrieve |
includeFields | array | No | Extra fields to include in the response (startDateActual, dueDateActual, type, phase, assignees, followers, dependencies, billable, csatEnabled, priority, timeEntryCategory, financialsBudget, taskPrivateNote, parent, externalReferenceId) |
includeAllFields | boolean | No | Whether all fields should be returned in the response |
| Parameter | Type | Description |
|---|
task | object | The requested task |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ taskDescription | string | Description of the task in HTML format |
↳ taskPrivateNote | string | Private note visible only to team members, in HTML format |
↳ startDate | string | Date when the task starts (YYYY-MM-DD) |
↳ dueDate | string | Date when the task is due (YYYY-MM-DD) |
↳ startDateActual | string | Date the task status changed to In Progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date the task status changed to Completed (YYYY-MM-DD) |
↳ archived | boolean | Whether the task is archived |
↳ effortInMinutes | number | Expected effort to complete the task, in minutes |
↳ progress | number | Progress of the task (0-100) |
↳ atRisk | boolean | Whether the task is marked as At Risk |
↳ type | string | Type of the task: TASK or MILESTONE |
↳ createdAt | number | Time the task was created, in epoch millis |
↳ updatedAt | number | Time the task was last updated, in epoch millis |
↳ createdBy | object | User who created the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ project | object | Project associated with the task |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ phase | object | Phase associated with the task |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ status | object | Status of the task (value and label) |
↳ priority | object | Priority of the task (value and label) |
↳ fields | array | Custom field values set on the task |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field (string, number, or array) |
↳ fieldValueLabel | string | String representation of the field value |
↳ assignees | object | Assignees of the task (members and placeholders) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ followers | object | Followers of the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ dependencies | array | Tasks this task depends on (finish-to-start dependencies) |
↳ parent | object | Parent task of the task |
↳ externalReferenceId | string | External reference identifier linking the task to an external system |
↳ billable | boolean | Whether the task is billable |
↳ timeEntryCategory | object | Category in which the task time entries are added |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ financialsBudgets | array | Financials budgets in which the task time entries are added |
↳ budgetId | number | Unique identifier of the budget |
↳ budgetName | string | Name of the budget |
↳ csatEnabled | boolean | Whether a CSAT survey is sent on completion (milestone tasks) |
↳ private | boolean | Whether the task is private |
Retrieve all Rocketlane tasks with optional filters, sorting, and pagination
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
pageSize | number | No | Number of tasks per page (defaults to 100) |
pageToken | string | No | Token pointing to the next page of results, from a previous response |
includeFields | array | No | Extra fields to include in the response (startDateActual, dueDateActual, type, phase, assignees, followers, dependencies, billable, csatEnabled, priority, timeEntryCategory, financialsBudget, taskPrivateNote, parent, externalReferenceId) |
includeAllFields | boolean | No | Whether all fields should be returned in the response |
sortBy | string | No | Field to sort by: taskName, startDate, dueDate, startDateActual, or dueDateActual |
sortOrder | string | No | Sort order: ASC or DESC |
match | string | No | How multiple filters combine: all (AND) or any (OR) |
projectId | number | No | Filter tasks by project ID |
phaseId | number | No | Filter tasks by phase ID |
taskName | string | No | Filter tasks whose name exactly matches this value |
taskNameContains | string | No | Filter tasks whose name contains this value |
taskStatus | string | No | Filter tasks by task status value |
startDateFrom | string | No | Filter tasks with a start date on or after this date (YYYY-MM-DD) |
startDateTo | string | No | Filter tasks with a start date on or before this date (YYYY-MM-DD) |
dueDateFrom | string | No | Filter tasks with a due date on or after this date (YYYY-MM-DD) |
dueDateTo | string | No | Filter tasks with a due date on or before this date (YYYY-MM-DD) |
includeArchive | boolean | No | Whether archived tasks should be included in the results |
externalReferenceId | string | No | Filter tasks by external reference identifier |
| Parameter | Type | Description |
|---|
tasks | array | List of tasks matching the filters |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ taskDescription | string | Description of the task in HTML format |
↳ taskPrivateNote | string | Private note visible only to team members, in HTML format |
↳ startDate | string | Date when the task starts (YYYY-MM-DD) |
↳ dueDate | string | Date when the task is due (YYYY-MM-DD) |
↳ startDateActual | string | Date the task status changed to In Progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date the task status changed to Completed (YYYY-MM-DD) |
↳ archived | boolean | Whether the task is archived |
↳ effortInMinutes | number | Expected effort to complete the task, in minutes |
↳ progress | number | Progress of the task (0-100) |
↳ atRisk | boolean | Whether the task is marked as At Risk |
↳ type | string | Type of the task: TASK or MILESTONE |
↳ createdAt | number | Time the task was created, in epoch millis |
↳ updatedAt | number | Time the task was last updated, in epoch millis |
↳ createdBy | object | User who created the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ project | object | Project associated with the task |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ phase | object | Phase associated with the task |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ status | object | Status of the task (value and label) |
↳ priority | object | Priority of the task (value and label) |
↳ fields | array | Custom field values set on the task |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field (string, number, or array) |
↳ fieldValueLabel | string | String representation of the field value |
↳ assignees | object | Assignees of the task (members and placeholders) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ followers | object | Followers of the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ dependencies | array | Tasks this task depends on (finish-to-start dependencies) |
↳ parent | object | Parent task of the task |
↳ externalReferenceId | string | External reference identifier linking the task to an external system |
↳ billable | boolean | Whether the task is billable |
↳ timeEntryCategory | object | Category in which the task time entries are added |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ financialsBudgets | array | Financials budgets in which the task time entries are added |
↳ budgetId | number | Unique identifier of the budget |
↳ budgetName | string | Name of the budget |
↳ csatEnabled | boolean | Whether a CSAT survey is sent on completion (milestone tasks) |
↳ private | boolean | Whether the task is private |
pagination | object | Pagination details for the result set |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |
Update the properties of an existing Rocketlane task by its unique identifier
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
taskId | number | Yes | Unique identifier of the task to update |
taskName | string | No | New name of the task |
taskDescription | string | No | Description of the task in HTML format |
taskPrivateNote | string | No | Private note visible only to team members, in HTML format |
startDate | string | No | Date when the task starts (YYYY-MM-DD) |
dueDate | string | No | Date when the task is due, on or after the start date (YYYY-MM-DD) |
effortInMinutes | number | No | Expected effort to complete the task, in minutes |
progress | number | No | Progress of the task (0-100) |
atRisk | boolean | No | Whether the task is marked as At Risk |
type | string | No | Type of the task: TASK or MILESTONE |
statusValue | number | No | Status value to set on the task |
externalReferenceId | string | No | External reference identifier linking the task to an external system |
private | boolean | No | Whether the task is private |
includeFields | array | No | Extra fields to include in the response (startDateActual, dueDateActual, type, phase, assignees, followers, dependencies, billable, csatEnabled, priority, timeEntryCategory, financialsBudget, taskPrivateNote, parent, externalReferenceId) |
includeAllFields | boolean | No | Whether all fields should be returned in the response |
| Parameter | Type | Description |
|---|
task | object | The updated task |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ taskDescription | string | Description of the task in HTML format |
↳ taskPrivateNote | string | Private note visible only to team members, in HTML format |
↳ startDate | string | Date when the task starts (YYYY-MM-DD) |
↳ dueDate | string | Date when the task is due (YYYY-MM-DD) |
↳ startDateActual | string | Date the task status changed to In Progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date the task status changed to Completed (YYYY-MM-DD) |
↳ archived | boolean | Whether the task is archived |
↳ effortInMinutes | number | Expected effort to complete the task, in minutes |
↳ progress | number | Progress of the task (0-100) |
↳ atRisk | boolean | Whether the task is marked as At Risk |
↳ type | string | Type of the task: TASK or MILESTONE |
↳ createdAt | number | Time the task was created, in epoch millis |
↳ updatedAt | number | Time the task was last updated, in epoch millis |
↳ createdBy | object | User who created the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ project | object | Project associated with the task |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ phase | object | Phase associated with the task |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ status | object | Status of the task (value and label) |
↳ priority | object | Priority of the task (value and label) |
↳ fields | array | Custom field values set on the task |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field (string, number, or array) |
↳ fieldValueLabel | string | String representation of the field value |
↳ assignees | object | Assignees of the task (members and placeholders) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ followers | object | Followers of the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ dependencies | array | Tasks this task depends on (finish-to-start dependencies) |
↳ parent | object | Parent task of the task |
↳ externalReferenceId | string | External reference identifier linking the task to an external system |
↳ billable | boolean | Whether the task is billable |
↳ timeEntryCategory | object | Category in which the task time entries are added |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ financialsBudgets | array | Financials budgets in which the task time entries are added |
↳ budgetId | number | Unique identifier of the budget |
↳ budgetName | string | Name of the budget |
↳ csatEnabled | boolean | Whether a CSAT survey is sent on completion (milestone tasks) |
↳ private | boolean | Whether the task is private |
Permanently delete a Rocketlane task by its unique identifier
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
taskId | number | Yes | Unique identifier of the task to delete |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the task was deleted |
taskId | number | ID of the deleted task |
Move a Rocketlane task to a given phase, associating the task with that phase
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
taskId | number | Yes | Unique identifier of the task to move |
phaseId | number | Yes | Unique identifier of the phase to move the task to |
| Parameter | Type | Description |
|---|
task | object | The task with its updated phase |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ taskDescription | string | Description of the task in HTML format |
↳ taskPrivateNote | string | Private note visible only to team members, in HTML format |
↳ startDate | string | Date when the task starts (YYYY-MM-DD) |
↳ dueDate | string | Date when the task is due (YYYY-MM-DD) |
↳ startDateActual | string | Date the task status changed to In Progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date the task status changed to Completed (YYYY-MM-DD) |
↳ archived | boolean | Whether the task is archived |
↳ effortInMinutes | number | Expected effort to complete the task, in minutes |
↳ progress | number | Progress of the task (0-100) |
↳ atRisk | boolean | Whether the task is marked as At Risk |
↳ type | string | Type of the task: TASK or MILESTONE |
↳ createdAt | number | Time the task was created, in epoch millis |
↳ updatedAt | number | Time the task was last updated, in epoch millis |
↳ createdBy | object | User who created the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ project | object | Project associated with the task |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ phase | object | Phase associated with the task |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ status | object | Status of the task (value and label) |
↳ priority | object | Priority of the task (value and label) |
↳ fields | array | Custom field values set on the task |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field (string, number, or array) |
↳ fieldValueLabel | string | String representation of the field value |
↳ assignees | object | Assignees of the task (members and placeholders) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ followers | object | Followers of the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ dependencies | array | Tasks this task depends on (finish-to-start dependencies) |
↳ parent | object | Parent task of the task |
↳ externalReferenceId | string | External reference identifier linking the task to an external system |
↳ billable | boolean | Whether the task is billable |
↳ timeEntryCategory | object | Category in which the task time entries are added |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ financialsBudgets | array | Financials budgets in which the task time entries are added |
↳ budgetId | number | Unique identifier of the budget |
↳ budgetName | string | Name of the budget |
↳ csatEnabled | boolean | Whether a CSAT survey is sent on completion (milestone tasks) |
↳ private | boolean | Whether the task is private |
Add members as assignees to a Rocketlane task
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
taskId | number | Yes | Unique identifier of the task to add assignees to |
memberUserIds | array | No | User IDs of members to add as assignees |
memberEmailIds | array | No | Email addresses of members to add as assignees |
| Parameter | Type | Description |
|---|
task | object | The task with its updated assignees |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ taskDescription | string | Description of the task in HTML format |
↳ taskPrivateNote | string | Private note visible only to team members, in HTML format |
↳ startDate | string | Date when the task starts (YYYY-MM-DD) |
↳ dueDate | string | Date when the task is due (YYYY-MM-DD) |
↳ startDateActual | string | Date the task status changed to In Progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date the task status changed to Completed (YYYY-MM-DD) |
↳ archived | boolean | Whether the task is archived |
↳ effortInMinutes | number | Expected effort to complete the task, in minutes |
↳ progress | number | Progress of the task (0-100) |
↳ atRisk | boolean | Whether the task is marked as At Risk |
↳ type | string | Type of the task: TASK or MILESTONE |
↳ createdAt | number | Time the task was created, in epoch millis |
↳ updatedAt | number | Time the task was last updated, in epoch millis |
↳ createdBy | object | User who created the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ project | object | Project associated with the task |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ phase | object | Phase associated with the task |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ status | object | Status of the task (value and label) |
↳ priority | object | Priority of the task (value and label) |
↳ fields | array | Custom field values set on the task |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field (string, number, or array) |
↳ fieldValueLabel | string | String representation of the field value |
↳ assignees | object | Assignees of the task (members and placeholders) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ followers | object | Followers of the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ dependencies | array | Tasks this task depends on (finish-to-start dependencies) |
↳ parent | object | Parent task of the task |
↳ externalReferenceId | string | External reference identifier linking the task to an external system |
↳ billable | boolean | Whether the task is billable |
↳ timeEntryCategory | object | Category in which the task time entries are added |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ financialsBudgets | array | Financials budgets in which the task time entries are added |
↳ budgetId | number | Unique identifier of the budget |
↳ budgetName | string | Name of the budget |
↳ csatEnabled | boolean | Whether a CSAT survey is sent on completion (milestone tasks) |
↳ private | boolean | Whether the task is private |
Remove assignees from a Rocketlane task
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
taskId | number | Yes | Unique identifier of the task to remove assignees from |
memberUserIds | array | No | User IDs of members to remove from the assignees |
memberEmailIds | array | No | Email addresses of members to remove from the assignees |
| Parameter | Type | Description |
|---|
task | object | The task with its updated assignees |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ taskDescription | string | Description of the task in HTML format |
↳ taskPrivateNote | string | Private note visible only to team members, in HTML format |
↳ startDate | string | Date when the task starts (YYYY-MM-DD) |
↳ dueDate | string | Date when the task is due (YYYY-MM-DD) |
↳ startDateActual | string | Date the task status changed to In Progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date the task status changed to Completed (YYYY-MM-DD) |
↳ archived | boolean | Whether the task is archived |
↳ effortInMinutes | number | Expected effort to complete the task, in minutes |
↳ progress | number | Progress of the task (0-100) |
↳ atRisk | boolean | Whether the task is marked as At Risk |
↳ type | string | Type of the task: TASK or MILESTONE |
↳ createdAt | number | Time the task was created, in epoch millis |
↳ updatedAt | number | Time the task was last updated, in epoch millis |
↳ createdBy | object | User who created the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ project | object | Project associated with the task |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ phase | object | Phase associated with the task |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ status | object | Status of the task (value and label) |
↳ priority | object | Priority of the task (value and label) |
↳ fields | array | Custom field values set on the task |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field (string, number, or array) |
↳ fieldValueLabel | string | String representation of the field value |
↳ assignees | object | Assignees of the task (members and placeholders) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ followers | object | Followers of the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ dependencies | array | Tasks this task depends on (finish-to-start dependencies) |
↳ parent | object | Parent task of the task |
↳ externalReferenceId | string | External reference identifier linking the task to an external system |
↳ billable | boolean | Whether the task is billable |
↳ timeEntryCategory | object | Category in which the task time entries are added |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ financialsBudgets | array | Financials budgets in which the task time entries are added |
↳ budgetId | number | Unique identifier of the budget |
↳ budgetName | string | Name of the budget |
↳ csatEnabled | boolean | Whether a CSAT survey is sent on completion (milestone tasks) |
↳ private | boolean | Whether the task is private |
Add members as followers to a Rocketlane task
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
taskId | number | Yes | Unique identifier of the task to add followers to |
memberUserIds | array | No | User IDs of members to add as followers |
memberEmailIds | array | No | Email addresses of members to add as followers |
| Parameter | Type | Description |
|---|
task | object | The task with its updated followers |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ taskDescription | string | Description of the task in HTML format |
↳ taskPrivateNote | string | Private note visible only to team members, in HTML format |
↳ startDate | string | Date when the task starts (YYYY-MM-DD) |
↳ dueDate | string | Date when the task is due (YYYY-MM-DD) |
↳ startDateActual | string | Date the task status changed to In Progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date the task status changed to Completed (YYYY-MM-DD) |
↳ archived | boolean | Whether the task is archived |
↳ effortInMinutes | number | Expected effort to complete the task, in minutes |
↳ progress | number | Progress of the task (0-100) |
↳ atRisk | boolean | Whether the task is marked as At Risk |
↳ type | string | Type of the task: TASK or MILESTONE |
↳ createdAt | number | Time the task was created, in epoch millis |
↳ updatedAt | number | Time the task was last updated, in epoch millis |
↳ createdBy | object | User who created the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ project | object | Project associated with the task |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ phase | object | Phase associated with the task |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ status | object | Status of the task (value and label) |
↳ priority | object | Priority of the task (value and label) |
↳ fields | array | Custom field values set on the task |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field (string, number, or array) |
↳ fieldValueLabel | string | String representation of the field value |
↳ assignees | object | Assignees of the task (members and placeholders) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ followers | object | Followers of the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ dependencies | array | Tasks this task depends on (finish-to-start dependencies) |
↳ parent | object | Parent task of the task |
↳ externalReferenceId | string | External reference identifier linking the task to an external system |
↳ billable | boolean | Whether the task is billable |
↳ timeEntryCategory | object | Category in which the task time entries are added |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ financialsBudgets | array | Financials budgets in which the task time entries are added |
↳ budgetId | number | Unique identifier of the budget |
↳ budgetName | string | Name of the budget |
↳ csatEnabled | boolean | Whether a CSAT survey is sent on completion (milestone tasks) |
↳ private | boolean | Whether the task is private |
Remove followers from a Rocketlane task
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
taskId | number | Yes | Unique identifier of the task to remove followers from |
memberUserIds | array | No | User IDs of members to remove from the followers |
memberEmailIds | array | No | Email addresses of members to remove from the followers |
| Parameter | Type | Description |
|---|
task | object | The task with its updated followers |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ taskDescription | string | Description of the task in HTML format |
↳ taskPrivateNote | string | Private note visible only to team members, in HTML format |
↳ startDate | string | Date when the task starts (YYYY-MM-DD) |
↳ dueDate | string | Date when the task is due (YYYY-MM-DD) |
↳ startDateActual | string | Date the task status changed to In Progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date the task status changed to Completed (YYYY-MM-DD) |
↳ archived | boolean | Whether the task is archived |
↳ effortInMinutes | number | Expected effort to complete the task, in minutes |
↳ progress | number | Progress of the task (0-100) |
↳ atRisk | boolean | Whether the task is marked as At Risk |
↳ type | string | Type of the task: TASK or MILESTONE |
↳ createdAt | number | Time the task was created, in epoch millis |
↳ updatedAt | number | Time the task was last updated, in epoch millis |
↳ createdBy | object | User who created the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ project | object | Project associated with the task |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ phase | object | Phase associated with the task |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ status | object | Status of the task (value and label) |
↳ priority | object | Priority of the task (value and label) |
↳ fields | array | Custom field values set on the task |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field (string, number, or array) |
↳ fieldValueLabel | string | String representation of the field value |
↳ assignees | object | Assignees of the task (members and placeholders) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ followers | object | Followers of the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ dependencies | array | Tasks this task depends on (finish-to-start dependencies) |
↳ parent | object | Parent task of the task |
↳ externalReferenceId | string | External reference identifier linking the task to an external system |
↳ billable | boolean | Whether the task is billable |
↳ timeEntryCategory | object | Category in which the task time entries are added |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ financialsBudgets | array | Financials budgets in which the task time entries are added |
↳ budgetId | number | Unique identifier of the budget |
↳ budgetName | string | Name of the budget |
↳ csatEnabled | boolean | Whether a CSAT survey is sent on completion (milestone tasks) |
↳ private | boolean | Whether the task is private |
Add finish-to-start dependencies between a Rocketlane task and other tasks
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
taskId | number | Yes | Unique identifier of the task to add dependencies to |
dependencyTaskIds | array | Yes | Task IDs the task should depend on |
| Parameter | Type | Description |
|---|
task | object | The task with its updated dependencies |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ taskDescription | string | Description of the task in HTML format |
↳ taskPrivateNote | string | Private note visible only to team members, in HTML format |
↳ startDate | string | Date when the task starts (YYYY-MM-DD) |
↳ dueDate | string | Date when the task is due (YYYY-MM-DD) |
↳ startDateActual | string | Date the task status changed to In Progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date the task status changed to Completed (YYYY-MM-DD) |
↳ archived | boolean | Whether the task is archived |
↳ effortInMinutes | number | Expected effort to complete the task, in minutes |
↳ progress | number | Progress of the task (0-100) |
↳ atRisk | boolean | Whether the task is marked as At Risk |
↳ type | string | Type of the task: TASK or MILESTONE |
↳ createdAt | number | Time the task was created, in epoch millis |
↳ updatedAt | number | Time the task was last updated, in epoch millis |
↳ createdBy | object | User who created the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ project | object | Project associated with the task |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ phase | object | Phase associated with the task |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ status | object | Status of the task (value and label) |
↳ priority | object | Priority of the task (value and label) |
↳ fields | array | Custom field values set on the task |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field (string, number, or array) |
↳ fieldValueLabel | string | String representation of the field value |
↳ assignees | object | Assignees of the task (members and placeholders) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ followers | object | Followers of the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ dependencies | array | Tasks this task depends on (finish-to-start dependencies) |
↳ parent | object | Parent task of the task |
↳ externalReferenceId | string | External reference identifier linking the task to an external system |
↳ billable | boolean | Whether the task is billable |
↳ timeEntryCategory | object | Category in which the task time entries are added |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ financialsBudgets | array | Financials budgets in which the task time entries are added |
↳ budgetId | number | Unique identifier of the budget |
↳ budgetName | string | Name of the budget |
↳ csatEnabled | boolean | Whether a CSAT survey is sent on completion (milestone tasks) |
↳ private | boolean | Whether the task is private |
Remove dependencies from a Rocketlane task
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
taskId | number | Yes | Unique identifier of the task to remove dependencies from |
dependencyTaskIds | array | Yes | Task IDs to remove from the task dependencies |
| Parameter | Type | Description |
|---|
task | object | The task with its updated dependencies |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ taskDescription | string | Description of the task in HTML format |
↳ taskPrivateNote | string | Private note visible only to team members, in HTML format |
↳ startDate | string | Date when the task starts (YYYY-MM-DD) |
↳ dueDate | string | Date when the task is due (YYYY-MM-DD) |
↳ startDateActual | string | Date the task status changed to In Progress (YYYY-MM-DD) |
↳ dueDateActual | string | Date the task status changed to Completed (YYYY-MM-DD) |
↳ archived | boolean | Whether the task is archived |
↳ effortInMinutes | number | Expected effort to complete the task, in minutes |
↳ progress | number | Progress of the task (0-100) |
↳ atRisk | boolean | Whether the task is marked as At Risk |
↳ type | string | Type of the task: TASK or MILESTONE |
↳ createdAt | number | Time the task was created, in epoch millis |
↳ updatedAt | number | Time the task was last updated, in epoch millis |
↳ createdBy | object | User who created the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ project | object | Project associated with the task |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ phase | object | Phase associated with the task |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ status | object | Status of the task (value and label) |
↳ priority | object | Priority of the task (value and label) |
↳ fields | array | Custom field values set on the task |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field (string, number, or array) |
↳ fieldValueLabel | string | String representation of the field value |
↳ assignees | object | Assignees of the task (members and placeholders) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ followers | object | Followers of the task |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ dependencies | array | Tasks this task depends on (finish-to-start dependencies) |
↳ parent | object | Parent task of the task |
↳ externalReferenceId | string | External reference identifier linking the task to an external system |
↳ billable | boolean | Whether the task is billable |
↳ timeEntryCategory | object | Category in which the task time entries are added |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ financialsBudgets | array | Financials budgets in which the task time entries are added |
↳ budgetId | number | Unique identifier of the budget |
↳ budgetName | string | Name of the budget |
↳ csatEnabled | boolean | Whether a CSAT survey is sent on completion (milestone tasks) |
↳ private | boolean | Whether the task is private |
Create a new phase in a Rocketlane project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
phaseName | string | Yes | Name of the phase |
projectId | number | Yes | ID of the project to create the phase in |
startDate | string | Yes | Planned start date of the phase (YYYY-MM-DD) |
dueDate | string | Yes | Planned due date of the phase (YYYY-MM-DD) |
statusValue | number | No | Numeric status value to set on the phase |
private | boolean | No | Whether the phase is private |
includeFields | string | No | Comma-separated extra phase properties to include in the response (supported: startDateActual, dueDateActual) |
includeAllFields | boolean | No | Whether to return all phase properties in the response |
| Parameter | Type | Description |
|---|
phase | object | The created phase |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ project | object | Project the phase belongs to |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ startDate | string | Planned start date of the phase (YYYY-MM-DD) |
↳ dueDate | string | Planned due date of the phase (YYYY-MM-DD) |
↳ startDateActual | string | Actual start date of the phase (YYYY-MM-DD) |
↳ dueDateActual | string | Actual due date of the phase (YYYY-MM-DD) |
↳ createdAt | number | Time the phase was created, in epoch milliseconds |
↳ updatedAt | number | Time the phase was last updated, in epoch milliseconds |
↳ createdBy | object | Team member who created the phase |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the phase |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ status | object | Status of the phase |
↳ value | number | Numeric status value |
↳ label | string | Display label of the status |
↳ private | boolean | Whether the phase is private |
Retrieve a single Rocketlane phase by ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
phaseId | number | Yes | ID of the phase to retrieve |
includeFields | string | No | Comma-separated extra phase properties to include in the response (supported: startDateActual, dueDateActual) |
includeAllFields | boolean | No | Whether to return all phase properties in the response |
| Parameter | Type | Description |
|---|
phase | object | The requested phase |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ project | object | Project the phase belongs to |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ startDate | string | Planned start date of the phase (YYYY-MM-DD) |
↳ dueDate | string | Planned due date of the phase (YYYY-MM-DD) |
↳ startDateActual | string | Actual start date of the phase (YYYY-MM-DD) |
↳ dueDateActual | string | Actual due date of the phase (YYYY-MM-DD) |
↳ createdAt | number | Time the phase was created, in epoch milliseconds |
↳ updatedAt | number | Time the phase was last updated, in epoch milliseconds |
↳ createdBy | object | Team member who created the phase |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the phase |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ status | object | Status of the phase |
↳ value | number | Numeric status value |
↳ label | string | Display label of the status |
↳ private | boolean | Whether the phase is private |
List phases of a Rocketlane project, with optional filters, sorting, and pagination
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
projectId | number | Yes | ID of the project to list phases for |
pageSize | number | No | Number of phases per page |
pageToken | string | No | Page token returned by a previous request (valid for 15 minutes) |
includeFields | string | No | Comma-separated extra phase properties to include in the response (supported: startDateActual, dueDateActual) |
includeAllFields | boolean | No | Whether to return all phase properties in the response |
sortBy | string | No | Property to sort by (phaseName, startDate, dueDate, startDateActual, dueDateActual) |
sortOrder | string | No | Sort order (ASC or DESC) |
match | string | No | Whether results must match all filters or any filter (all or any) |
phaseName | string | No | Filter by exact phase name |
| Parameter | Type | Description |
|---|
phases | array | List of phases |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ project | object | Project the phase belongs to |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ startDate | string | Planned start date of the phase (YYYY-MM-DD) |
↳ dueDate | string | Planned due date of the phase (YYYY-MM-DD) |
↳ startDateActual | string | Actual start date of the phase (YYYY-MM-DD) |
↳ dueDateActual | string | Actual due date of the phase (YYYY-MM-DD) |
↳ createdAt | number | Time the phase was created, in epoch milliseconds |
↳ updatedAt | number | Time the phase was last updated, in epoch milliseconds |
↳ createdBy | object | Team member who created the phase |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the phase |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ status | object | Status of the phase |
↳ value | number | Numeric status value |
↳ label | string | Display label of the status |
↳ private | boolean | Whether the phase is private |
pagination | object | Pagination details for the result set |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |
Update the name, dates, status, or privacy of an existing Rocketlane phase
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
phaseId | number | Yes | ID of the phase to update |
phaseName | string | No | New name of the phase |
startDate | string | No | New planned start date of the phase (YYYY-MM-DD) |
dueDate | string | No | New planned due date of the phase (YYYY-MM-DD) |
statusValue | number | No | New numeric status value for the phase |
private | boolean | No | Whether the phase is private |
includeFields | string | No | Comma-separated extra phase properties to include in the response (supported: startDateActual, dueDateActual) |
includeAllFields | boolean | No | Whether to return all phase properties in the response |
| Parameter | Type | Description |
|---|
phase | object | The updated phase |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ project | object | Project the phase belongs to |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ startDate | string | Planned start date of the phase (YYYY-MM-DD) |
↳ dueDate | string | Planned due date of the phase (YYYY-MM-DD) |
↳ startDateActual | string | Actual start date of the phase (YYYY-MM-DD) |
↳ dueDateActual | string | Actual due date of the phase (YYYY-MM-DD) |
↳ createdAt | number | Time the phase was created, in epoch milliseconds |
↳ updatedAt | number | Time the phase was last updated, in epoch milliseconds |
↳ createdBy | object | Team member who created the phase |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the phase |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ status | object | Status of the phase |
↳ value | number | Numeric status value |
↳ label | string | Display label of the status |
↳ private | boolean | Whether the phase is private |
Permanently delete a Rocketlane phase by ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
phaseId | number | Yes | ID of the phase to delete |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the phase was deleted |
phaseId | number | ID of the deleted phase |
Create a custom field in your Rocketlane account, with options for SINGLE_CHOICE and MULTIPLE_CHOICE field types
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
fieldLabel | string | Yes | Name of the field |
fieldType | string | Yes | Type of the field (TEXT, MULTI_LINE_TEXT, YES_OR_NO, DATE, SINGLE_CHOICE, MULTIPLE_CHOICE, SINGLE_USER, MULTIPLE_USER, NUMBER, NOTE, RATING) |
objectType | string | Yes | Object the field is associated with (PROJECT, TASK, or USER) |
fieldDescription | string | No | Description of the field |
fieldOptions | array | No | Options for SINGLE_CHOICE and MULTIPLE_CHOICE fields; the order provided is preserved |
ratingScale | string | No | Number of stars for RATING fields (THREE, FIVE, SEVEN, TEN) |
enabled | boolean | No | Whether the field is enabled (defaults to true) |
private | boolean | No | Whether the field is private |
includeFields | string | No | Comma-separated extra field properties to include in the response (supported: options) |
includeAllFields | boolean | No | Whether to return all field properties in the response |
| Parameter | Type | Description |
|---|
field | object | The created field |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Name of the field |
↳ fieldDescription | string | Description of the field |
↳ fieldType | string | Type of the field (TEXT, MULTI_LINE_TEXT, YES_OR_NO, DATE, SINGLE_CHOICE, MULTIPLE_CHOICE, SINGLE_USER, MULTIPLE_USER, NUMBER, NOTE, RATING) |
↳ objectType | string | Object the field is associated with (PROJECT, TASK, or USER) |
↳ fieldOptions | array | Options available for SINGLE_CHOICE and MULTIPLE_CHOICE fields |
↳ optionValue | number | Unique identifier of the option within the field |
↳ optionLabel | string | Display label of the option |
↳ optionColor | string | Color of the option (RED, YELLOW, GREEN, TEAL, CYAN, BLUE, PURPLE, MAGENTA, GRAY, COOL_GRAY) |
↳ ratingScale | string | Rating scale for RATING fields (THREE, FIVE, SEVEN, TEN) |
↳ createdBy | object | Team member who created the field |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the field |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ createdAt | number | Time the field was created, in epoch milliseconds |
↳ updatedAt | number | Time the field was last updated, in epoch milliseconds |
↳ enabled | boolean | Whether the field is enabled |
↳ private | boolean | Whether the field is private |
Retrieve a single Rocketlane field by ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
fieldId | number | Yes | ID of the field to retrieve |
includeFields | string | No | Comma-separated extra field properties to include in the response (supported: options) |
includeAllFields | boolean | No | Whether to return all field properties in the response |
| Parameter | Type | Description |
|---|
field | object | The requested field |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Name of the field |
↳ fieldDescription | string | Description of the field |
↳ fieldType | string | Type of the field (TEXT, MULTI_LINE_TEXT, YES_OR_NO, DATE, SINGLE_CHOICE, MULTIPLE_CHOICE, SINGLE_USER, MULTIPLE_USER, NUMBER, NOTE, RATING) |
↳ objectType | string | Object the field is associated with (PROJECT, TASK, or USER) |
↳ fieldOptions | array | Options available for SINGLE_CHOICE and MULTIPLE_CHOICE fields |
↳ optionValue | number | Unique identifier of the option within the field |
↳ optionLabel | string | Display label of the option |
↳ optionColor | string | Color of the option (RED, YELLOW, GREEN, TEAL, CYAN, BLUE, PURPLE, MAGENTA, GRAY, COOL_GRAY) |
↳ ratingScale | string | Rating scale for RATING fields (THREE, FIVE, SEVEN, TEN) |
↳ createdBy | object | Team member who created the field |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the field |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ createdAt | number | Time the field was created, in epoch milliseconds |
↳ updatedAt | number | Time the field was last updated, in epoch milliseconds |
↳ enabled | boolean | Whether the field is enabled |
↳ private | boolean | Whether the field is private |
List fields in your Rocketlane account, with optional filters, sorting, and pagination
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
pageSize | number | No | Number of fields per page |
pageToken | string | No | Page token returned by a previous request (valid for 15 minutes) |
includeFields | string | No | Comma-separated extra field properties to include in the response (supported: options) |
includeAllFields | boolean | No | Whether to return all field properties in the response |
sortBy | string | No | Property to sort by (supported: fieldLabel) |
sortOrder | string | No | Sort order (ASC or DESC) |
match | string | No | Whether results must match all filters or any filter (all or any) |
objectType | string | No | Filter by associated object type (PROJECT, TASK, or USER) |
fieldType | string | No | Filter by field type (TEXT, MULTI_LINE_TEXT, YES_OR_NO, DATE, SINGLE_CHOICE, MULTIPLE_CHOICE, SINGLE_USER, MULTIPLE_USER, NUMBER, NOTE, RATING) |
enabled | boolean | No | Filter by enabled state |
private | boolean | No | Filter by privacy setting |
| Parameter | Type | Description |
|---|
fields | array | List of fields |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Name of the field |
↳ fieldDescription | string | Description of the field |
↳ fieldType | string | Type of the field (TEXT, MULTI_LINE_TEXT, YES_OR_NO, DATE, SINGLE_CHOICE, MULTIPLE_CHOICE, SINGLE_USER, MULTIPLE_USER, NUMBER, NOTE, RATING) |
↳ objectType | string | Object the field is associated with (PROJECT, TASK, or USER) |
↳ fieldOptions | array | Options available for SINGLE_CHOICE and MULTIPLE_CHOICE fields |
↳ optionValue | number | Unique identifier of the option within the field |
↳ optionLabel | string | Display label of the option |
↳ optionColor | string | Color of the option (RED, YELLOW, GREEN, TEAL, CYAN, BLUE, PURPLE, MAGENTA, GRAY, COOL_GRAY) |
↳ ratingScale | string | Rating scale for RATING fields (THREE, FIVE, SEVEN, TEN) |
↳ createdBy | object | Team member who created the field |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the field |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ createdAt | number | Time the field was created, in epoch milliseconds |
↳ updatedAt | number | Time the field was last updated, in epoch milliseconds |
↳ enabled | boolean | Whether the field is enabled |
↳ private | boolean | Whether the field is private |
pagination | object | Pagination details for the result set |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |
Update the label, description, enabled state, or privacy of an existing Rocketlane field
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
fieldId | number | Yes | ID of the field to update |
fieldLabel | string | No | New name of the field |
fieldDescription | string | No | New description of the field |
enabled | boolean | No | Whether the field is enabled |
private | boolean | No | Whether the field is private |
includeFields | string | No | Comma-separated extra field properties to include in the response (supported: options) |
includeAllFields | boolean | No | Whether to return all field properties in the response |
| Parameter | Type | Description |
|---|
field | object | The updated field |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Name of the field |
↳ fieldDescription | string | Description of the field |
↳ fieldType | string | Type of the field (TEXT, MULTI_LINE_TEXT, YES_OR_NO, DATE, SINGLE_CHOICE, MULTIPLE_CHOICE, SINGLE_USER, MULTIPLE_USER, NUMBER, NOTE, RATING) |
↳ objectType | string | Object the field is associated with (PROJECT, TASK, or USER) |
↳ fieldOptions | array | Options available for SINGLE_CHOICE and MULTIPLE_CHOICE fields |
↳ optionValue | number | Unique identifier of the option within the field |
↳ optionLabel | string | Display label of the option |
↳ optionColor | string | Color of the option (RED, YELLOW, GREEN, TEAL, CYAN, BLUE, PURPLE, MAGENTA, GRAY, COOL_GRAY) |
↳ ratingScale | string | Rating scale for RATING fields (THREE, FIVE, SEVEN, TEN) |
↳ createdBy | object | Team member who created the field |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | Team member who last updated the field |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ createdAt | number | Time the field was created, in epoch milliseconds |
↳ updatedAt | number | Time the field was last updated, in epoch milliseconds |
↳ enabled | boolean | Whether the field is enabled |
↳ private | boolean | Whether the field is private |
Permanently delete a Rocketlane field by ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
fieldId | number | Yes | ID of the field to delete |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the field was deleted |
fieldId | number | ID of the deleted field |
Add a new option to an existing SINGLE_CHOICE or MULTIPLE_CHOICE Rocketlane field
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
fieldId | number | Yes | ID of the field to add the option to |
optionLabel | string | Yes | Display label of the new option |
optionColor | string | Yes | Color of the new option (RED, YELLOW, GREEN, TEAL, CYAN, BLUE, PURPLE, MAGENTA, GRAY, COOL_GRAY) |
| Parameter | Type | Description |
|---|
option | object | The created field option |
↳ optionValue | number | Unique identifier of the option within the field |
↳ optionLabel | string | Display label of the option |
↳ optionColor | string | Color of the option (RED, YELLOW, GREEN, TEAL, CYAN, BLUE, PURPLE, MAGENTA, GRAY, COOL_GRAY) |
Update the label or color of an existing option on a SINGLE_CHOICE or MULTIPLE_CHOICE Rocketlane field
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
fieldId | number | Yes | ID of the field the option belongs to |
optionValue | number | Yes | Unique identifier of the option to update |
optionLabel | string | No | New display label of the option |
optionColor | string | No | New color of the option (RED, YELLOW, GREEN, TEAL, CYAN, BLUE, PURPLE, MAGENTA, GRAY, COOL_GRAY) |
| Parameter | Type | Description |
|---|
option | object | The updated field option |
↳ optionValue | number | Unique identifier of the option within the field |
↳ optionLabel | string | Display label of the option |
↳ optionColor | string | Color of the option (RED, YELLOW, GREEN, TEAL, CYAN, BLUE, PURPLE, MAGENTA, GRAY, COOL_GRAY) |
Create a time entry in Rocketlane against an adhoc activity, task, project phase, or project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
date | string | Yes | Date of the time entry in YYYY-MM-DD format |
minutes | number | Yes | Duration of the time entry in minutes (1-1440) |
activityName | string | No | Name of the adhoc activity to track time against. Exactly one source is required among activityName, taskId, projectPhaseId, and projectId — providing more than one results in an error |
taskId | number | No | ID of the task to track time against. Exactly one source is required among activityName, taskId, projectPhaseId, and projectId — providing more than one results in an error |
projectPhaseId | number | No | ID of the project phase to track time against. Exactly one source is required among activityName, taskId, projectPhaseId, and projectId — providing more than one results in an error |
projectId | number | No | ID of the project to track time against. Exactly one source is required among activityName, taskId, projectPhaseId, and projectId — providing more than one results in an error |
billable | boolean | No | Whether the time entry is billable (defaults to true) |
userId | number | No | ID of the user the time entry belongs to |
userEmail | string | No | Email of the user the time entry belongs to (alternative to userId) |
notes | string | No | Notes for the time entry |
categoryId | number | No | ID of the time entry category |
includeFields | string | No | Comma-separated extra fields to include in the response (notes, sourceType, deleted, status, submittedBy, submittedAt, approvedBy, approvedAt, rejectedBy, rejectedAt, costRate, billRate) |
includeAllFields | boolean | No | Whether all fields should be returned in the response |
| Parameter | Type | Description |
|---|
timeEntry | object | The created time entry |
↳ timeEntryId | number | Unique identifier of the time entry |
↳ date | string | Date of the time entry (YYYY-MM-DD) |
↳ minutes | number | Duration of the time entry in minutes |
↳ activityName | string | Name of the adhoc activity, when the entry is tracked against an activity |
↳ project | object | Project associated with the time entry |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ task | object | Task associated with the time entry |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ projectPhase | object | Project phase associated with the time entry |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ billable | boolean | Whether the time entry is billable |
↳ user | object | User the time entry belongs to |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ notes | string | Notes for the time entry |
↳ category | object | Category associated with the time entry |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ sourceType | string | Source of the time entry (GOOGLE_CALENDAR, OUTLOOK_CALENDAR, TASK, PROJECT, PHASE, ADHOC, MILESTONE) |
↳ status | string | Approval status of the time entry (NOT_SUBMITTED, SUBMITTED, APPROVED, REJECTED) |
↳ createdAt | number | Creation timestamp in epoch milliseconds |
↳ updatedAt | number | Last-updated timestamp in epoch milliseconds |
↳ createdBy | object | User who created the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ submittedBy | object | User who submitted the time entry (may be null even for approved/rejected entries) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ submittedAt | number | Submission timestamp in epoch milliseconds |
↳ approvedBy | object | User who approved the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ approvedAt | number | Approval timestamp in epoch milliseconds |
↳ rejectedBy | object | User who rejected the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ rejectedAt | number | Rejection timestamp in epoch milliseconds |
↳ deleted | boolean | Whether the time entry is deleted |
↳ costRate | object | Hourly cost rate assigned to the user for this entry |
↳ billRate | object | Hourly rate billed to the customer for this entry |
↳ fields | array | Custom fields associated with the time entry |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field |
↳ fieldValueLabel | string | String representation of the field value |
Get a single Rocketlane time entry by ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
timeEntryId | number | Yes | ID of the time entry to retrieve |
includeFields | string | No | Comma-separated extra fields to include in the response (notes, sourceType, deleted, status, submittedBy, submittedAt, approvedBy, approvedAt, rejectedBy, rejectedAt, costRate, billRate) |
includeAllFields | boolean | No | Whether all fields should be returned in the response |
| Parameter | Type | Description |
|---|
timeEntry | object | The requested time entry |
↳ timeEntryId | number | Unique identifier of the time entry |
↳ date | string | Date of the time entry (YYYY-MM-DD) |
↳ minutes | number | Duration of the time entry in minutes |
↳ activityName | string | Name of the adhoc activity, when the entry is tracked against an activity |
↳ project | object | Project associated with the time entry |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ task | object | Task associated with the time entry |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ projectPhase | object | Project phase associated with the time entry |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ billable | boolean | Whether the time entry is billable |
↳ user | object | User the time entry belongs to |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ notes | string | Notes for the time entry |
↳ category | object | Category associated with the time entry |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ sourceType | string | Source of the time entry (GOOGLE_CALENDAR, OUTLOOK_CALENDAR, TASK, PROJECT, PHASE, ADHOC, MILESTONE) |
↳ status | string | Approval status of the time entry (NOT_SUBMITTED, SUBMITTED, APPROVED, REJECTED) |
↳ createdAt | number | Creation timestamp in epoch milliseconds |
↳ updatedAt | number | Last-updated timestamp in epoch milliseconds |
↳ createdBy | object | User who created the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ submittedBy | object | User who submitted the time entry (may be null even for approved/rejected entries) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ submittedAt | number | Submission timestamp in epoch milliseconds |
↳ approvedBy | object | User who approved the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ approvedAt | number | Approval timestamp in epoch milliseconds |
↳ rejectedBy | object | User who rejected the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ rejectedAt | number | Rejection timestamp in epoch milliseconds |
↳ deleted | boolean | Whether the time entry is deleted |
↳ costRate | object | Hourly cost rate assigned to the user for this entry |
↳ billRate | object | Hourly rate billed to the customer for this entry |
↳ fields | array | Custom fields associated with the time entry |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field |
↳ fieldValueLabel | string | String representation of the field value |
List Rocketlane time entries with optional filters, sorting, and cursor-based pagination
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
dateEq | string | No | Only entries on this exact date (YYYY-MM-DD) |
dateGt | string | No | Only entries after this date (YYYY-MM-DD) |
dateGe | string | No | Only entries on or after this date (YYYY-MM-DD) |
dateLt | string | No | Only entries before this date (YYYY-MM-DD) |
dateLe | string | No | Only entries on or before this date (YYYY-MM-DD) |
projectIdEq | number | No | Only entries for this project ID |
taskIdEq | number | No | Only entries for this task ID |
projectPhaseIdEq | number | No | Only entries for this project phase ID |
categoryIdEq | number | No | Only entries with this category ID |
userIdEq | number | No | Only entries belonging to this user ID |
emailIdEq | string | No | Only entries belonging to the user with this exact email |
emailIdCn | string | No | Only entries whose user email contains this text |
sourceTypeEq | string | No | Only entries with this source type (GOOGLE_CALENDAR, OUTLOOK_CALENDAR, TASK, PROJECT, PHASE, ADHOC, MILESTONE) |
activityNameEq | string | No | Only entries with this exact activity name |
activityNameCn | string | No | Only entries whose activity name contains this text |
approvalStatusEq | string | No | Only entries with this approval status (NOT_SUBMITTED, SUBMITTED, APPROVED, REJECTED) |
billableEq | boolean | No | Only billable (true) or non-billable (false) entries |
includeDeletedEq | boolean | No | Whether deleted time entries are included in the response |
submittedByEq | number | No | Only entries submitted by this user ID |
approvedByEq | number | No | Only entries approved by this user ID |
rejectedByEq | number | No | Only entries rejected by this user ID |
createdAtGt | number | No | Only entries created after this epoch-millisecond timestamp |
createdAtLt | number | No | Only entries created before this epoch-millisecond timestamp |
updatedAtGt | number | No | Only entries updated after this epoch-millisecond timestamp |
updatedAtLt | number | No | Only entries updated before this epoch-millisecond timestamp |
match | string | No | How to combine filters: all (AND, default) or any (OR) |
sortBy | string | No | Field to sort by (minutes, date, id, billable) |
sortOrder | string | No | Sort order: ASC or DESC (default DESC) |
includeFields | string | No | Comma-separated extra fields to include in the response (notes, sourceType, deleted, status, submittedBy, submittedAt, approvedBy, approvedAt, rejectedBy, rejectedAt, costRate, billRate) |
pageSize | number | No | Maximum number of entries per page (defaults to 100) |
pageToken | string | No | Page token from a previous response for fetching the next page |
| Parameter | Type | Description |
|---|
timeEntries | array | List of time entries matching the filters |
↳ timeEntryId | number | Unique identifier of the time entry |
↳ date | string | Date of the time entry (YYYY-MM-DD) |
↳ minutes | number | Duration of the time entry in minutes |
↳ activityName | string | Name of the adhoc activity, when the entry is tracked against an activity |
↳ project | object | Project associated with the time entry |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ task | object | Task associated with the time entry |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ projectPhase | object | Project phase associated with the time entry |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ billable | boolean | Whether the time entry is billable |
↳ user | object | User the time entry belongs to |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ notes | string | Notes for the time entry |
↳ category | object | Category associated with the time entry |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ sourceType | string | Source of the time entry (GOOGLE_CALENDAR, OUTLOOK_CALENDAR, TASK, PROJECT, PHASE, ADHOC, MILESTONE) |
↳ status | string | Approval status of the time entry (NOT_SUBMITTED, SUBMITTED, APPROVED, REJECTED) |
↳ createdAt | number | Creation timestamp in epoch milliseconds |
↳ updatedAt | number | Last-updated timestamp in epoch milliseconds |
↳ createdBy | object | User who created the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ submittedBy | object | User who submitted the time entry (may be null even for approved/rejected entries) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ submittedAt | number | Submission timestamp in epoch milliseconds |
↳ approvedBy | object | User who approved the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ approvedAt | number | Approval timestamp in epoch milliseconds |
↳ rejectedBy | object | User who rejected the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ rejectedAt | number | Rejection timestamp in epoch milliseconds |
↳ deleted | boolean | Whether the time entry is deleted |
↳ costRate | object | Hourly cost rate assigned to the user for this entry |
↳ billRate | object | Hourly rate billed to the customer for this entry |
↳ fields | array | Custom fields associated with the time entry |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field |
↳ fieldValueLabel | string | String representation of the field value |
pagination | object | Pagination details for the result set |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |
Search Rocketlane time entries with filters, sorting, and pagination (deprecated by Rocketlane in favor of listing time entries with filters)
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
dateEq | string | No | Only entries on this exact date (YYYY-MM-DD) |
dateGt | string | No | Only entries after this date (YYYY-MM-DD) |
dateGe | string | No | Only entries on or after this date (YYYY-MM-DD) |
dateLt | string | No | Only entries before this date (YYYY-MM-DD) |
dateLe | string | No | Only entries on or before this date (YYYY-MM-DD) |
projectEq | number | No | Only entries for this project ID |
taskEq | number | No | Only entries for this task ID |
projectPhaseIdEq | number | No | Only entries for this project phase ID |
categoryIdEq | number | No | Only entries with this category ID |
userIdEq | number | No | Only entries belonging to this user ID |
sourceTypeEq | string | No | Only entries with this source type (GOOGLE_CALENDAR, OUTLOOK_CALENDAR, TASK, PROJECT, PHASE, ADHOC, MILESTONE) |
activityNameEq | string | No | Only entries with this exact activity name |
activityNameCn | string | No | Only entries whose activity name contains this text |
approvalStatusEq | string | No | Only entries with this approval status (NOT_SUBMITTED, SUBMITTED, APPROVED, REJECTED) |
match | string | No | How to combine filters: all (AND, default) or any (OR) |
sortBy | string | No | Field to sort by (minutes, date, id, billable) |
sortOrder | string | No | Sort order: ASC or DESC (default DESC) |
includeFields | string | No | Comma-separated extra fields to include in the response (notes, sourceType, deleted, status, submittedBy, submittedAt, approvedBy, approvedAt, rejectedBy, rejectedAt, costRate, billRate) |
includeAllFields | boolean | No | Whether all fields should be returned in the response |
pageSize | number | No | Maximum number of entries per page (defaults to 100) |
pageToken | string | No | Page token from a previous response for fetching the next page |
| Parameter | Type | Description |
|---|
timeEntries | array | List of time entries matching the search filters |
↳ timeEntryId | number | Unique identifier of the time entry |
↳ date | string | Date of the time entry (YYYY-MM-DD) |
↳ minutes | number | Duration of the time entry in minutes |
↳ activityName | string | Name of the adhoc activity, when the entry is tracked against an activity |
↳ project | object | Project associated with the time entry |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ task | object | Task associated with the time entry |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ projectPhase | object | Project phase associated with the time entry |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ billable | boolean | Whether the time entry is billable |
↳ user | object | User the time entry belongs to |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ notes | string | Notes for the time entry |
↳ category | object | Category associated with the time entry |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ sourceType | string | Source of the time entry (GOOGLE_CALENDAR, OUTLOOK_CALENDAR, TASK, PROJECT, PHASE, ADHOC, MILESTONE) |
↳ status | string | Approval status of the time entry (NOT_SUBMITTED, SUBMITTED, APPROVED, REJECTED) |
↳ createdAt | number | Creation timestamp in epoch milliseconds |
↳ updatedAt | number | Last-updated timestamp in epoch milliseconds |
↳ createdBy | object | User who created the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ submittedBy | object | User who submitted the time entry (may be null even for approved/rejected entries) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ submittedAt | number | Submission timestamp in epoch milliseconds |
↳ approvedBy | object | User who approved the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ approvedAt | number | Approval timestamp in epoch milliseconds |
↳ rejectedBy | object | User who rejected the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ rejectedAt | number | Rejection timestamp in epoch milliseconds |
↳ deleted | boolean | Whether the time entry is deleted |
↳ costRate | object | Hourly cost rate assigned to the user for this entry |
↳ billRate | object | Hourly rate billed to the customer for this entry |
↳ fields | array | Custom fields associated with the time entry |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field |
↳ fieldValueLabel | string | String representation of the field value |
pagination | object | Pagination details for the result set |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |
Update a Rocketlane time entry by ID. The activityName, notes, billable, and minutes properties can be updated
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
timeEntryId | number | Yes | ID of the time entry to update |
date | string | Yes | Date of the time entry in YYYY-MM-DD format (mandatory so the total time for the date does not exceed 24 hours) |
minutes | number | Yes | Duration of the time entry in minutes (1-1440) |
activityName | string | No | New name for the adhoc activity |
notes | string | No | New notes for the time entry |
billable | boolean | No | Whether the time entry is billable |
categoryId | number | No | ID of the time entry category |
includeFields | string | No | Comma-separated extra fields to include in the response (notes, sourceType, deleted, status, submittedBy, submittedAt, approvedBy, approvedAt, rejectedBy, rejectedAt, costRate, billRate) |
includeAllFields | boolean | No | Whether all fields should be returned in the response |
| Parameter | Type | Description |
|---|
timeEntry | object | The updated time entry |
↳ timeEntryId | number | Unique identifier of the time entry |
↳ date | string | Date of the time entry (YYYY-MM-DD) |
↳ minutes | number | Duration of the time entry in minutes |
↳ activityName | string | Name of the adhoc activity, when the entry is tracked against an activity |
↳ project | object | Project associated with the time entry |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ task | object | Task associated with the time entry |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ projectPhase | object | Project phase associated with the time entry |
↳ phaseId | number | Unique identifier of the phase |
↳ phaseName | string | Name of the phase |
↳ billable | boolean | Whether the time entry is billable |
↳ user | object | User the time entry belongs to |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ notes | string | Notes for the time entry |
↳ category | object | Category associated with the time entry |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
↳ sourceType | string | Source of the time entry (GOOGLE_CALENDAR, OUTLOOK_CALENDAR, TASK, PROJECT, PHASE, ADHOC, MILESTONE) |
↳ status | string | Approval status of the time entry (NOT_SUBMITTED, SUBMITTED, APPROVED, REJECTED) |
↳ createdAt | number | Creation timestamp in epoch milliseconds |
↳ updatedAt | number | Last-updated timestamp in epoch milliseconds |
↳ createdBy | object | User who created the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | User who last updated the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ submittedBy | object | User who submitted the time entry (may be null even for approved/rejected entries) |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ submittedAt | number | Submission timestamp in epoch milliseconds |
↳ approvedBy | object | User who approved the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ approvedAt | number | Approval timestamp in epoch milliseconds |
↳ rejectedBy | object | User who rejected the time entry |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ rejectedAt | number | Rejection timestamp in epoch milliseconds |
↳ deleted | boolean | Whether the time entry is deleted |
↳ costRate | object | Hourly cost rate assigned to the user for this entry |
↳ billRate | object | Hourly rate billed to the customer for this entry |
↳ fields | array | Custom fields associated with the time entry |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field |
↳ fieldValueLabel | string | String representation of the field value |
Permanently delete a Rocketlane time entry by ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
timeEntryId | number | Yes | ID of the time entry to delete |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the time entry was deleted |
timeEntryId | number | ID of the deleted time entry |
List the time entry categories configured in Rocketlane
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
pageSize | number | No | Maximum number of categories per page (defaults to 100) |
pageToken | string | No | Page token from a previous response for fetching the next page |
| Parameter | Type | Description |
|---|
categories | array | List of time entry categories |
↳ categoryId | number | Unique identifier of the category |
↳ categoryName | string | Name of the category |
pagination | object | Pagination details for the result set |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |
Create a time-off for a team member in Rocketlane. Holidays and weekends within the date range are automatically excluded from the duration.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
userId | number | No | User ID of the team member taking the time-off (provide this or the user email) |
userEmail | string | No | Email of the team member taking the time-off (provide this or the user ID) |
startDate | string | Yes | Time-off start date in YYYY-MM-DD format |
endDate | string | Yes | Time-off end date in YYYY-MM-DD format (on or after the start date) |
type | string | Yes | Type of the time-off: FULL_DAY, HALF_DAY, or CUSTOM |
durationInMinutes | number | No | Duration in minutes per day; required when type is CUSTOM |
note | string | No | Note or comment about the time-off |
notifyProjectOwners | boolean | No | Notify project owners of projects the user is part of |
notifyUserIds | array | No | User IDs of additional users to notify about the time-off |
notifyUserEmails | array | No | Emails of additional users to notify about the time-off |
includeFields | array | No | Optional fields to include in the response: note, notifyUsers |
includeAllFields | boolean | No | Return all fields in the response |
| Parameter | Type | Description |
|---|
timeOff | object | The created time-off |
↳ timeOffId | number | Unique identifier of the time-off |
↳ user | object | The team member the time-off belongs to |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ note | string | Note or comment about the time-off |
↳ startDate | string | Time-off start date (YYYY-MM-DD) |
↳ endDate | string | Time-off end date (YYYY-MM-DD) |
↳ durationInMinutes | number | Duration in minutes per day for the time-off interval |
↳ type | string | Type of the time-off (FULL_DAY, HALF_DAY, or CUSTOM) |
↳ notifyUsers | object | Users notified about the time-off |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ createdAt | number | Timestamp when the time-off was created (epoch milliseconds) |
↳ createdBy | object | The team member who created the time-off |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
Retrieve a Rocketlane time-off by its ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
timeOffId | number | Yes | Unique identifier of the time-off |
includeFields | array | No | Optional fields to include in the response: note, notifyUsers |
includeAllFields | boolean | No | Return all fields in the response |
| Parameter | Type | Description |
|---|
timeOff | object | The requested time-off |
↳ timeOffId | number | Unique identifier of the time-off |
↳ user | object | The team member the time-off belongs to |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ note | string | Note or comment about the time-off |
↳ startDate | string | Time-off start date (YYYY-MM-DD) |
↳ endDate | string | Time-off end date (YYYY-MM-DD) |
↳ durationInMinutes | number | Duration in minutes per day for the time-off interval |
↳ type | string | Type of the time-off (FULL_DAY, HALF_DAY, or CUSTOM) |
↳ notifyUsers | object | Users notified about the time-off |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ createdAt | number | Timestamp when the time-off was created (epoch milliseconds) |
↳ createdBy | object | The team member who created the time-off |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
List time-offs in Rocketlane with optional date, type, and user filters, sorting, and pagination
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
pageSize | number | No | Maximum number of time-offs per page (defaults to 100) |
pageToken | string | No | Page token from a previous response (valid for 15 minutes) |
includeFields | array | No | Optional fields to include in the response: note, notifyUsers |
includeAllFields | boolean | No | Return all fields in the response |
sortBy | string | No | Field to sort by: startDate, endDate, or createdAt |
sortOrder | string | No | Sort order: ASC or DESC (defaults to DESC) |
match | string | No | Combine filters with AND (all) or OR (any); defaults to all |
startDateGt | string | No | Return time-offs with start dates greater than this date (YYYY-MM-DD) |
startDateEq | string | No | Return time-offs with start dates equal to this date (YYYY-MM-DD) |
startDateLt | string | No | Return time-offs with start dates lesser than this date (YYYY-MM-DD) |
startDateGe | string | No | Return time-offs with start dates greater than or equal to this date (YYYY-MM-DD) |
startDateLe | string | No | Return time-offs with start dates lesser than or equal to this date (YYYY-MM-DD) |
endDateGt | string | No | Return time-offs with end dates greater than this date (YYYY-MM-DD) |
endDateEq | string | No | Return time-offs with end dates equal to this date (YYYY-MM-DD) |
endDateLt | string | No | Return time-offs with end dates lesser than this date (YYYY-MM-DD) |
endDateGe | string | No | Return time-offs with end dates greater than or equal to this date (YYYY-MM-DD) |
endDateLe | string | No | Return time-offs with end dates lesser than or equal to this date (YYYY-MM-DD) |
typeEq | string | No | Return time-offs matching this type: FULL_DAY, HALF_DAY, or CUSTOM |
typeOneOf | string | No | Comma-separated time-off types to match any of (FULL_DAY, HALF_DAY, CUSTOM) |
typeNoneOf | string | No | Comma-separated time-off types to match none of (FULL_DAY, HALF_DAY, CUSTOM) |
userIdEq | string | No | Return time-offs that exactly match this user ID |
userIdOneOf | string | No | Comma-separated user IDs to match any of |
userIdNoneOf | string | No | Comma-separated user IDs to match none of |
emailIdEq | string | No | Return time-offs that exactly match this user email |
emailIdOneOf | string | No | Comma-separated user emails to match any of |
emailIdNoneOf | string | No | Comma-separated user emails to match none of |
| Parameter | Type | Description |
|---|
timeOffs | array | List of time-offs |
↳ timeOffId | number | Unique identifier of the time-off |
↳ user | object | The team member the time-off belongs to |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ note | string | Note or comment about the time-off |
↳ startDate | string | Time-off start date (YYYY-MM-DD) |
↳ endDate | string | Time-off end date (YYYY-MM-DD) |
↳ durationInMinutes | number | Duration in minutes per day for the time-off interval |
↳ type | string | Type of the time-off (FULL_DAY, HALF_DAY, or CUSTOM) |
↳ notifyUsers | object | Users notified about the time-off |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ createdAt | number | Timestamp when the time-off was created (epoch milliseconds) |
↳ createdBy | object | The team member who created the time-off |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
pagination | object | Pagination details for the result set |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |
Permanently delete a Rocketlane time-off by its ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
timeOffId | number | Yes | Unique identifier of the time-off to delete |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the time-off was deleted |
timeOffId | number | ID of the deleted time-off |
Retrieve a Rocketlane user by their ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
userId | number | Yes | ID of the user to retrieve |
includeFields | string | No | Comma-separated extra fields to include: role, company, permission, holidayCalendar, capacityInMinutes, profilePictureUrl |
includeAllFields | boolean | No | Whether to include all fields in the response |
| Parameter | Type | Description |
|---|
user | object | The requested user |
↳ userId | number | Unique identifier of the user |
↳ email | string | Email address of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ type | string | Type of the user (TEAM_MEMBER, PARTNER, CUSTOMER, or EXTERNAL_PARTNER) |
↳ status | string | Status of the user (INACTIVE, INVITED, ACTIVE, or PASSIVE) |
↳ role | object | Role of the user |
↳ roleId | number | Unique identifier of the role |
↳ roleName | string | Name of the role |
↳ company | object | Company of the user |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ permission | object | Permission of the user |
↳ permissionId | number | Unique identifier of the permission |
↳ permissionName | string | Name of the permission |
↳ fields | array | Custom user field values |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Name of the custom user field |
↳ fieldValue | string | Value of the custom user field |
↳ fieldValueLabel | string | String representation of the field value |
↳ capacityInMinutes | number | Capacity of the user in minutes |
↳ holidayCalendar | object | Holiday calendar of the user |
↳ calenderId | number | Unique identifier of the holiday calendar |
↳ calenderName | string | Name of the holiday calendar |
↳ profilePictureUrl | string | URL of the user's profile picture |
↳ createdAt | number | Timestamp when the user was created (epoch millis) |
↳ createdBy | object | Team member who created the user |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedAt | number | Timestamp when the user was last updated (epoch millis) |
↳ updatedBy | object | Team member who last updated the user |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
List users in your Rocketlane account, with optional filters, sorting, and pagination
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
pageSize | number | No | Maximum number of users per page (defaults to 100) |
pageToken | string | No | Page token from a previous request (valid for 15 minutes) |
includeFields | string | No | Comma-separated extra fields to include: role, company, permission, holidayCalendar, capacityInMinutes, profilePictureUrl |
includeAllFields | boolean | No | Whether to include all fields in the response |
sortBy | string | No | Field to sort by: email, firstName, lastName, type, status, or capacityInMinutes |
sortOrder | string | No | Sort order: ASC or DESC (defaults to DESC) |
match | string | No | How to combine filters: all (AND) or any (OR); defaults to all |
firstNameEq | string | No | Only include users whose first name exactly matches this value |
firstNameCn | string | No | Only include users whose first name contains this value |
firstNameNc | string | No | Exclude users whose first name contains this value |
lastNameEq | string | No | Only include users whose last name exactly matches this value |
lastNameCn | string | No | Only include users whose last name contains this value |
lastNameNc | string | No | Exclude users whose last name contains this value |
emailEq | string | No | Only include users whose email exactly matches this value |
emailCn | string | No | Only include users whose email contains this value |
emailNc | string | No | Exclude users whose email contains this value |
statusEq | string | No | Only include users with this status: INACTIVE, INVITED, ACTIVE, or PASSIVE |
statusOneOf | string | No | Comma-separated statuses; only include users matching one of them (INACTIVE, INVITED, ACTIVE, PASSIVE) |
statusNoneOf | string | No | Comma-separated statuses; exclude users matching any of them (INACTIVE, INVITED, ACTIVE, PASSIVE) |
typeEq | string | No | Only include users of this type: TEAM_MEMBER, PARTNER, CUSTOMER, or EXTERNAL_PARTNER |
typeOneOf | string | No | Comma-separated types; only include users matching one of them (TEAM_MEMBER, PARTNER, CUSTOMER, EXTERNAL_PARTNER) |
roleIdEq | string | No | Only include users with this role ID |
roleIdOneOf | string | No | Comma-separated role IDs; only include users matching one of them |
roleIdNoneOf | string | No | Comma-separated role IDs; exclude users matching any of them |
permissionIdEq | string | No | Only include users with this permission ID |
permissionIdOneOf | string | No | Comma-separated permission IDs; only include users matching one of them |
permissionIdNoneOf | string | No | Comma-separated permission IDs; exclude users matching any of them |
capacityInMinutesEq | number | No | Only include users whose capacity in minutes equals this value |
capacityInMinutesGt | number | No | Only include users whose capacity in minutes is greater than this value |
capacityInMinutesGe | number | No | Only include users whose capacity in minutes is greater than or equal to this value |
capacityInMinutesLt | number | No | Only include users whose capacity in minutes is less than this value |
capacityInMinutesLe | number | No | Only include users whose capacity in minutes is less than or equal to this value |
createdAtGt | number | No | Only include users created after this time (epoch millis) |
createdAtEq | number | No | Only include users created at exactly this time (epoch millis) |
createdAtLt | number | No | Only include users created before this time (epoch millis) |
createdAtGe | number | No | Only include users created at or after this time (epoch millis) |
createdAtLe | number | No | Only include users created at or before this time (epoch millis) |
updatedAtGt | number | No | Only include users updated after this time (epoch millis) |
updatedAtEq | number | No | Only include users updated at exactly this time (epoch millis) |
updatedAtLt | number | No | Only include users updated before this time (epoch millis) |
updatedAtGe | number | No | Only include users updated at or after this time (epoch millis) |
updatedAtLe | number | No | Only include users updated at or before this time (epoch millis) |
| Parameter | Type | Description |
|---|
users | array | List of users |
↳ userId | number | Unique identifier of the user |
↳ email | string | Email address of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ type | string | Type of the user (TEAM_MEMBER, PARTNER, CUSTOMER, or EXTERNAL_PARTNER) |
↳ status | string | Status of the user (INACTIVE, INVITED, ACTIVE, or PASSIVE) |
↳ role | object | Role of the user |
↳ roleId | number | Unique identifier of the role |
↳ roleName | string | Name of the role |
↳ company | object | Company of the user |
↳ companyId | number | Unique identifier of the company |
↳ companyName | string | Name of the company |
↳ permission | object | Permission of the user |
↳ permissionId | number | Unique identifier of the permission |
↳ permissionName | string | Name of the permission |
↳ fields | array | Custom user field values |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Name of the custom user field |
↳ fieldValue | string | Value of the custom user field |
↳ fieldValueLabel | string | String representation of the field value |
↳ capacityInMinutes | number | Capacity of the user in minutes |
↳ holidayCalendar | object | Holiday calendar of the user |
↳ calenderId | number | Unique identifier of the holiday calendar |
↳ calenderName | string | Name of the holiday calendar |
↳ profilePictureUrl | string | URL of the user's profile picture |
↳ createdAt | number | Timestamp when the user was created (epoch millis) |
↳ createdBy | object | Team member who created the user |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedAt | number | Timestamp when the user was last updated (epoch millis) |
↳ updatedBy | object | Team member who last updated the user |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
pagination | object | Pagination details |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |
Create a new space in a Rocketlane project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
projectId | number | Yes | ID of the project the space belongs to |
spaceName | string | Yes | Name of the space |
private | boolean | No | Whether the space is private or shared (defaults to false) |
| Parameter | Type | Description |
|---|
space | object | The created space |
↳ spaceId | number | Unique identifier of the space |
↳ spaceName | string | Name of the space |
↳ project | object | Project the space belongs to |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ createdAt | number | Timestamp when the space was created (epoch millis) |
↳ createdBy | object | Team member who created the space |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedAt | number | Timestamp when the space was last updated (epoch millis) |
↳ updatedBy | object | Team member who last updated the space |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ private | boolean | Whether the space is private or shared |
Retrieve a Rocketlane space by its ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
spaceId | number | Yes | ID of the space to retrieve |
| Parameter | Type | Description |
|---|
space | object | The requested space |
↳ spaceId | number | Unique identifier of the space |
↳ spaceName | string | Name of the space |
↳ project | object | Project the space belongs to |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ createdAt | number | Timestamp when the space was created (epoch millis) |
↳ createdBy | object | Team member who created the space |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedAt | number | Timestamp when the space was last updated (epoch millis) |
↳ updatedBy | object | Team member who last updated the space |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ private | boolean | Whether the space is private or shared |
List spaces in a Rocketlane project, with optional filters, sorting, and pagination
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
projectId | number | Yes | ID of the project whose spaces to list |
pageSize | number | No | Maximum number of spaces per page (defaults to 100) |
pageToken | string | No | Page token from a previous request (valid for 15 minutes) |
sortBy | string | No | Field to sort by (spaceName) |
sortOrder | string | No | Sort order: ASC or DESC (defaults to DESC) |
match | string | No | How to combine filters: all (AND) or any (OR); defaults to all |
spaceNameEq | string | No | Only include spaces whose name exactly matches this value |
spaceNameCn | string | No | Only include spaces whose name contains this value |
spaceNameNc | string | No | Exclude spaces whose name contains this value |
createdAtGt | number | No | Only include spaces created after this time (epoch millis) |
createdAtEq | number | No | Only include spaces created at exactly this time (epoch millis) |
createdAtLt | number | No | Only include spaces created before this time (epoch millis) |
createdAtGe | number | No | Only include spaces created at or after this time (epoch millis) |
createdAtLe | number | No | Only include spaces created at or before this time (epoch millis) |
updatedAtGt | number | No | Only include spaces updated after this time (epoch millis) |
updatedAtEq | number | No | Only include spaces updated at exactly this time (epoch millis) |
updatedAtLt | number | No | Only include spaces updated before this time (epoch millis) |
updatedAtGe | number | No | Only include spaces updated at or after this time (epoch millis) |
updatedAtLe | number | No | Only include spaces updated at or before this time (epoch millis) |
| Parameter | Type | Description |
|---|
spaces | array | List of spaces |
↳ spaceId | number | Unique identifier of the space |
↳ spaceName | string | Name of the space |
↳ project | object | Project the space belongs to |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ createdAt | number | Timestamp when the space was created (epoch millis) |
↳ createdBy | object | Team member who created the space |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedAt | number | Timestamp when the space was last updated (epoch millis) |
↳ updatedBy | object | Team member who last updated the space |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ private | boolean | Whether the space is private or shared |
pagination | object | Pagination details |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |
Update a Rocketlane space by its ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
spaceId | number | Yes | ID of the space to update |
spaceName | string | No | New name of the space |
| Parameter | Type | Description |
|---|
space | object | The updated space |
↳ spaceId | number | Unique identifier of the space |
↳ spaceName | string | Name of the space |
↳ project | object | Project the space belongs to |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ createdAt | number | Timestamp when the space was created (epoch millis) |
↳ createdBy | object | Team member who created the space |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedAt | number | Timestamp when the space was last updated (epoch millis) |
↳ updatedBy | object | Team member who last updated the space |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ private | boolean | Whether the space is private or shared |
Permanently delete a Rocketlane space by its ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
spaceId | number | Yes | ID of the space to delete |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the space was deleted |
spaceId | number | ID of the deleted space |
Create a new space document in a Rocketlane space
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
spaceId | number | Yes | ID of the space the document belongs to |
spaceDocumentType | string | Yes | Type of the space document: ROCKETLANE_DOCUMENT or EMBEDDED_DOCUMENT |
spaceDocumentName | string | No | Name of the space document (defaults to Untitled) |
url | string | No | URL to embed in the space document (for embedded documents) |
templateId | number | No | ID of the document template to create the document from |
| Parameter | Type | Description |
|---|
spaceDocument | object | The created space document |
↳ spaceDocumentId | number | Unique identifier of the space document |
↳ spaceDocumentName | string | Name of the space document |
↳ space | object | Space the document belongs to |
↳ spaceId | number | Unique identifier of the space |
↳ spaceName | string | Name of the space |
↳ spaceDocumentType | string | Type of the space document (ROCKETLANE_DOCUMENT or EMBEDDED_DOCUMENT) |
↳ url | string | URL embedded in the space document |
↳ source | object | Document template the space document was created from |
↳ templateId | number | Unique identifier of the template |
↳ templateName | string | Name of the template |
↳ createdAt | number | Timestamp when the space document was created (epoch millis) |
↳ createdBy | object | Team member who created the space document |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedAt | number | Timestamp when the space document was last updated (epoch millis) |
↳ updatedBy | object | Team member who last updated the space document |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ private | boolean | Whether the space document is private or shared |
Retrieve a Rocketlane space document by its ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
spaceDocumentId | number | Yes | ID of the space document to retrieve |
| Parameter | Type | Description |
|---|
spaceDocument | object | The requested space document |
↳ spaceDocumentId | number | Unique identifier of the space document |
↳ spaceDocumentName | string | Name of the space document |
↳ space | object | Space the document belongs to |
↳ spaceId | number | Unique identifier of the space |
↳ spaceName | string | Name of the space |
↳ spaceDocumentType | string | Type of the space document (ROCKETLANE_DOCUMENT or EMBEDDED_DOCUMENT) |
↳ url | string | URL embedded in the space document |
↳ source | object | Document template the space document was created from |
↳ templateId | number | Unique identifier of the template |
↳ templateName | string | Name of the template |
↳ createdAt | number | Timestamp when the space document was created (epoch millis) |
↳ createdBy | object | Team member who created the space document |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedAt | number | Timestamp when the space document was last updated (epoch millis) |
↳ updatedBy | object | Team member who last updated the space document |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ private | boolean | Whether the space document is private or shared |
List space documents in a Rocketlane project, with optional filters, sorting, and pagination
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
projectId | number | Yes | ID of the project whose space documents to list |
pageSize | number | No | Maximum number of space documents per page (defaults to 100) |
pageToken | string | No | Page token from a previous request (valid for 15 minutes) |
sortBy | string | No | Field to sort by (spaceTabName) |
sortOrder | string | No | Sort order: ASC or DESC (defaults to DESC) |
match | string | No | How to combine filters: all (AND) or any (OR); defaults to all |
spaceDocumentNameEq | string | No | Only include space documents whose name exactly matches this value |
spaceDocumentNameCn | string | No | Only include space documents whose name contains this value |
spaceDocumentNameNc | string | No | Exclude space documents whose name contains this value |
spaceIdEq | number | No | Only include space documents in the space with this ID |
createdAtGt | number | No | Only include space documents created after this time (epoch millis) |
createdAtEq | number | No | Only include space documents created at exactly this time (epoch millis) |
createdAtLt | number | No | Only include space documents created before this time (epoch millis) |
createdAtGe | number | No | Only include space documents created at or after this time (epoch millis) |
createdAtLe | number | No | Only include space documents created at or before this time (epoch millis) |
updatedAtGt | number | No | Only include space documents updated after this time (epoch millis) |
updatedAtEq | number | No | Only include space documents updated at exactly this time (epoch millis) |
updatedAtLt | number | No | Only include space documents updated before this time (epoch millis) |
updatedAtGe | number | No | Only include space documents updated at or after this time (epoch millis) |
updatedAtLe | number | No | Only include space documents updated at or before this time (epoch millis) |
| Parameter | Type | Description |
|---|
spaceDocuments | array | List of space documents |
↳ spaceDocumentId | number | Unique identifier of the space document |
↳ spaceDocumentName | string | Name of the space document |
↳ space | object | Space the document belongs to |
↳ spaceId | number | Unique identifier of the space |
↳ spaceName | string | Name of the space |
↳ spaceDocumentType | string | Type of the space document (ROCKETLANE_DOCUMENT or EMBEDDED_DOCUMENT) |
↳ url | string | URL embedded in the space document |
↳ source | object | Document template the space document was created from |
↳ templateId | number | Unique identifier of the template |
↳ templateName | string | Name of the template |
↳ createdAt | number | Timestamp when the space document was created (epoch millis) |
↳ createdBy | object | Team member who created the space document |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedAt | number | Timestamp when the space document was last updated (epoch millis) |
↳ updatedBy | object | Team member who last updated the space document |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ private | boolean | Whether the space document is private or shared |
pagination | object | Pagination details |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |
Update a Rocketlane space document by its ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
spaceDocumentId | number | Yes | ID of the space document to update |
spaceDocumentName | string | No | New name of the space document |
url | string | No | New URL to embed in the space document (for embedded documents) |
| Parameter | Type | Description |
|---|
spaceDocument | object | The updated space document |
↳ spaceDocumentId | number | Unique identifier of the space document |
↳ spaceDocumentName | string | Name of the space document |
↳ space | object | Space the document belongs to |
↳ spaceId | number | Unique identifier of the space |
↳ spaceName | string | Name of the space |
↳ spaceDocumentType | string | Type of the space document (ROCKETLANE_DOCUMENT or EMBEDDED_DOCUMENT) |
↳ url | string | URL embedded in the space document |
↳ source | object | Document template the space document was created from |
↳ templateId | number | Unique identifier of the template |
↳ templateName | string | Name of the template |
↳ createdAt | number | Timestamp when the space document was created (epoch millis) |
↳ createdBy | object | Team member who created the space document |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedAt | number | Timestamp when the space document was last updated (epoch millis) |
↳ updatedBy | object | Team member who last updated the space document |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ private | boolean | Whether the space document is private or shared |
Permanently delete a Rocketlane space document by its ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
spaceDocumentId | number | Yes | ID of the space document to delete |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the space document was deleted |
spaceDocumentId | number | ID of the deleted space document |
List resource allocations in Rocketlane within a date range, with optional member, project, and placeholder filters, sorting, and pagination
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
startDate | string | Yes | Return allocations that start on or after this date (YYYY-MM-DD) |
endDate | string | Yes | Return allocations that end on or before this date (YYYY-MM-DD) |
pageSize | number | No | Maximum number of allocations per page (defaults to 100) |
pageToken | string | No | Page token from a previous response (valid for 15 minutes) |
includeFields | array | No | Optional fields to include in the response: member, task, placeholder, duration |
includeAllFields | boolean | No | Return all fields in the response |
sortBy | string | No | Field to sort by: startDate, endDate, allocationType, or allocationFor |
sortOrder | string | No | Sort order: ASC or DESC (defaults to DESC) |
match | string | No | Combine filters with AND (all) or OR (any); defaults to all |
memberIdEq | string | No | Return allocations that exactly match this member ID |
memberIdOneOf | string | No | Comma-separated member IDs to match any of |
memberIdNoneOf | string | No | Comma-separated member IDs to exclude |
projectIdEq | string | No | Return allocations that exactly match this project ID |
projectIdOneOf | string | No | Comma-separated project IDs to match any of |
projectIdNoneOf | string | No | Comma-separated project IDs to exclude |
placeholderIdEq | string | No | Return allocations that exactly match this placeholder ID |
placeholderIdOneOf | string | No | Comma-separated placeholder IDs to match any of |
placeholderIdNoneOf | string | No | Comma-separated placeholder IDs to exclude |
| Parameter | Type | Description |
|---|
allocations | array | List of resource allocations |
↳ startDate | string | Allocation start date (YYYY-MM-DD) |
↳ endDate | string | Allocation end date (YYYY-MM-DD) |
↳ secondsPerDay | number | Allocated seconds per day |
↳ minutesPerDay | number | Allocated minutes per day |
↳ hoursPerDay | number | Allocated hours per day |
↳ duration | object | Total allocation duration between the start and end dates |
↳ daysConsider | number | Number of week days considered for the duration computation |
↳ seconds | number | Total allocation seconds |
↳ minutes | number | Total allocation minutes |
↳ hours | number | Total allocation hours |
↳ allocationType | string | Type of allocation (SOFT or HARD) |
↳ allocationFor | string | Who the allocation is for (TEAM_MEMBER or PLACEHOLDER) |
↳ project | object | The project associated with the allocation |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ tasks | array | Tasks associated with the allocation |
↳ taskId | number | Unique identifier of the task |
↳ taskName | string | Name of the task |
↳ member | object | The team member allocated when allocationFor is TEAM_MEMBER |
↳ placeholder | object | The placeholder allocated when allocationFor is PLACEHOLDER |
↳ createdAt | number | Timestamp when the allocation was created (epoch milliseconds) |
↳ updatedAt | number | Timestamp when the allocation was last updated (epoch milliseconds) |
↳ createdBy | object | The team member who created the allocation |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | The team member who last updated the allocation |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
pagination | object | Pagination details for the result set |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |
Retrieve a Rocketlane invoice by its ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
invoiceId | number | Yes | Unique identifier of the invoice |
includeFields | array | No | Optional fields to include in the response: notes, attachments |
includeAllFields | boolean | No | Return all fields in the response |
| Parameter | Type | Description |
|---|
invoice | object | The requested invoice |
↳ invoiceId | number | Unique identifier of the invoice |
↳ invoiceNumber | string | Invoice number assigned to this invoice |
↳ dateOfIssue | string | Date when the invoice was issued (YYYY-MM-DD) |
↳ dueDate | string | Due date for the invoice payment (YYYY-MM-DD) |
↳ currency | string | Currency of the invoice amount (e.g. USD) |
↳ status | string | Current status of the invoice |
↳ amount | number | Total amount of the invoice including tax |
↳ tax | number | Tax amount applied to the invoice |
↳ subTotal | number | Total amount of the invoice excluding tax |
↳ amountOutstanding | number | Balance amount remaining to be paid |
↳ amountPaid | number | Total amount paid for this invoice |
↳ amountWrittenOff | number | Total amount written off for this invoice |
↳ notes | string | Notes or additional information about the invoice |
↳ createdAt | number | Timestamp when the invoice was created (epoch milliseconds) |
↳ updatedAt | number | Timestamp when the invoice was last updated (epoch milliseconds) |
↳ createdBy | object | The team member who created the invoice |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | The team member who last updated the invoice |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ company | object | Customer company details for the invoice |
↳ companyId | number | Unique identifier of the customer company |
↳ companyName | string | Name of the customer company |
↳ companyUrl | string | URL of the customer company website |
↳ projects | array | Projects mapped to this invoice |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ fields | array | Custom invoice fields with their values |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field (string, number, or array depending on field type) |
↳ fieldValueLabel | string | String representation of the field value |
↳ attachments | array | Attachments associated with the invoice |
↳ attachmentId | number | Unique identifier of the attachment |
↳ attachmentName | string | Name of the attachment |
↳ createdAt | number | Timestamp when the attachment was created (epoch milliseconds) |
↳ location | string | URL of the attachment |
↳ thumbLocation | string | Thumbnail URL of the attachment |
↳ visibility | boolean | Visibility of the attachment |
Search invoices in Rocketlane with date, amount, company, invoice-number, and status filters, sorting, and pagination
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
pageSize | number | No | Maximum number of invoices per page (defaults to 100) |
pageToken | string | No | Page token from a previous response (valid for 15 minutes) |
includeFields | array | No | Optional fields to include in the response: notes, attachments |
includeAllFields | boolean | No | Return all fields in the response |
sortBy | string | No | Field to sort by: createdAt or invoiceNumber |
sortOrder | string | No | Sort order: ASC or DESC (defaults to DESC) |
match | string | No | Combine filters with AND (all) or OR (any); defaults to all |
dateOfIssueEq | string | No | Filter by date of issue equal to this date (YYYY-MM-DD) |
dateOfIssueGt | string | No | Filter by date of issue greater than this date (YYYY-MM-DD) |
dateOfIssueGe | string | No | Filter by date of issue greater than or equal to this date (YYYY-MM-DD) |
dateOfIssueLt | string | No | Filter by date of issue less than this date (YYYY-MM-DD) |
dateOfIssueLe | string | No | Filter by date of issue less than or equal to this date (YYYY-MM-DD) |
dueDateEq | string | No | Filter by due date equal to this date (YYYY-MM-DD) |
dueDateGt | string | No | Filter by due date greater than this date (YYYY-MM-DD) |
dueDateGe | string | No | Filter by due date greater than or equal to this date (YYYY-MM-DD) |
dueDateLt | string | No | Filter by due date less than this date (YYYY-MM-DD) |
dueDateLe | string | No | Filter by due date less than or equal to this date (YYYY-MM-DD) |
amountEq | number | No | Filter by total amount equal to this value |
amountGt | number | No | Filter by total amount greater than this value |
amountGe | number | No | Filter by total amount greater than or equal to this value |
amountLt | number | No | Filter by total amount less than this value |
amountLe | number | No | Filter by total amount less than or equal to this value |
amountOutstandingEq | number | No | Filter by amount outstanding equal to this value |
amountOutstandingGt | number | No | Filter by amount outstanding greater than this value |
amountOutstandingGe | number | No | Filter by amount outstanding greater than or equal to this value |
amountOutstandingLt | number | No | Filter by amount outstanding less than this value |
amountOutstandingLe | number | No | Filter by amount outstanding less than or equal to this value |
amountPaidEq | number | No | Filter by amount paid equal to this value |
amountPaidGt | number | No | Filter by amount paid greater than this value |
amountPaidGe | number | No | Filter by amount paid greater than or equal to this value |
amountPaidLt | number | No | Filter by amount paid less than this value |
amountPaidLe | number | No | Filter by amount paid less than or equal to this value |
amountWrittenOffEq | number | No | Filter by amount written off equal to this value |
amountWrittenOffGt | number | No | Filter by amount written off greater than this value |
amountWrittenOffGe | number | No | Filter by amount written off greater than or equal to this value |
amountWrittenOffLt | number | No | Filter by amount written off less than this value |
amountWrittenOffLe | number | No | Filter by amount written off less than or equal to this value |
createdAtEq | number | No | Filter by created timestamp equal to this value (epoch milliseconds) |
createdAtGt | number | No | Filter by created timestamp greater than this value (epoch milliseconds) |
createdAtGe | number | No | Filter by created timestamp greater than or equal to this value (epoch milliseconds) |
createdAtLt | number | No | Filter by created timestamp less than this value (epoch milliseconds) |
createdAtLe | number | No | Filter by created timestamp less than or equal to this value (epoch milliseconds) |
companyIdEq | string | No | Return invoices that exactly match this customer company ID |
companyIdOneOf | string | No | Comma-separated customer company IDs to match any of |
companyIdNoneOf | string | No | Comma-separated customer company IDs to match none of |
invoiceNumberEq | string | No | Return invoices whose invoice number equals this value |
invoiceNumberCn | string | No | Return invoices whose invoice number contains this text |
invoiceNumberNc | string | No | Return invoices whose invoice number does not contain this text |
statusEq | string | No | Return invoices that equal this status (e.g. DRAFT) |
statusOneOf | string | No | Comma-separated statuses to match any of (e.g. DRAFT,PAID) |
statusNoneOf | string | No | Comma-separated statuses to match none of (e.g. DRAFT,PAID) |
| Parameter | Type | Description |
|---|
invoices | array | List of invoices |
↳ invoiceId | number | Unique identifier of the invoice |
↳ invoiceNumber | string | Invoice number assigned to this invoice |
↳ dateOfIssue | string | Date when the invoice was issued (YYYY-MM-DD) |
↳ dueDate | string | Due date for the invoice payment (YYYY-MM-DD) |
↳ currency | string | Currency of the invoice amount (e.g. USD) |
↳ status | string | Current status of the invoice |
↳ amount | number | Total amount of the invoice including tax |
↳ tax | number | Tax amount applied to the invoice |
↳ subTotal | number | Total amount of the invoice excluding tax |
↳ amountOutstanding | number | Balance amount remaining to be paid |
↳ amountPaid | number | Total amount paid for this invoice |
↳ amountWrittenOff | number | Total amount written off for this invoice |
↳ notes | string | Notes or additional information about the invoice |
↳ createdAt | number | Timestamp when the invoice was created (epoch milliseconds) |
↳ updatedAt | number | Timestamp when the invoice was last updated (epoch milliseconds) |
↳ createdBy | object | The team member who created the invoice |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ updatedBy | object | The team member who last updated the invoice |
↳ userId | number | Unique identifier of the user |
↳ firstName | string | First name of the user |
↳ lastName | string | Last name of the user |
↳ emailId | string | Email address of the user |
↳ company | object | Customer company details for the invoice |
↳ companyId | number | Unique identifier of the customer company |
↳ companyName | string | Name of the customer company |
↳ companyUrl | string | URL of the customer company website |
↳ projects | array | Projects mapped to this invoice |
↳ projectId | number | Unique identifier of the project |
↳ projectName | string | Name of the project |
↳ fields | array | Custom invoice fields with their values |
↳ fieldId | number | Unique identifier of the field |
↳ fieldLabel | string | Label of the field |
↳ fieldValue | json | Value of the field (string, number, or array depending on field type) |
↳ fieldValueLabel | string | String representation of the field value |
↳ attachments | array | Attachments associated with the invoice |
↳ attachmentId | number | Unique identifier of the attachment |
↳ attachmentName | string | Name of the attachment |
↳ createdAt | number | Timestamp when the attachment was created (epoch milliseconds) |
↳ location | string | URL of the attachment |
↳ thumbLocation | string | Thumbnail URL of the attachment |
↳ visibility | boolean | Visibility of the attachment |
pagination | object | Pagination details for the result set |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |
List line items of a Rocketlane invoice
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
invoiceId | number | Yes | Unique identifier of the invoice |
pageSize | number | No | Maximum number of line items per page (defaults to 100) |
pageToken | string | No | Page token from a previous response (valid for 15 minutes) |
| Parameter | Type | Description |
|---|
lineItems | array | List of invoice line items |
↳ invoiceLineItemId | number | Unique identifier of the invoice line item |
↳ description | string | Description of the line item or service provided |
↳ quantity | number | Quantity of the item or service |
↳ unitPrice | number | Unit price for the item or service |
↳ amount | number | Total amount for this line item (quantity times unit price) |
↳ sourceId | number | Unique identifier of the source entity (e.g. project ID) |
↳ sourceType | string | Type of source entity this line item is associated with (e.g. PROJECT) |
↳ taxCode | object | Tax code information for this line item |
↳ taxCodeId | number | Unique identifier of the tax code |
↳ taxCodeName | string | Name of the tax code |
↳ taxCodeRate | number | Tax rate percentage for the tax code |
↳ taxCodeAmount | number | Tax amount calculated for this tax code |
↳ taxComponents | array | Tax components that make up the tax code |
↳ taxComponentId | number | Unique identifier of the tax component |
↳ taxComponentName | string | Name of the tax component |
↳ taxComponentRate | number | Tax rate percentage for the tax component |
↳ taxComponentAmount | number | Tax amount calculated for this tax component |
↳ taxComponentType | string | Type of the tax component (e.g. GST, VAT) |
pagination | object | Pagination details for the result set |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |
List payments recorded against a Rocketlane invoice
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rocketlane API key |
invoiceId | number | Yes | Unique identifier of the invoice |
pageSize | number | No | Maximum number of payments per page (defaults to 100) |
pageToken | string | No | Page token from a previous response (valid for 15 minutes) |
| Parameter | Type | Description |
|---|
payments | array | List of payments recorded against the invoice |
↳ paymentId | number | Unique identifier of the payment record |
↳ paymentRecordType | string | Type of the payment record (PAID or WRITE_OFF) |
↳ currency | string | Currency of the payment amount (e.g. USD) |
↳ paymentDate | string | Date when the payment was made (YYYY-MM-DD) |
↳ amount | number | Amount of the payment |
↳ notes | string | Additional notes or comments regarding the payment |
pagination | object | Pagination details for the result set |
↳ pageSize | number | Page size used for the current request |
↳ hasMore | boolean | Whether more results are available |
↳ totalRecordCount | number | Total number of records matching the request |
↳ nextPageToken | string | Token for fetching the next page (valid for 15 minutes) |