Skip to main content
PUT
/
companies
/
{companyId}
/
employees
/
{employeeId}
/
limits
/
punctual
Set a punctual limit for a specific payroll cycle
curl --request PUT \
  --url https://pre-partners-api.cobee.io/api/v3/companies/{companyId}/employees/{employeeId}/limits/punctual \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "payroll": "<string>",
  "meal": {
    "amount": {
      "amountInCents": 10000,
      "currency": "EUR"
    },
    "appliesTo": "employee",
    "period": "payroll"
  },
  "transport": {
    "amount": {
      "amountInCents": 5000,
      "currency": "EUR"
    },
    "appliesTo": "employee",
    "period": "payroll"
  },
  "nursery": {
    "amount": {
      "amountInCents": 15000,
      "currency": "EUR"
    },
    "appliesTo": "employee",
    "period": "payroll"
  }
}
'
{
  "message": "Bad request: Invalid field value"
}

​
Overview

This endpoint allows you to set a punctual limit for an employee’s benefits strictly during the current payroll cycle. Unlike the PUT recurrent limits endpoint, making a punctual limits update here will only affect the specified current payroll period.

​
Mechanics

  • Independent: Punctual limits do not require a recurrent limit to exist. They operate independently.
  • Current Cycle Only: To set a punctual limit, you must provide the precise payroll identifier (e.g., 2026-05). This identifier must correspond to the current ongoing payroll cycle.
  • Precedence: If an employee has both a recurrent limit and a punctual limit configured for the exact same month, the punctual limit will always prevail and be the active limit for that cycle.
If you attempt to set a punctual limit for a future or past payroll cycle, the API will reject the request. This is particularly useful when you need to momentarily increase or decrease a limit for the current month without modifying the base recurrent limit.
For a detailed explanation of how limits and payroll cycles are evaluated, please refer to the Overview page.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
companyId
string<uuid>
required

The company identifier

​
employeeId
string
required

The employee identifier

Body

application/json
​
payroll
string
required

The current payroll cycle identifier (format YYYY-MM) this punctual limit applies to. Future or past payrolls are not allowed.

​
meal
object
​
transport
object
​
nursery
object

Response

Punctual limit successfully created or updated