# Approve an agent request

Approves a pending request and returns the receipt the waiting agent redeems. Requires a signed-in session belonging to the grant’s owner. Approving again returns the same receipt, and an elevation returns its lease.

### Endpoint

`POST /v1/approvals/{approvalId}/approve`

### Authorization

`__Host-better-auth.session_token`

API key · cookie required

Dashboard session cookie set at sign-in. An operation that lists only this scheme needs a person: API keys and machine credentials are refused. The same session token also works as `Authorization: Bearer`.

### Path parameters

- `approvalId` **string** (required)
  - min length: 1

### Responses

- **200** Response for status 200

```json
  {
    "$schema": "string<uri>",
    "data": {
      "id": "string",
      "status": "string"  // Allowed: "completed", "denied", "expired"
    }
  }
  ```

- **Error Response**

Every 4xx and 5xx response is one RFC 9457 problem document served as `application/problem+json`.

```json
  {
    "$schema": "string<uri>",
    "type": "string",
    "title": "string",
    "status": integer,  // HTTP status of the response
    "detail": "string",
    "code": "string",
    "pointer": "string",
    "details": {
      "property1": null,
      "property2": null
    },
    "suggestions": ["string"],
    "next": ["string"],
    "requestId": "string"
  }
  ```

### Try it

#### Request examples

**cURL**

```bash
curl -X POST "https://api.spacefast.com/v1/approvals/string/approve" \
  -H "Cookie: __Host-better-auth.session_token=YOUR_API_KEY"
```

**JavaScript**

```javascript
const response = await fetch("https://api.spacefast.com/v1/approvals/string/approve", {
  method: "POST",
  headers: {
    "Cookie": "__Host-better-auth.session_token=YOUR_API_KEY"
  }
});
```

**Python**

```python
import requests

response = requests.post(
    "https://api.spacefast.com/v1/approvals/string/approve",
    headers={
        "Cookie": "__Host-better-auth.session_token=YOUR_API_KEY"
    },
)
```

### Response Example

**Success Response (200)**

```json
{
  "$schema": "http://example.com",
  "data": {
    "id": "string",
    "status": "completed",
    "result": {
      "property1": null,
      "property2": null
    }
  }
}
```

**Error Response**

```json
{
  "$schema": "http://example.com",
  "type": "string",
  "title": "string",
  "status": -9007199254740991,
  "detail": "string",
  "code": "string",
  "pointer": "string",
  "details": {
    "property1": null,
    "property2": null
  },
  "suggestions": ["string"],
  "next": ["string"],
  "requestId": "string"
}
```