@teamleader/focus-api-specification 1.15.0 → 1.16.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.15.0
+  version: 1.16.0
 servers:
   - url: https://api.focus.teamleader.eu
     variables: {}
@@ -233,6 +233,12 @@ tags:
 
       ***Required scopes:*** `projects`
     x-displayName: Projects
+  - name: external_parties
+    description: |
+      > An external party is a contact or company that is added to a project with an optional function and/or sub function.
+
+      ***Required scopes:*** `projects`
+    x-displayName: External parties
   - name: project_lines
     description: |
       > A project line can be a group, a task, or a material.
@@ -9197,6 +9203,13 @@ paths:
                         legacy_project:
                           type: project
                           id: 624ca743-8998-4f8c-add1-c427bb022166
+                        external_parties:
+                          id: f7fcf4eb-583c-4e6b-88be-2a9e83afdb81
+                          customer:
+                            type: contact
+                            id: 66abace2-62af-0836-a927-fe3f44b9b47b
+                          function: Sales representative
+                          sub_function: Teamleader Focus FR
               example:
                 data:
                   id: 49b403be-a32e-0901-9b1c-25214f9027c6
@@ -9291,6 +9304,13 @@ paths:
                   legacy_project:
                     type: project
                     id: 624ca743-8998-4f8c-add1-c427bb022166
+                  external_parties:
+                    - id: f7fcf4eb-583c-4e6b-88be-2a9e83afdb81
+                      customer:
+                        type: contact
+                        id: 66abace2-62af-0836-a927-fe3f44b9b47b
+                      function: Sales representative
+                      sub_function: Teamleader Focus FR
       deprecated: false
   /projects-v2/projects.create:
     post:
@@ -9926,6 +9946,104 @@ paths:
           headers: {}
           content: {}
       deprecated: false
+  /projects-v2/externalParties.addToProject:
+    post:
+      tags:
+        - external_parties
+      summary: externalParties.addToProject
+      description: Add an external party to a project.
+      operationId: NextgenProjectsExternalParties.addToProject
+      parameters: []
+      requestBody:
+        description: ''
+        content:
+          application/json:
+            schema:
+              allOf:
+                - $ref: '#/components/schemas/projects-v2_externalParties.addToProjectrequest'
+                - example:
+                    project_id: 48ef99b9-4a20-4071-888d-0927f45c03d5
+                    customer:
+                      type: contact
+                      id: adfec6b9-a8d7-403d-bde3-093ad50d74c2
+                    function: Sales representative
+                    sub_function: Teamleader Focus Sales FR
+            example:
+              project_id: 48ef99b9-4a20-4071-888d-0927f45c03d5
+              customer:
+                type: contact
+                id: adfec6b9-a8d7-403d-bde3-093ad50d74c2
+              function: Sales representative
+              sub_function: Teamleader Focus Sales FR
+        required: true
+      responses:
+        '204':
+          description: ''
+          headers: {}
+          content: {}
+      deprecated: false
+  /projects-v2/externalParties.update:
+    post:
+      tags:
+        - external_parties
+      summary: externalParties.update
+      description: Update an external party.
+      operationId: NextgenProjectsExternalParties.update
+      parameters: []
+      requestBody:
+        description: ''
+        content:
+          application/json:
+            schema:
+              allOf:
+                - $ref: '#/components/schemas/projects-v2_externalParties.updaterequest'
+                - example:
+                    id: 48ef99b9-4a20-4071-888d-0927f45c03d5
+                    customer:
+                      type: contact
+                      id: adfec6b9-a8d7-403d-bde3-093ad50d74c2
+                    function: Sales representative
+                    sub_function: null
+            example:
+              id: 48ef99b9-4a20-4071-888d-0927f45c03d5
+              customer:
+                type: contact
+                id: adfec6b9-a8d7-403d-bde3-093ad50d74c2
+              function: Sales representative
+              sub_function: null
+        required: true
+      responses:
+        '204':
+          description: ''
+          headers: {}
+          content: {}
+      deprecated: false
+  /projects-v2/externalParties.delete:
+    post:
+      tags:
+        - external_parties
+      summary: externalParties.delete
+      description: Delete an external party.
+      operationId: NextgenProjectsExternalParties.delete
+      parameters: []
+      requestBody:
+        description: ''
+        content:
+          application/json:
+            schema:
+              allOf:
+                - $ref: '#/components/schemas/projects-v2_externalParties.deleterequest'
+                - example:
+                    id: 48ef99b9-4a20-4071-888d-0927f45c03d5
+            example:
+              id: 48ef99b9-4a20-4071-888d-0927f45c03d5
+        required: true
+      responses:
+        '204':
+          description: ''
+          headers: {}
+          content: {}
+      deprecated: false
   /projects-v2/projectLines.list:
     post:
       tags:
@@ -23506,6 +23624,22 @@ components:
                     type:
                       type: string
                       example: project
+            external_parties:
+              type: array
+              items:
+                type: object
+                properties:
+                  id:
+                    type: string
+                    example: e80e3e0f-4008-47cc-aa94-3d71a42052bf
+                  customer:
+                    $ref: '#/components/schemas/Customer'
+                  function:
+                    type: string
+                    example: Sales representative
+                  sub_function:
+                    type: string
+                    example: Teamleader Focus FR
     projects-v2.createrequest:
       title: projects-v2.createrequest
       required:
@@ -23954,6 +24088,52 @@ components:
         quotation_id:
           type: string
           example: 8385b072-587f-4ebf-a32b-5f48baea1b1c
+    projects-v2_externalParties.addToProjectrequest:
+      title: projects-v2_externalParties.addToProjectrequest
+      required:
+        - project_id
+        - customer
+      type: object
+      properties:
+        project_id:
+          type: string
+          example: 7257b535-d40f-4699-b3bd-63679379b579
+        customer:
+          $ref: '#/components/schemas/Customer'
+        function:
+          type: string
+          example: Project Manager
+        sub_function:
+          type: string
+          example: Project Coordinator
+    projects-v2_externalParties.updaterequest:
+      title: projects-v2_externalParties.updaterequest
+      required:
+        - id
+      type: object
+      properties:
+        id:
+          type: string
+          example: 6126596f-6193-445a-935a-60c10df9f632
+        customer:
+          $ref: '#/components/schemas/Customer'
+        function:
+          type: string
+          example: Project Manager
+          nullable: true
+        sub_function:
+          type: string
+          example: Project Coordinator
+          nullable: true
+    projects-v2_externalParties.deleterequest:
+      title: projects-v2_externalParties.deleterequest
+      required:
+        - id
+      type: object
+      properties:
+        id:
+          type: string
+          example: 6126596f-6193-445a-935a-60c10df9f632
     projects-v2_projectLines.listrequest:
       title: projects-v2_projectLines.listrequest
       required:
@@ -28115,6 +28295,7 @@ x-tagGroups:
   - name: New Projects
     tags:
       - projects
+      - external_parties
       - project_lines
       - groups
       - projects_v2_tasks

package/dist/changelog/20250603155700.md

@@ -0,0 +1,5 @@
+---
+category: addition
+---
+
+We added the `projects-v2/externalParties.addToProject`, `projects-v2/externalParties.update` and `projects-v2/externalParties.delete` endpoints.

package/package.json

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