---
title: "Approve Grant"
method: POST
path: "/optimisation/tasks/{task_id}/budget/grants"
tags: ["optimisation"]
---

# Approve Grant

`POST /optimisation/tasks/{task_id}/budget/grants`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/optimisation/tasks/{task_id}/budget/grants`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Approve extra spend for OS3's optimizer on the task: an owner or admin, signed in. The
agent never can.

## Path parameters

- `task_id` string, uuid, required

## Request body

- BudgetGrantIn: Extra spend you approve for OS3's optimizer on a task in a workspace, on one meter: it adds to the task's allowance from now on.
  - `workspace_id` string, uuid, required
  - `meter` 'h100_hours' | 'api_usd' | 'sandbox_cpu_hours' | 'sandbox_gib_hours', required
  - `amount` union, required
    - number
    - string
  - `reason` string, required

## Response `201`

Successful Response

- BudgetGrant
  - `id` string, uuid, required
  - `workspace_id` string, uuid, required
  - `task_id` string, uuid, required
  - `meter` string, required
  - `amount` string, required
  - `reason` string, required
  - `approved_by` string, required
  - `approved_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/os3robotics/apis/os3-api.md) - [All operations](https://skmtc.dev/os3robotics/apis/os3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/os3robotics/apis/os3-api/revisions/af32cd4f14bb?raw)