Skip to content

Update Blog Translation​

PUT
/api/v1/posts/id/{id}/translations/{lang}

Authorizations​

SessionAuth

Session ID for authenticated requests

Type
API Key (header: X-Session-ID)

Parameters​

Path Parameters

id*
Type
string
Required
lang*
Type
string
Required

Request Body​

application/json
JSON
{
  
"additionalProperties": "string"
}

Responses​

Translation updated

Playground​

Server
Authorization
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI

Update a blog translation.

Auth: session + owner/admin.

Parameters ​

NameInTypeRequiredDescription
idpathstringYesPost id
langpathstringYesLanguage code

Request Body ​

json
{
	"title": "Hola mundo (actualizado)",
	"body": "# Hola actualizado"
}

Response 200 ​

json
{
	"data": { "id": "post_2", "lang": "es", "updated": true },
	"user_context": { "authenticated": true },
	"meta": {}
}

Response Errors ​

  • 400 invalid translation payload
  • 401 missing session
  • 403 not owner/admin
  • 404 translation not found
  • 429 RATE_LIMIT_EXCEEDED

Notes ​

  • Rate limit: post bucket, 10 requests / 3600s by default. A session that can publish (admin, superadmin, author, editor, or the roles in BLOG_ALLOWED_POST_ROLES and BLOG_ADMIN_ROLES) is not counted. Otherwise 429 RATE_LIMIT_EXCEEDED. See Rate limits.

  • Use this for translation fixes and editorial updates.

  • Keep the language code explicit in the route.