# Agile Tools Docs

> User documentation for Agile Tools, the ultimate platform for OKRs and work management.

- [Welcome to Agile Tools](https://docs.agile-tools.io/en/docs/welcome.md): The platform for Goal and Work management
- [Why Agile Tools?](https://docs.agile-tools.io/en/docs/why-agile-tools.md): We believe people come first - as team players.
- [Benefits](https://docs.agile-tools.io/en/docs/benefits.md)
- [Overview](https://docs.agile-tools.io/en/docs/key-concepts/overview.md): We believe tools should not drive you but the other way around.
- [Three Pillars](https://docs.agile-tools.io/en/docs/key-concepts/three-pillars.md): Set goals to build great products with your cross-functional teams.
- [Value Journey](https://docs.agile-tools.io/en/docs/key-concepts/value-journey.md): Create a transparent value stream directly to your customers.
- [Organization](https://docs.agile-tools.io/en/docs/key-concepts/organization.md): Make it visible where value is generated.
- [Structure](https://docs.agile-tools.io/en/docs/key-concepts/structure.md): Create a tangible link between daily work and your mission.
- [Security](https://docs.agile-tools.io/en/docs/security.md): We are committed to securing your strategy.
- [OKR Goal Management](https://docs.agile-tools.io/en/docs/features/okr-management.md): A goal is a more general term but is used synonymously with the OKR acronym in Agile Tools.
- [Work Management](https://docs.agile-tools.io/en/docs/features/work-management.md): You will work with Value Items, not Issues.
- [Organization Management](https://docs.agile-tools.io/en/docs/features/organization-management.md): Configure your platform with users, teams, organizational units, and value units to support your OKR journey.
- [OKR Basics](https://docs.agile-tools.io/en/docs/resources/okr-basics.md): Introduction to Objectives and Key Results methodology
- [OKR Guide](https://docs.agile-tools.io/en/docs/resources/okr-guide.md): A comprehensive guide to understanding and implementing OKRs (Objectives and Key Results) in your organization.
- [Evidence-Based Management](https://docs.agile-tools.io/en/docs/resources/ebm-basics/evidence-based-management.md): Learn about Evidence-Based Management (EBM) and its four Key Value Areas for measuring organizational value delivery.
- [Current Value](https://docs.agile-tools.io/en/docs/resources/ebm-basics/current-value.md): Reveals the value that the product delivers to customers, today.
- [Ability to Innovate](https://docs.agile-tools.io/en/docs/resources/ebm-basics/ability-to-innovate.md): Expresses the ability of a product development organization to deliver new capabilities that might better meet customer needs.
- [Time to Market](https://docs.agile-tools.io/en/docs/resources/ebm-basics/time-to-market.md): Expresses the organization's ability to quickly deliver new capabilities, services, or products.
- [Unrealized Value](https://docs.agile-tools.io/en/docs/resources/ebm-basics/unrealized-value.md): Suggests the potential future value that could be realized if the organization could perfectly meet the needs of all potential customers.
- [Frequently Asked Questions](https://docs.agile-tools.io/en/docs/faq.md): Find answers to common questions about Agile Tools, OKRs, pricing, security, and more.
- [Changelog](https://docs.agile-tools.io/en/changelog.md): What has shipped in Agile Tools, newest first
- [2026.1 release notes](https://docs.agile-tools.io/en/changelog/2026.1.md): Every change in the 2026.1 release line, newest first
- [Contact Support](https://docs.agile-tools.io/en/docs/contact-support.md): Get help from the Agile Tools support team through multiple channels.
- [How can Agile Tools help teams?](https://docs.agile-tools.io/en/leadership/team-leaders/benefits.md): More opportunities for growth and a chance to create Mondays a great workday.
- [How can Agile Tools help product managers?](https://docs.agile-tools.io/en/leadership/product-managers/benefits.md): Gain insight into product-related metrics and make data-driven decisions.
- [Product OKRs](https://docs.agile-tools.io/en/leadership/product-managers/product-okrs.md): Setting goals for your products, services, and initiatives
- [Value Units](https://docs.agile-tools.io/en/leadership/product-managers/value-units.md): Managing products, projects, and initiatives in Agile Tools
- [Product Managers FAQ](https://docs.agile-tools.io/en/leadership/faq-product-managers.md): Frequently asked questions for Product Managers using Agile Tools
- [How can Agile Tools help executives?](https://docs.agile-tools.io/en/leadership/executives/benefits.md): Visualize strategy delivery, create alignment, and monitor key performance indicators.
- [How can Agile Tools help agile leaders?](https://docs.agile-tools.io/en/leadership/agile-leaders/benefits.md): Evidence-Based Management platform to show the value Scrum is providing.
- [Account Setup](https://docs.agile-tools.io/en/admin/account-setup.md): Initial setup for your Agile Tools organization
- [Source Code Management](https://docs.agile-tools.io/en/admin/integrations/scm-overview.md): Overview of SCM integrations in Agile Tools
- [GitHub Integration](https://docs.agile-tools.io/en/admin/integrations/github.md): Connect GitHub to Agile Tools for seamless development tracking
- [API Overview](https://docs.agile-tools.io/en/developer/api/overview.md): Introduction to the Agile Tools REST API
- [List billing-role rates](https://docs.agile-tools.io/api-reference/billing-role-rates/list-billing-role-rates.md): Lists billing-role rates with optional filters. Filter by billingRoleId to scope to a single billing role. Filter by externalId when you need an external-system lookup.
- [Create billing-role rate](https://docs.agile-tools.io/api-reference/billing-role-rates/create-billing-role-rate.md): Creates a billing-role rate. Resolve the billing role id via GET /v1/public/billing-roles. Resolve the currency unit id via GET /v1/public/units.
- [Find billing-role rates by billing role](https://docs.agile-tools.io/api-reference/billing-role-rates/find-billing-role-rates-by-billing-role.md): Lists the full billing-role-rate timeline for a billing role.
- [Find current billing-role rate for billing role](https://docs.agile-tools.io/api-reference/billing-role-rates/find-current-billing-role-rate-for-billing-role.md): The latest billing-role rate effective at or before asOf for a single billing role.
- [Find current billing-role rates](https://docs.agile-tools.io/api-reference/billing-role-rates/find-current-billing-role-rates.md): Lists the latest billing-role rate effective at or before asOf for each billing role.
- [Read billing-role rate](https://docs.agile-tools.io/api-reference/billing-role-rates/read-billing-role-rate.md): Reads a single billing-role rate by id.
- [Delete billing-role rate](https://docs.agile-tools.io/api-reference/billing-role-rates/delete-billing-role-rate.md): Deletes a billing-role rate.
- [Update billing-role rate](https://docs.agile-tools.io/api-reference/billing-role-rates/update-billing-role-rate.md): Patch mutable billing-role-rate fields using JSON Merge Patch semantics. Omitted fields stay unchanged. Explicit null clears externalId.
- [List billing roles](https://docs.agile-tools.io/api-reference/billing-roles/list-billing-roles.md): Lists billing roles with optional filters. Filter by externalId when you need an external-system lookup.
- [Create billing role](https://docs.agile-tools.io/api-reference/billing-roles/create-billing-role.md): Creates a billing role.
- [Find billing roles by job position](https://docs.agile-tools.io/api-reference/billing-roles/find-billing-roles-by-job-position.md): Lists the billing roles pricing the given job position.
- [Read billing role](https://docs.agile-tools.io/api-reference/billing-roles/read-billing-role.md): Reads a single billing role by id.
- [Delete billing role](https://docs.agile-tools.io/api-reference/billing-roles/delete-billing-role.md): Deletes a billing role.
- [Update billing role](https://docs.agile-tools.io/api-reference/billing-roles/update-billing-role.md): Patch mutable billing-role fields using JSON Merge Patch semantics. Omitted fields stay unchanged. Explicit null clears description and externalId.
- [List budgets](https://docs.agile-tools.io/api-reference/budgets/list-budgets.md): Lists budgets with optional filters. Filter by targetId and targetType to scope to a single target. Filter by externalId when you need an external-system lookup.
- [Create budget](https://docs.agile-tools.io/api-reference/budgets/create-budget.md): Creates a budget for a target (value unit, organizational unit or team). Resolve the target id via GET /v1/public/value-units, /v1/public/organizational-units or /v1/public/teams. Resolve the currency unit id via GET /v1/public/units.
- [Find current budgets](https://docs.agile-tools.io/api-reference/budgets/find-current-budgets.md): Lists budgets effective at asOf (periodStart <= asOf <= periodEnd).
- [Find budgets by organizational unit](https://docs.agile-tools.io/api-reference/budgets/find-budgets-by-organizational-unit.md): Lists budgets for an organizational unit.
- [Find budgets by period](https://docs.agile-tools.io/api-reference/budgets/find-budgets-by-period.md): Lists budgets overlapping the given period.
- [Find budgets by target](https://docs.agile-tools.io/api-reference/budgets/find-budgets-by-target.md): Lists budgets for a target (value unit, organizational unit or team).
- [Find current budget for target](https://docs.agile-tools.io/api-reference/budgets/find-current-budget-for-target.md): The budget for a target effective at asOf.
- [Find budgets by team](https://docs.agile-tools.io/api-reference/budgets/find-budgets-by-team.md): Lists budgets for a team.
- [Find budgets by value unit](https://docs.agile-tools.io/api-reference/budgets/find-budgets-by-value-unit.md): Lists budgets for a value unit.
- [Read budget](https://docs.agile-tools.io/api-reference/budgets/read-budget.md): Reads a single budget by id.
- [Delete budget](https://docs.agile-tools.io/api-reference/budgets/delete-budget.md): Deletes a budget.
- [Update budget](https://docs.agile-tools.io/api-reference/budgets/update-budget.md): Patch mutable budget fields using JSON Merge Patch semantics. Omitted fields stay unchanged. Explicit null clears description and externalId.
- [Read budget burn-down](https://docs.agile-tools.io/api-reference/budgets/read-budget-burn-down.md): Reads the burn-down series for a budget. Spend is bucketed across the budget period at day, week or month granularity. Omit granularity to let the backend pick based on period length.
- [Search goals](https://docs.agile-tools.io/api-reference/goals/search-goals.md): Searches goals using scope, status, owner, tag, and strategic-area filters.
- [Create goal](https://docs.agile-tools.io/api-reference/goals/create-goal.md): Creates a goal from the supplied payload.
- [Read goal](https://docs.agile-tools.io/api-reference/goals/read-goal.md): Reads a goal by id.
- [Delete goal](https://docs.agile-tools.io/api-reference/goals/delete-goal.md): Deletes a goal by id.
- [Update goal](https://docs.agile-tools.io/api-reference/goals/update-goal.md): Applies a patch update to a goal by id.
- [Abandon goal](https://docs.agile-tools.io/api-reference/goals/abandon-goal.md): Abandons a goal by id.
- [Read goal alignments](https://docs.agile-tools.io/api-reference/goals/read-goal-alignments.md): Reads directional goal alignments for a goal.
- [Replace goal alignments](https://docs.agile-tools.io/api-reference/goals/replace-goal-alignments.md): Replaces all alignments for a direction on a goal.
- [Remove goal alignment](https://docs.agile-tools.io/api-reference/goals/remove-goal-alignment.md): Removes an alignment from a goal to another goal.
- [Add goal alignment](https://docs.agile-tools.io/api-reference/goals/add-goal-alignment.md): Adds an alignment from a goal to another goal.
- [Archive goal](https://docs.agile-tools.io/api-reference/goals/archive-goal.md): Archives a goal by id.
- [Clone goal](https://docs.agile-tools.io/api-reference/goals/clone-goal.md): Creates a clone of a goal using a target period.
- [Complete goal](https://docs.agile-tools.io/api-reference/goals/complete-goal.md): Completes an active goal by id.
- [Remove goal key-result template](https://docs.agile-tools.io/api-reference/goals/remove-goal-key-result-template.md): Removes a key-result template from a goal.
- [Add goal key-result template](https://docs.agile-tools.io/api-reference/goals/add-goal-key-result-template.md): Adds a key-result template to a goal.
- [Read goal key results](https://docs.agile-tools.io/api-reference/goals/read-goal-key-results.md): Reads key results for a goal.
- [Publish all key results](https://docs.agile-tools.io/api-reference/goals/publish-all-key-results.md): Publishes all draft key results belonging to a goal.
- [Unpublish all key results](https://docs.agile-tools.io/api-reference/goals/unpublish-all-key-results.md): Unpublishes all key results belonging to a goal.
- [Modify goal](https://docs.agile-tools.io/api-reference/goals/modify-goal.md): Marks a goal as modified and resets it to draft state.
- [Unpublish goal](https://docs.agile-tools.io/api-reference/goals/unpublish-goal.md): Moves a goal from published to draft state.
- [Publish goal](https://docs.agile-tools.io/api-reference/goals/publish-goal.md): Publishes a goal by id.
- [Review goal](https://docs.agile-tools.io/api-reference/goals/review-goal.md): Stores a review note and completion decision for a goal.
- [Remove goal strategic area](https://docs.agile-tools.io/api-reference/goals/remove-goal-strategic-area.md): Removes strategic-area reference from a goal.
- [Update goal strategic area](https://docs.agile-tools.io/api-reference/goals/update-goal-strategic-area.md): Updates strategic-area reference for a goal.
- [Remove goal tag](https://docs.agile-tools.io/api-reference/goals/remove-goal-tag.md): Removes a tag from a goal.
- [Add goal tag](https://docs.agile-tools.io/api-reference/goals/add-goal-tag.md): Adds a tag to a goal.
- [List health metrics](https://docs.agile-tools.io/api-reference/health-metrics/list-health-metrics.md): Lists health metrics with optional scope, caretaker, and end-date filters.
- [Create health metric](https://docs.agile-tools.io/api-reference/health-metrics/create-health-metric.md): Creates a health metric from a templated metric definition.
- [Delete health metric note](https://docs.agile-tools.io/api-reference/health-metrics/delete-health-metric-note.md): Deletes a note from a health metric.
- [Update health metric note](https://docs.agile-tools.io/api-reference/health-metrics/update-health-metric-note.md): Updates a note on a health metric.
- [Read health metric](https://docs.agile-tools.io/api-reference/health-metrics/read-health-metric.md): Reads a single health metric by id.
- [Delete health metric](https://docs.agile-tools.io/api-reference/health-metrics/delete-health-metric.md): Deletes a health metric resource.
- [Update health metric](https://docs.agile-tools.io/api-reference/health-metrics/update-health-metric.md): Applies JSON Merge Patch semantics to mutable health metric fields.
- [Create health metric measurement](https://docs.agile-tools.io/api-reference/health-metrics/create-health-metric-measurement.md): Creates a measurement entry for a health metric.
- [Create health metric measurements in batch](https://docs.agile-tools.io/api-reference/health-metrics/create-health-metric-measurements-in-batch.md): Creates multiple measurement entries for a health metric.
- [List health metric notes](https://docs.agile-tools.io/api-reference/health-metrics/list-health-metric-notes.md): Lists notes for a health metric.
- [Create health metric note](https://docs.agile-tools.io/api-reference/health-metrics/create-health-metric-note.md): Creates a note on a health metric.
- [List health metric periods](https://docs.agile-tools.io/api-reference/health-metrics/list-health-metric-periods.md): Lists health metric period summaries. Use fromDate and toDate to filter the range, and set mockMissingPeriods=true to include empty periods in the response.
- [Promote health metric](https://docs.agile-tools.io/api-reference/health-metrics/promote-health-metric.md): Promotes a health metric to a KPI while preserving resource id.
- [List health metric value items](https://docs.agile-tools.io/api-reference/health-metrics/list-health-metric-value-items.md): Lists value items linked to a health metric.
- [Set health metric value items](https://docs.agile-tools.io/api-reference/health-metrics/set-health-metric-value-items.md): Replaces all linked value items for a health metric.
- [Remove health metric value item](https://docs.agile-tools.io/api-reference/health-metrics/remove-health-metric-value-item.md): Removes a value item link from a health metric.
- [Add health metric value item](https://docs.agile-tools.io/api-reference/health-metrics/add-health-metric-value-item.md): Adds a value item link to a health metric.
- [List job positions](https://docs.agile-tools.io/api-reference/job-positions/list-job-positions.md): Lists job positions with optional filters. The catalog combines global ESCO rows with the organization's custom rows. Filter by iscoGroup or externalId for scoped lookups.
- [Create job position](https://docs.agile-tools.io/api-reference/job-positions/create-job-position.md): Creates an organization-specific job position.
- [Find job positions by ISCO group](https://docs.agile-tools.io/api-reference/job-positions/find-job-positions-by-isco-group.md): Lists the catalog rows for an ISCO-08 group.
- [Read job position](https://docs.agile-tools.io/api-reference/job-positions/read-job-position.md): Reads a single job position by id.
- [Delete job position](https://docs.agile-tools.io/api-reference/job-positions/delete-job-position.md): Deletes an organization-specific job position. Global ESCO rows are read-only.
- [Update job position](https://docs.agile-tools.io/api-reference/job-positions/update-job-position.md): Patch mutable job-position fields using JSON Merge Patch semantics. Omitted fields stay unchanged. Explicit null clears description, code, iscoGroup and externalId. Global ESCO rows are read-only.
- [Search key results](https://docs.agile-tools.io/api-reference/key-results/search-key-results.md): Searches key results by status, caretaker, and metric filters. Base response is flat-first. Use expand=currentPeriod,steps,latestNote for conditional nested data.
- [Create key result](https://docs.agile-tools.io/api-reference/key-results/create-key-result.md): Creates a key result.
- [Read key result](https://docs.agile-tools.io/api-reference/key-results/read-key-result.md): Reads a single key result by id. Base response is flat-first. Use expand=currentPeriod,steps,latestNote for conditional nested data.
- [Delete key result](https://docs.agile-tools.io/api-reference/key-results/delete-key-result.md): Deletes a key result.
- [Update key result](https://docs.agile-tools.io/api-reference/key-results/update-key-result.md): Updates a key result.
- [Abandon key result](https://docs.agile-tools.io/api-reference/key-results/abandon-key-result.md): Marks a key result as abandoned.
- [Create key result check-in](https://docs.agile-tools.io/api-reference/key-results/create-key-result-check-in.md): Creates a check-in for a key result.
- [Delete key result check-ins](https://docs.agile-tools.io/api-reference/key-results/delete-key-result-check-ins.md): Deletes all check-ins for a key result.
- [Create key result check-ins in batch](https://docs.agile-tools.io/api-reference/key-results/create-key-result-check-ins-in-batch.md): Creates multiple check-ins for a key result.
- [List key result notes](https://docs.agile-tools.io/api-reference/key-results/list-key-result-notes.md): Lists notes for a key result.
- [Create key result note](https://docs.agile-tools.io/api-reference/key-results/create-key-result-note.md): Creates a note on a key result.
- [List key result periods](https://docs.agile-tools.io/api-reference/key-results/list-key-result-periods.md): Lists period summaries for a key result.
- [Unpublish key result](https://docs.agile-tools.io/api-reference/key-results/unpublish-key-result.md): Unpublishes a key result.
- [Publish key result](https://docs.agile-tools.io/api-reference/key-results/publish-key-result.md): Publishes a key result.
- [List key result value items](https://docs.agile-tools.io/api-reference/key-results/list-key-result-value-items.md): Lists value items linked to a key result.
- [Set key result value items](https://docs.agile-tools.io/api-reference/key-results/set-key-result-value-items.md): Replaces all linked value items for a key result.
- [Remove key result value item](https://docs.agile-tools.io/api-reference/key-results/remove-key-result-value-item.md): Removes a value item link from a key result.
- [Add key result value item](https://docs.agile-tools.io/api-reference/key-results/add-key-result-value-item.md): Adds a value item link to a key result.
- [Delete key result note](https://docs.agile-tools.io/api-reference/key-results/delete-key-result-note.md): Deletes a note from a key result.
- [Update key result note](https://docs.agile-tools.io/api-reference/key-results/update-key-result-note.md): Updates a note on a key result.
- [List KPIs](https://docs.agile-tools.io/api-reference/kpis/list-kpis.md): Lists KPIs with optional scope, caretaker, and end-date filters.
- [Create KPI](https://docs.agile-tools.io/api-reference/kpis/create-kpi.md): Creates a KPI from a templated metric definition.
- [Read KPI](https://docs.agile-tools.io/api-reference/kpis/read-kpi.md): Reads a single KPI by id.
- [Delete KPI](https://docs.agile-tools.io/api-reference/kpis/delete-kpi.md): Deletes a KPI resource.
- [Update KPI](https://docs.agile-tools.io/api-reference/kpis/update-kpi.md): Applies JSON Merge Patch semantics to mutable KPI fields.
- [Demote KPI](https://docs.agile-tools.io/api-reference/kpis/demote-kpi.md): Demotes a KPI to a health metric while preserving resource id.
- [Create KPI measurement](https://docs.agile-tools.io/api-reference/kpis/create-kpi-measurement.md): Creates a measurement entry for a KPI.
- [Create KPI measurements in batch](https://docs.agile-tools.io/api-reference/kpis/create-kpi-measurements-in-batch.md): Creates multiple measurement entries for a KPI.
- [List KPI notes](https://docs.agile-tools.io/api-reference/kpis/list-kpi-notes.md): Lists notes for a KPI.
- [Create KPI note](https://docs.agile-tools.io/api-reference/kpis/create-kpi-note.md): Creates a note on a KPI.
- [List KPI periods](https://docs.agile-tools.io/api-reference/kpis/list-kpi-periods.md): Lists KPI period summaries. Use fromDate and toDate to filter the range, and set mockMissingPeriods=true to include empty periods in the response.
- [List KPI value items](https://docs.agile-tools.io/api-reference/kpis/list-kpi-value-items.md): Lists value items linked to a KPI.
- [Set KPI value items](https://docs.agile-tools.io/api-reference/kpis/set-kpi-value-items.md): Replaces all linked value items for a KPI.
- [Remove KPI value item](https://docs.agile-tools.io/api-reference/kpis/remove-kpi-value-item.md): Removes a value item link from a KPI.
- [Add KPI value item](https://docs.agile-tools.io/api-reference/kpis/add-kpi-value-item.md): Adds a value item link to a KPI.
- [Delete KPI note](https://docs.agile-tools.io/api-reference/kpis/delete-kpi-note.md): Deletes a note from a KPI.
- [Update KPI note](https://docs.agile-tools.io/api-reference/kpis/update-kpi-note.md): Updates a note on a KPI.
- [List organizational units](https://docs.agile-tools.io/api-reference/organizational-units/list-organizational-units.md): Lists organizational units with optional name, parent, and externalId filters.
- [Create organizational unit](https://docs.agile-tools.io/api-reference/organizational-units/create-organizational-unit.md): Creates an organizational unit.
- [Count organizational units](https://docs.agile-tools.io/api-reference/organizational-units/count-organizational-units.md): Counts organizational units.
- [Read organizational unit root](https://docs.agile-tools.io/api-reference/organizational-units/read-organizational-unit-root.md): Reads the root organizational unit.
- [List organizational unit types](https://docs.agile-tools.io/api-reference/organizational-units/list-organizational-unit-types.md): Lists available organizational unit types. Use the returned id as typeId in organizational unit create/update requests.
- [Create organizational unit type](https://docs.agile-tools.io/api-reference/organizational-units/create-organizational-unit-type.md): Creates an organizational unit type.
- [Delete organizational unit type](https://docs.agile-tools.io/api-reference/organizational-units/delete-organizational-unit-type.md): Deletes an organizational unit type.
- [Update organizational unit type](https://docs.agile-tools.io/api-reference/organizational-units/update-organizational-unit-type.md): Partially updates an organizational unit type. Omitted fields keep their current values.
- [Disable organizational unit type](https://docs.agile-tools.io/api-reference/organizational-units/disable-organizational-unit-type.md): Disables an organizational unit type.
- [Enable organizational unit type](https://docs.agile-tools.io/api-reference/organizational-units/enable-organizational-unit-type.md): Enables an organizational unit type.
- [Read organizational unit](https://docs.agile-tools.io/api-reference/organizational-units/read-organizational-unit.md): Reads a single organizational unit by id. Use expand=valueUnits,clients for conditional nested references.
- [Delete organizational unit](https://docs.agile-tools.io/api-reference/organizational-units/delete-organizational-unit.md): Deletes an organizational unit.
- [Update organizational unit](https://docs.agile-tools.io/api-reference/organizational-units/update-organizational-unit.md): Partially updates mutable fields of an organizational unit.
- [List organizational unit clients](https://docs.agile-tools.io/api-reference/organizational-units/list-organizational-unit-clients.md): Lists clients linked to an organizational unit.
- [Create organizational unit client](https://docs.agile-tools.io/api-reference/organizational-units/create-organizational-unit-client.md): Creates a client and links it to an organizational unit.
- [Update organizational unit clients](https://docs.agile-tools.io/api-reference/organizational-units/update-organizational-unit-clients.md): Applies a strict merge-patch to organizational unit clients. Omit clientIds to keep current clients or provide an empty list to clear all clients.
- [Delete organizational unit client](https://docs.agile-tools.io/api-reference/organizational-units/delete-organizational-unit-client.md): Deletes a client linked to an organizational unit.
- [Update organizational unit client](https://docs.agile-tools.io/api-reference/organizational-units/update-organizational-unit-client.md): Partially updates a client linked to an organizational unit. Omitted fields keep their current values.
- [List organizational unit client projects](https://docs.agile-tools.io/api-reference/organizational-units/list-organizational-unit-client-projects.md): Lists projects for a client linked to an organizational unit.
- [Create organizational unit client project](https://docs.agile-tools.io/api-reference/organizational-units/create-organizational-unit-client-project.md): Creates a client project for a client linked to an organizational unit.
- [Read organizational unit client project](https://docs.agile-tools.io/api-reference/organizational-units/read-organizational-unit-client-project.md): Reads a client project linked to an organizational unit.
- [Delete organizational unit client project](https://docs.agile-tools.io/api-reference/organizational-units/delete-organizational-unit-client-project.md): Deletes a client project linked to an organizational unit.
- [Update organizational unit client project](https://docs.agile-tools.io/api-reference/organizational-units/update-organizational-unit-client-project.md): Partially updates a client project linked to an organizational unit. Omitted fields keep their current values.
- [List organizational unit members](https://docs.agile-tools.io/api-reference/organizational-units/list-organizational-unit-members.md): Lists direct members of an organizational unit.
- [Update organizational unit members](https://docs.agile-tools.io/api-reference/organizational-units/update-organizational-unit-members.md): Replaces organizational unit members with the provided member ids.
- [List organizational unit members recursively](https://docs.agile-tools.io/api-reference/organizational-units/list-organizational-unit-members-recursively.md): Lists members of an organizational unit and all its descendants.
- [List people](https://docs.agile-tools.io/api-reference/people/list-people.md): Lists people with optional query, organizational unit, and externalId filters. Resolve organizationalUnitId first via GET /v1/public/organizational-units.
- [Create person](https://docs.agile-tools.io/api-reference/people/create-person.md): Creates a person using explicit createMode: ADD_ONLY creates profile without invitation email, ADD_AND_INVITE creates profile and sends invitation email. Resolve organizationalUnitId via GET /v1/public/organizational-units and managerId via GET /v1/public/people.
- [Count people](https://docs.agile-tools.io/api-reference/people/count-people.md): Returns count of people.
- [Read person](https://docs.agile-tools.io/api-reference/people/read-person.md): Reads a single person by id. Base response includes joined. Use expand=groups,teams,workloadScheme,holidayScheme for conditional nested data.
- [Deactivate person](https://docs.agile-tools.io/api-reference/people/deactivate-person.md): Soft-deletes a person.
- [Update person](https://docs.agile-tools.io/api-reference/people/update-person.md): Patch person mutable fields using JSON Merge Patch semantics. Omitted fields stay unchanged. Explicit null clears only managerId, externalId, and jobTitle. Explicit null for other fields is rejected with validation error. Resolve organizationalUnitId via GET /v1/public/organizational-units and manag…
- [Reactivate person](https://docs.agile-tools.io/api-reference/people/reactivate-person.md): Reactivates a previously deactivated person.
- [Invite person](https://docs.agile-tools.io/api-reference/people/invite-person.md): Sends or resends invitation email for a person.
- [List person rates](https://docs.agile-tools.io/api-reference/person-rates/list-person-rates.md): Lists person rates with optional filters. Filter by personId to scope to a single person. Filter by externalId when you need an external-system lookup.
- [Create person rate](https://docs.agile-tools.io/api-reference/person-rates/create-person-rate.md): Creates a person rate. Resolve the person id via GET /v1/public/people. Resolve the currency unit id via GET /v1/public/units.
- [Find current person rates](https://docs.agile-tools.io/api-reference/person-rates/find-current-person-rates.md): Lists the latest person rate effective at or before asOf for each person.
- [Find person rates by person](https://docs.agile-tools.io/api-reference/person-rates/find-person-rates-by-person.md): Lists the full person-rate timeline for a person.
- [Find current person rate for person](https://docs.agile-tools.io/api-reference/person-rates/find-current-person-rate-for-person.md): The latest person rate effective at or before asOf for a single person.
- [Read person rate](https://docs.agile-tools.io/api-reference/person-rates/read-person-rate.md): Reads a single person rate by id.
- [Delete person rate](https://docs.agile-tools.io/api-reference/person-rates/delete-person-rate.md): Deletes a person rate.
- [Update person rate](https://docs.agile-tools.io/api-reference/person-rates/update-person-rate.md): Patch mutable person-rate fields using JSON Merge Patch semantics. Omitted fields stay unchanged. Explicit null clears externalId.
- [List skills](https://docs.agile-tools.io/api-reference/skills/list-skills.md): Lists skills with optional filters. The catalog combines global ESCO rows with the organization's custom rows. Filter by category (case-insensitive partial match), skillType (skill/competence | knowledge), reuseLevel (transversal | cross-sector | sector-specific | occupation-specific), collection (d…
- [Create skill](https://docs.agile-tools.io/api-reference/skills/create-skill.md): Creates an organization-specific skill.
- [Find skills by category](https://docs.agile-tools.io/api-reference/skills/find-skills-by-category.md): Lists the catalog rows for a skill category.
- [Read skill](https://docs.agile-tools.io/api-reference/skills/read-skill.md): Reads a single skill by id.
- [Delete skill](https://docs.agile-tools.io/api-reference/skills/delete-skill.md): Deletes an organization-specific skill. Global ESCO rows are read-only.
- [Update skill](https://docs.agile-tools.io/api-reference/skills/update-skill.md): Patch mutable skill fields using JSON Merge Patch semantics. Omitted fields stay unchanged. Explicit null clears description, category, skillType, proficiencyScale and externalId. Global ESCO rows are read-only.
- [List functional areas](https://docs.agile-tools.io/api-reference/tags/list-functional-areas.md): Lists functional area tags.
- [List goal templates](https://docs.agile-tools.io/api-reference/tags/list-goal-templates.md): Lists goal template tags.
- [List goals](https://docs.agile-tools.io/api-reference/tags/list-goals.md): Lists goal tags.
- [List industries](https://docs.agile-tools.io/api-reference/tags/list-industries.md): Lists industry tags.
- [List iterations](https://docs.agile-tools.io/api-reference/tags/list-iterations.md): Lists iteration tags.
- [List jobs](https://docs.agile-tools.io/api-reference/tags/list-jobs.md): Lists job tags.
- [List key result templates](https://docs.agile-tools.io/api-reference/tags/list-key-result-templates.md): Lists key result template tags.
- [List metric templates](https://docs.agile-tools.io/api-reference/tags/list-metric-templates.md): Lists metric template tags.
- [List metrics](https://docs.agile-tools.io/api-reference/tags/list-metrics.md): Lists metric tags.
- [List organizational unit custom types](https://docs.agile-tools.io/api-reference/tags/list-organizational-unit-custom-types.md): Lists organizational unit custom type tags.
- [List organizational unit types](https://docs.agile-tools.io/api-reference/tags/list-organizational-unit-types.md): Lists organizational unit type tags.
- [List person status unavailability reasons](https://docs.agile-tools.io/api-reference/tags/list-person-status-unavailability-reasons.md): Lists person status unavailability reason tags.
- [List strategic areas](https://docs.agile-tools.io/api-reference/tags/list-strategic-areas.md): Lists strategic area tags.
- [List value items](https://docs.agile-tools.io/api-reference/tags/list-value-items.md): Lists value item tags.
- [List value unit custom types](https://docs.agile-tools.io/api-reference/tags/list-value-unit-custom-types.md): Lists value unit custom type tags.
- [List value units](https://docs.agile-tools.io/api-reference/tags/list-value-units.md): Lists value unit tags.
- [List work categories](https://docs.agile-tools.io/api-reference/tags/list-work-categories.md): Lists work category tags.
- [List work facets](https://docs.agile-tools.io/api-reference/tags/list-work-facets.md): Lists work facet tags.
- [List teams](https://docs.agile-tools.io/api-reference/teams/list-teams.md): Lists teams with optional filters. Filter by memberId when you need teams that include a specific person. Filter by externalId when you need an external-system lookup.
- [Create team](https://docs.agile-tools.io/api-reference/teams/create-team.md): Creates a team using people, value unit, and sprint ids.
- [Count teams](https://docs.agile-tools.io/api-reference/teams/count-teams.md): Returns the number of active teams.
- [Read team](https://docs.agile-tools.io/api-reference/teams/read-team.md): Reads a single team by id.
- [Disband team](https://docs.agile-tools.io/api-reference/teams/disband-team.md): Disbands or permanently deletes a team. Default is soft delete (disband), which is a reversible deactivation that preserves team history. Use mode=hard for permanent deletion.
- [Update team](https://docs.agile-tools.io/api-reference/teams/update-team.md): Patch mutable team fields using JSON Merge Patch semantics. Omitted fields stay unchanged. Explicit null clears leadId, deputyLeadId, and externalId. Collection fields use empty arrays to clear values.
- [Reactivate disbanded team](https://docs.agile-tools.io/api-reference/teams/reactivate-disbanded-team.md): Reactivates a previously disbanded team.
- [List team members](https://docs.agile-tools.io/api-reference/teams/list-team-members.md): Lists the members of a team, including organizational unit and value unit enrichment.
- [Update team members](https://docs.agile-tools.io/api-reference/teams/update-team-members.md): Applies a strict merge-patch to team members. Omit memberIds to keep current members, or provide an empty list to clear all members.
- [Remove team sprints](https://docs.agile-tools.io/api-reference/teams/remove-team-sprints.md): Removes the provided sprint ids from a team.
- [Update team sprints](https://docs.agile-tools.io/api-reference/teams/update-team-sprints.md): Applies a strict merge-patch to team sprints. Omit sprintIds to keep current sprints, or provide an empty list to clear all sprints.
- [Search value items](https://docs.agile-tools.io/api-reference/value-items/search-value-items.md): Searches value items.
- [Create value item](https://docs.agile-tools.io/api-reference/value-items/create-value-item.md): Creates a value item. The type field is mandatory; call GET /v1/public/value-items/types to discover valid type ids.
- [Count value items](https://docs.agile-tools.io/api-reference/value-items/count-value-items.md): Returns the number of value items.
- [List key results by value item key](https://docs.agile-tools.io/api-reference/value-items/list-key-results-by-value-item-key.md): Lists key results linked to a value item by key.
- [List value item types](https://docs.agile-tools.io/api-reference/value-items/list-value-item-types.md): Lists value item types that can be used in create and update requests.
- [Read value item](https://docs.agile-tools.io/api-reference/value-items/read-value-item.md): Reads a single value item by id.
- [Delete value item](https://docs.agile-tools.io/api-reference/value-items/delete-value-item.md): Deletes a value item.
- [Update value item](https://docs.agile-tools.io/api-reference/value-items/update-value-item.md): Applies a strict merge-patch to mutable value item fields. Omitted fields stay unchanged, and collection fields clear when sent as empty lists.
- [List value item acceptance criteria](https://docs.agile-tools.io/api-reference/value-items/list-value-item-acceptance-criteria.md): Lists acceptance criteria for a value item.
- [Create acceptance criterion](https://docs.agile-tools.io/api-reference/value-items/create-acceptance-criterion.md): Creates an acceptance criterion for a value item.
- [Delete acceptance criterion](https://docs.agile-tools.io/api-reference/value-items/delete-acceptance-criterion.md): Deletes an acceptance criterion from a value item.
- [Update acceptance criterion](https://docs.agile-tools.io/api-reference/value-items/update-acceptance-criterion.md): Updates an acceptance criterion for a value item using strict merge-patch semantics.
- [List value item comments](https://docs.agile-tools.io/api-reference/value-items/list-value-item-comments.md): Lists comments for a value item.
- [Create value item comment](https://docs.agile-tools.io/api-reference/value-items/create-value-item-comment.md): Creates a comment on a value item.
- [Update value item definition of done](https://docs.agile-tools.io/api-reference/value-items/update-value-item-definition-of-done.md): Updates a definition of done for a value item.
- [List value item definitions of done](https://docs.agile-tools.io/api-reference/value-items/list-value-item-definitions-of-done.md): Lists definitions of done for a value item.
- [Read value item description](https://docs.agile-tools.io/api-reference/value-items/read-value-item-description.md): Reads a value item description.
- [Update value item status](https://docs.agile-tools.io/api-reference/value-items/update-value-item-status.md): Updates status and optional assignee for a value item.
- [List value item worklogs](https://docs.agile-tools.io/api-reference/value-items/list-value-item-worklogs.md): Lists worklogs for a value item using cursor pagination.
- [Create value item worklog](https://docs.agile-tools.io/api-reference/value-items/create-value-item-worklog.md): Creates a worklog for a value item.
- [Delete value item worklog](https://docs.agile-tools.io/api-reference/value-items/delete-value-item-worklog.md): Deletes a worklog from a value item.
- [Update value item worklog](https://docs.agile-tools.io/api-reference/value-items/update-value-item-worklog.md): Updates a worklog for a value item using strict merge-patch semantics.
- [Get value item client projects](https://docs.agile-tools.io/api-reference/value-items/get-value-item-client-projects.md): Lists client projects linked to a value item.
- [Delete value item comment](https://docs.agile-tools.io/api-reference/value-items/delete-value-item-comment.md): Deletes a value item comment.
- [Update value item comment](https://docs.agile-tools.io/api-reference/value-items/update-value-item-comment.md): Updates a value item comment using strict merge-patch semantics.
- [Update value item key results](https://docs.agile-tools.io/api-reference/value-items/update-value-item-key-results.md): Sets key result links for a value item.
- [List value units](https://docs.agile-tools.io/api-reference/value-units/list-value-units.md): Lists value units with optional name, key, parent, and external id filters.
- [Create value unit](https://docs.agile-tools.io/api-reference/value-units/create-value-unit.md): Creates a value unit.
- [Count](https://docs.agile-tools.io/api-reference/value-units/count.md): Counts value units.
- [Get Led By Person](https://docs.agile-tools.io/api-reference/value-units/get-led-by-person.md): Lists value units led by a person.
- [Read Tree](https://docs.agile-tools.io/api-reference/value-units/read-tree.md): Reads the value unit tree.
- [Find By Key](https://docs.agile-tools.io/api-reference/value-units/find-by-key.md): Finds a value unit by key.
- [List value unit types](https://docs.agile-tools.io/api-reference/value-units/list-value-unit-types.md): Lists available value unit types. Use the returned id as typeId in value unit create/update requests.
- [Create value unit type](https://docs.agile-tools.io/api-reference/value-units/create-value-unit-type.md): Creates a value unit type.
- [Delete value unit type](https://docs.agile-tools.io/api-reference/value-units/delete-value-unit-type.md): Deletes a value unit type.
- [Update value unit type](https://docs.agile-tools.io/api-reference/value-units/update-value-unit-type.md): Updates a value unit type.
- [Disable value unit type](https://docs.agile-tools.io/api-reference/value-units/disable-value-unit-type.md): Disables a value unit type.
- [Enable value unit type](https://docs.agile-tools.io/api-reference/value-units/enable-value-unit-type.md): Enables a value unit type.
- [Read value unit](https://docs.agile-tools.io/api-reference/value-units/read-value-unit.md): Reads a single value unit by id. Use expand=organizationalUnits,teams,workboard,definitionsOfDone,sprints for conditional nested references.
- [Delete value unit](https://docs.agile-tools.io/api-reference/value-units/delete-value-unit.md): Deletes a value unit.
- [Update value unit](https://docs.agile-tools.io/api-reference/value-units/update-value-unit.md): Updates mutable fields of a value unit.
- [Unarchive](https://docs.agile-tools.io/api-reference/value-units/unarchive.md): Unarchives a value unit.
- [Archive](https://docs.agile-tools.io/api-reference/value-units/archive.md): Archives a value unit.
- [Get People Data](https://docs.agile-tools.io/api-reference/value-units/get-people-data.md): Reads people data for a value unit.
- [List Teams](https://docs.agile-tools.io/api-reference/value-units/list-teams.md): Lists teams linked to a value unit.
- [Update Teams](https://docs.agile-tools.io/api-reference/value-units/update-teams.md): Replaces teams linked to a value unit.
- [Get Backlog](https://docs.agile-tools.io/api-reference/value-units/get-backlog.md): Reads backlog data for a value unit.
- [Delete Definition Of Done](https://docs.agile-tools.io/api-reference/value-units/delete-definition-of-done.md): Deletes a definition of done from a value unit.
- [Get Definitions Of Done](https://docs.agile-tools.io/api-reference/value-units/get-definitions-of-done.md): Lists definitions of done for a value unit.
- [Delete Definitions Of Done](https://docs.agile-tools.io/api-reference/value-units/delete-definitions-of-done.md): Deletes all definitions of done from a value unit.
- [Update Definition Of Done](https://docs.agile-tools.io/api-reference/value-units/update-definition-of-done.md): Updates definitions of done for a value unit using strict merge-patch semantics.
- [Get Milestones](https://docs.agile-tools.io/api-reference/value-units/get-milestones.md): Lists milestones for a value unit.
- [Create Milestone](https://docs.agile-tools.io/api-reference/value-units/create-milestone.md): Creates a milestone for a value unit.
- [Delete Milestone](https://docs.agile-tools.io/api-reference/value-units/delete-milestone.md): Deletes a milestone from a value unit.
- [Update Milestone](https://docs.agile-tools.io/api-reference/value-units/update-milestone.md): Updates a milestone for a value unit.
- [Get Sprints](https://docs.agile-tools.io/api-reference/value-units/get-sprints.md): Lists sprints for a value unit.
- [Create Sprint](https://docs.agile-tools.io/api-reference/value-units/create-sprint.md): Creates a sprint for a value unit.
- [Search Sprints](https://docs.agile-tools.io/api-reference/value-units/search-sprints.md): Searches sprints for a value unit.
- [Get Sprint](https://docs.agile-tools.io/api-reference/value-units/get-sprint.md): Reads a sprint for a value unit.
- [Delete Sprint](https://docs.agile-tools.io/api-reference/value-units/delete-sprint.md): Deletes a sprint from a value unit.
- [Update Sprint](https://docs.agile-tools.io/api-reference/value-units/update-sprint.md): Updates a sprint for a value unit.
- [Review Sprint](https://docs.agile-tools.io/api-reference/value-units/review-sprint.md): Saves sprint review details.
- [Get Teams For Sprint](https://docs.agile-tools.io/api-reference/value-units/get-teams-for-sprint.md): Lists teams assigned to a sprint.
- [Get Value Items For Sprint](https://docs.agile-tools.io/api-reference/value-units/get-value-items-for-sprint.md): Lists value items assigned to a sprint.
- [Add Value Items To Sprint](https://docs.agile-tools.io/api-reference/value-units/add-value-items-to-sprint.md): Adds multiple value items to a sprint.
- [Add Value Item To Sprint](https://docs.agile-tools.io/api-reference/value-units/add-value-item-to-sprint.md): Adds a value item to a sprint.
- [Remove Value Item From Sprint](https://docs.agile-tools.io/api-reference/value-units/remove-value-item-from-sprint.md): Removes a value item from a sprint.
- [Get Themes](https://docs.agile-tools.io/api-reference/value-units/get-themes.md): Lists themes for a value unit.
- [Create Theme](https://docs.agile-tools.io/api-reference/value-units/create-theme.md): Creates a theme for a value unit.
- [Delete Theme](https://docs.agile-tools.io/api-reference/value-units/delete-theme.md): Deletes a theme from a value unit.
- [Update Theme](https://docs.agile-tools.io/api-reference/value-units/update-theme.md): Updates a theme for a value unit.
- [Get Versions](https://docs.agile-tools.io/api-reference/value-units/get-versions.md): Lists versions for a value unit.
- [Create Version](https://docs.agile-tools.io/api-reference/value-units/create-version.md): Creates a version for a value unit.
- [Delete Version](https://docs.agile-tools.io/api-reference/value-units/delete-version.md): Deletes a version from a value unit.
- [Update Version](https://docs.agile-tools.io/api-reference/value-units/update-version.md): Updates a version for a value unit.
- [Unrelease Version](https://docs.agile-tools.io/api-reference/value-units/unrelease-version.md): Marks a version as unreleased.
- [Release Version](https://docs.agile-tools.io/api-reference/value-units/release-version.md): Releases a version.
- [Git Sync Automation](https://docs.agile-tools.io/en/developer/integrations/git-sync.md): Automate workflows between Git providers and Agile Tools
- [Developer FAQ](https://docs.agile-tools.io/en/developer/faq.md): Frequently asked questions for developers integrating with Agile Tools
- [API Overview](https://docs.agile-tools.io/en/developer/api/overview.md): Introduction to the Agile Tools REST API
- [List job positions (v2)](https://docs.agile-tools.io/api-reference/job-positions/list-job-positions-v2.md): Lists job positions with optional q, iscoGroup, and externalId filters. When _cursor is provided, cursor mode is used; otherwise offset mode is used.
- [List people (v2)](https://docs.agile-tools.io/api-reference/people/list-people-v2.md): Lists people with optional q, organizationalUnitId, externalId, and includeDeleted filters. When _cursor is provided, cursor mode is used; otherwise offset mode is used.
- [List skills (v2)](https://docs.agile-tools.io/api-reference/skills/list-skills-v2.md): Lists skills with optional q, category, skillType, reuseLevel, collection, and externalId filters. When _cursor is provided, cursor mode is used; otherwise offset mode is used.
- [Git Sync Automation](https://docs.agile-tools.io/en/developer/integrations/git-sync.md): Automate workflows between Git providers and Agile Tools
- [Developer FAQ](https://docs.agile-tools.io/en/developer/faq.md): Frequently asked questions for developers integrating with Agile Tools

## OpenAPI Specs

- [openapi.v1.local](/openapi.v1.local.json)
- [openapi.v2.local](/openapi.v2.local.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.