---
title: "Update Billing Details"
description: "Updates billing information for the organization in your authenticated session."
---

`PATCH /api/organization/billing`

## Request Body

```json
{
	"billingEmail": "billing@deinkunde.com"
}
```

## Example (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X PATCH "$BASE_URL/api/organization/billing" \
	-H "Authorization: Bearer $TOKEN" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-d '{
		"billingEmail": "billing@deinkunde.com"
	}'
```

## Notes

- `billingEmail` is currently the only supported field for this endpoint.
- The organization is derived automatically from your authenticated session or API token.
- The legacy route `PATCH /api/organizations/:organizationPublicId/billing` remains supported for compatibility.
- The plural org-less alias `PATCH /api/organizations/billing` is also supported.
- Global admins need an active organization context in the authenticated session for the org-less route.

## Common errors

- `400 Invalid request body` when the payload does not match the schema
- `400 Organization ID is required in the authenticated session` when no organization can be derived from the current session/token
- `401 Unauthorized` when you are not logged in
- `403 Forbidden` when you do not have admin access to update billing settings

## Response

Returns the updated organization billing details. See [Error Codes](/api/error-codes-and-known-pitfalls) for error responses.