Skip to main content
PUT
/
organizations
/
{id}
/
legal
Update Legal Data
curl --request PUT \
  --url https://api.example.com/organizations/{id}/legal \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "legal_name": "<string>",
  "tax_system": "<string>",
  "website": "<string>",
  "support_email": "<string>",
  "phone": "<string>",
  "address": {
    "street": "<string>",
    "exterior": 123,
    "interior": 123,
    "neighborhood": "<string>",
    "city": "<string>",
    "municipality": "<string>",
    "zip": 123,
    "state": "<string>"
  }
}
'
{
  "200": {},
  "400": {},
  "401": {},
  "403": {},
  "404": {},
  "id": "<string>",
  "name": "<string>",
  "razonSocial": "<string>",
  "regimenFiscalId": "<string>",
  "website": "<string>",
  "phone": "<string>",
  "selfInvoiceSupportEmail": "<string>",
  "addressStreet": "<string>",
  "addressExterior": "<string>",
  "addressInterior": "<string>",
  "addressNeighborhood": "<string>",
  "addressCity": "<string>",
  "addressMunicipality": "<string>",
  "addressZip": "<string>",
  "addressState": "<string>",
  "updatedAt": "<string>"
}

​
Description

Updates the legal and fiscal data of an organization including tax system, legal name, address, and contact information. Only the organization owner can perform this action.

​
Authorization

​
Authorization
string
required
Bearer token for authentication

​
Path Parameters

​
id
string
required
The unique ID of the organization

​
Body Parameters

​
name
string
Organization display name (1-100 characters)
​
legal_name
string
Legal name / Razón Social (1-250 characters)
​
tax_system
string
Tax system code / Régimen Fiscal (e.g., “601”, “603”)
​
website
string
Organization website URL
​
support_email
string
Support email address
​
phone
string
Phone number (10-20 characters)
​
address
object
Organization address

​
Response

​
id
string
Organization ID
​
name
string
Organization name
​
razonSocial
string
Legal name (Razón Social)
​
regimenFiscalId
string
Tax system UUID
​
website
string
Organization website
​
phone
string
Phone number
​
selfInvoiceSupportEmail
string
Support email
​
addressStreet
string
Street name
​
addressExterior
string
Exterior number
​
addressInterior
string
Interior number
​
addressNeighborhood
string
Neighborhood
​
addressCity
string
City
​
addressMunicipality
string
Municipality
​
addressZip
string
ZIP code
​
addressState
string
State
​
updatedAt
string
Last update timestamp

​
Example Request

curl -X PUT "https://api.timbrix.com/organizations/550e8400-e29b-41d4-a716-446655440000/legal" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mi Empresa",
    "legal_name": "Mi Empresa S.A. de C.V.",
    "tax_system": "601",
    "website": "https://miempresa.com",
    "support_email": "soporte@miempresa.com",
    "phone": "+52 644 123 4567",
    "address": {
      "street": "Blvd. Atardecer",
      "exterior": 142,
      "interior": 4,
      "neighborhood": "Centro",
      "city": "Huatabampo",
      "municipality": "Huatabampo",
      "zip": 86500,
      "state": "Sonora"
    }
  }'

​
Response Codes

​
200
OK
Organization legal data updated successfully
​
400
Bad Request
Invalid input data or tax system code not found
​
401
Unauthorized
Authentication required
​
403
Forbidden
Access denied. Only organization owners can update legal data
​
404
Not Found
Organization not found

​
Security

⚠️ OWNER ONLY: Only the organization OWNER can update legal and fiscal information. Admins and members cannot perform this action.

​
Notes

  • All fields are optional - you can update only the fields you need to change
  • The tax_system field accepts tax regime codes (e.g., “601”, “603”) and automatically resolves to the corresponding UUID
  • If the tax system code doesn’t exist in the database, a 400 error will be returned
  • Address can be updated partially or completely