curl -X POST 'https://api.openai.com/v1/organization/projects/project-id/spend_alerts/alert-id' \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "threshold_amount": 0,
  "currency": "USD",
  "interval": "month",
  "notification_channel": {
    "type": "email",
    "recipients": [
      "example-recipients"
    ],
    "subject_prefix": "example-subject-prefix"
  }
}'

# POST /organization/projects/{project_id}/spend_alerts/{alert_id} (OpenAI API)
Base URL: https://api.openai.com/v1
Auth: Authorization; OpenAI admin key; required.
Request formats: application/json.
Last verified: 2026-10-20

> Update project spend alert

## Critical Gotchas
* The Responses API is the primary interface for new text and tool workflows; Chat Completions remains a separate compatibility API.
* Audio transcription uploads use multipart form data rather than a JSON request body.

## cURL
curl -X POST 'https://api.openai.com/v1/organization/projects/project-id/spend_alerts/alert-id' \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "threshold_amount": 0,
  "currency": "USD",
  "interval": "month",
  "notification_channel": {
    "type": "email",
    "recipients": [
      "example-recipients"
    ],
    "subject_prefix": "example-subject-prefix"
  }
}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| project_id | path | string | Yes | The ID of the project to update. |
| alert_id | path | string | Yes | The ID of the spend alert to update. |
| threshold_amount | body | integer | Yes | The alert threshold amount, in cents. |
| currency | body | string | Yes | The currency for the threshold amount. |
| interval | body | string | Yes | The time interval for evaluating spend against the threshold. |
| notification_channel | body | object | Yes | Email notification settings for a spend alert. |

## Response example
{"id":"string","object":"project.spend_alert"}

---
Need an API key? Get one at https://platform.openai.com/api-keys

POST

POST /organization/projects/{project_id}/spend_alerts/{alert_id} — OpenAI API

OpenAI admin key (required); https://api.openai.com/v1

OpenAI API

Update project spend alert

Base URL: https://api.openai.com/v1
Auth: Authorization: Bearer <OPENAI_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 311 tokens · Vary: Accept

Critical gotchas

The Responses API is the primary interface for new text and tool workflows; Chat Completions remains a separate compatibility API.

Audio transcription uploads use multipart form data rather than a JSON request body.

cURL

curl -X POST 'https://api.openai.com/v1/organization/projects/project-id/spend_alerts/alert-id' \  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \  -H 'Content-Type: application/json' \  -d '{  "threshold_amount": 0,  "currency": "USD",  "interval": "month",  "notification_channel": {    "type": "email",    "recipients": [      "example-recipients"    ],    "subject_prefix": "example-subject-prefix"  }}'

Parameters

Name	In	Type	Required	Description
project_id	path	string	Yes	The ID of the project to update.
alert_id	path	string	Yes	The ID of the spend alert to update.
threshold_amount	body	integer	Yes	The alert threshold amount, in cents.
currency	body	string	Yes	The currency for the threshold amount.
interval	body	string	Yes	The time interval for evaluating spend against the threshold.
notification_channel	body	object	Yes	Email notification settings for a spend alert.

Response 200 OK

{
  "id": "string",
  "object": "project.spend_alert",
  "threshold_amount": 0,
  "currency": "USD",
  "interval": "month",
  "notification_channel": {
    "type": "email",
    "recipients": [
      "string"
    ],
    "subject_prefix": "string"
  }
}

Get a free OpenAI API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.