Skip to Content
TillorManuel
Occupations

Create Occupation

Accès

Membre de l’organisation avec cette autorisation :

  • terrains:write

Une clé API avec des scopes doit aussi avoir l’autorisation dans ses scopes.

POST
/orgs/{organizationId}/occupations

Creates a new occupation (optional description, paid until and invoiced until).

Authorization

ApiKeyAuth
headerx-api-key<token>

API key for authentication

Path Parameters

organizationId*string

The ID or slug of the organization

Request Body

application/json
  1. body
customerId*string
terrainId*string
occupationType?string
Value in"OWN_ACCOMMODATION""RENTAL_CARAVAN"
rentPeriod?
price?number|null
description?string|null
paidUntil?string
Formatdate-time
invoicedUntil?string
Formatdate-time
startReadings?array<>
customFields?

Response Body

OK

application/json
  1. response
Example Request
curl -X POST 'https://api.tillor.eu/orgs//occupations' \  -H 'Content-Type: application/json' \  -d '{  "customerId": "string",  "terrainId": "string"}'
Example Response
null

List Occupations GET

Lists occupations with pagination, filtering, sorting, and includes. Supports filtering by customer, terrain, reservation, and paidUntil date range.

Get Occupation GET

Gets a single occupation by ID with optional includes.