@teamleader/focus-api-specification 1.97.0 → 1.99.0

package/dist/api.focus.teamleader.eu.yaml

@@ -3,7 +3,7 @@ info:
   title: Teamleader API
   description: This is the documentation of the Teamleader Focus API. If you have any feedback, or are you missing functionality to support your use case? Let us know via [api@teamleader.eu](mailto:api@teamleader.eu).
   contact: {}
-  version: 1.97.0
+  version: 1.99.0
 servers:
   - url: https://api.focus.teamleader.eu
     variables: {}
@@ -832,6 +832,51 @@ paths:
                       - type: user
                         id: bef8c53b-b6bc-0fde-944e-5c4b16e5155a
       deprecated: false
+  /customFieldDefinitions.create:
+    post:
+      tags:
+        - custom_fields
+      summary: customFieldDefinitions.create
+      description: |
+        Create a custom field definition.
+
+        ***Required scopes:*** `settings`
+      operationId: customFieldDefinitions.create
+      parameters: []
+      requestBody:
+        description: ''
+        content:
+          application/json:
+            schema:
+              allOf:
+                - $ref: '#/components/schemas/customFieldDefinitions.createrequest'
+                - example:
+                    label: ''
+                    type: single_line
+                    context: contact
+            example:
+              label: ''
+              type: single_line
+              context: contact
+        required: true
+      responses:
+        '201':
+          description: ''
+          headers: {}
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: '#/components/schemas/customFieldDefinitions.createresponse'
+                  - example:
+                      data:
+                        type: customFieldDefinition
+                        id: 526960d3-8d49-4a71-9f62-7b8b74aef058
+              example:
+                data:
+                  type: customFieldDefinition
+                  id: 526960d3-8d49-4a71-9f62-7b8b74aef058
+      deprecated: false
   /customFieldDefinitions.list:
     post:
       tags:
@@ -15484,7 +15529,13 @@ paths:
       tags:
         - files
       summary: files.upload
-      description: Request the upload link for a file.
+      description: |
+        Request the upload link for a file.
+
+        The following remarks apply to `temporary` files:
+        - they exist for a maximum of 24 hours if not linked to an entity
+        - do not show up in any file overview
+        - are not included in external syncs
       operationId: files.upload
       parameters: []
       requestBody:
@@ -17225,6 +17276,26 @@ components:
                     - $ref: '#/components/schemas/TypeAndId'
                 description: ''
           description: ''
+    CustomFieldDefinitionType:
+      type: string
+      enum:
+        - single_line
+        - multi_line
+        - single_select
+        - multi_select
+        - date
+        - money
+        - auto_increment
+        - integer
+        - number
+        - boolean
+        - email
+        - telephone
+        - url
+        - company
+        - contact
+        - product
+        - user
     Context:
       title: Context
       enum:
@@ -17238,6 +17309,59 @@ components:
         - subscription
         - ticket
       type: string
+    customFieldDefinitions.createrequest:
+      title: customFieldDefinitions.createrequest
+      required:
+        - label
+        - type
+        - context
+      type: object
+      properties:
+        label:
+          type: string
+        type:
+          allOf:
+            - $ref: '#/components/schemas/CustomFieldDefinitionType'
+            - example: single_line
+        context:
+          allOf:
+            - $ref: '#/components/schemas/Context'
+            - example: contact
+        configuration:
+          type: object
+          description: |
+            - Use `options` when `type` is one of [`single_select`, `multi_select`]
+            - Use `default_value` when `type` is `auto_increment`
+            - Use `searchable` when `type` is one of [`single_line`, `company`, `integer`, `number`, `auto_increment`, `email`, `telephone`]
+          oneOf:
+            - type: object
+              title: options
+              properties:
+                options:
+                  type: array
+                  items:
+                    type: string
+            - type: object
+              title: default_value
+              properties:
+                default_value:
+                  type: number
+            - type: object
+              title: searchable
+              properties:
+                searchable:
+                  type: boolean
+    customFieldDefinitions.createresponse:
+      title: customFieldDefinitions.createresponse
+      type: object
+      properties:
+        data:
+          allOf:
+            - $ref: '#/components/schemas/TypeAndId'
+            - properties:
+                type:
+                  type: string
+                  example: customFieldDefinition
     customFieldDefinitions.listrequest:
       title: customFieldDefinitions.listrequest
       type: object
@@ -17285,25 +17409,7 @@ components:
                   - $ref: '#/components/schemas/Context'
                   - example: contact
               type:
-                type: string
-                enum:
-                  - single_line
-                  - multi_line
-                  - single_select
-                  - multi_select
-                  - date
-                  - money
-                  - auto_increment
-                  - integer
-                  - number
-                  - boolean
-                  - email
-                  - telephone
-                  - url
-                  - company
-                  - contact
-                  - product
-                  - user
+                $ref: '#/components/schemas/CustomFieldDefinitionType'
               label:
                 type: string
               group:
@@ -17354,25 +17460,7 @@ components:
                 - $ref: '#/components/schemas/Context'
                 - example: contact
             type:
-              type: string
-              enum:
-                - single_line
-                - multi_line
-                - single_select
-                - multi_select
-                - date
-                - money
-                - auto_increment
-                - integer
-                - number
-                - boolean
-                - email
-                - telephone
-                - url
-                - company
-                - contact
-                - product
-                - user
+              $ref: '#/components/schemas/CustomFieldDefinitionType'
             label:
               type: string
             group:
@@ -30088,6 +30176,8 @@ components:
                 - type
                 - id
             - properties:
+                id:
+                  description: Not required if `type` is `temporary`
                 type:
                   type: string
                   enum:
@@ -30098,6 +30188,7 @@ components:
                     - creditNote
                     - nextgenProject
                     - ticket
+                    - temporary
                   example: company
         folder:
           type: string

package/dist/changelog/20260129000000.md

@@ -0,0 +1,5 @@
+---
+category: addition
+---
+
+We added a new subject type `temporary` on `files.upload`.

package/dist/changelog/20260129180823.md

@@ -0,0 +1,5 @@
+---
+category: addition
+---
+
+We added the `customFieldDefinitions.create` endpoint.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@teamleader/focus-api-specification",
   "description": "Teamleader Focus API Specification",
-  "version": "1.97.0",
+  "version": "1.99.0",
   "author": "Teamleader <development@teamleader.eu> (https://www.teamleader.eu)",
   "bugs": {
     "url": "https://github.com/teamleadercrm/focus-api-specification/issues"