Authentication and scopes
#Send your workspace API key in the Authorization: Bearer YOUR_API_KEY header. This operation requires write and publish.
See Authentication for key setup and project access.
Path parameters
#| Parameter | Type | Requirement | Details |
|---|---|---|---|
projectId | string | Required | Format: uuid. |
contentId | string | Required | Format: uuid. |
Request body
#| Parameter | Type | Requirement | Details |
|---|---|---|---|
expectedUpdatedAt | string | Required | Format: date-time. |
expectedHash | string | Required | Pattern: ^[0-9a-f]{64}$. |
Complete request body schema
{
"type": "object",
"properties": {
"expectedUpdatedAt": {
"type": "string",
"format": "date-time"
},
"expectedHash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
}
},
"required": [
"expectedUpdatedAt",
"expectedHash"
],
"additionalProperties": false
}Example values are placeholders. Replace resource IDs, content, and revision values with your own before sending the request.
Success response · 200
#Selected response fields with illustrative values; other fields are omitted. Approval binds the exact current version. Re-read if the document changes before provider delivery.
The response example shows the known HTTP 200 success path. It does not enumerate every outcome or returned field.
Successful JSON responses return the operation’s result under data and a request identifier under meta.requestId. Collection results include their own pagination or coverage metadata. The payload inside data varies by operation.
The OpenAPI document defines shared success and error envelopes. It does not define every operation’s returned data fields or promise that every operation returns every listed success status. See the request and response guide and workflow examples for documented payloads.
Errors and retries
#Check the HTTP status and stable error.code. Keep meta.requestId when investigating a failed request. Follow Retry-After when it is present, and check existing job or resource state before retrying a write.
See Errors and limits for validation, permissions, conflicts, and temporary queue denials.