Using Personal Access Tokens (PAT)

Prev Next
  • We recommend using Personal Access Tokens (PATs) for authentication.

  • PATs provide stronger security, easier token management, and better compatibility with modern systems.

Now that you have the PAT from this step: Create a Personal Access Token (PAT) for an App

You can easily access the API by adding it as a Bearer token in the Authorization header of your API request. This allows you to securely access the API without using a username or password.

Below is an example:

Sample Request

curl --location 'http://synergy.myserver.com/api/v1/jobs/?name=test&page=1&page_size=20' \
--header 'Authorization: Bearer <your-token-here>' \
--header 'Content-Type: application/json' 

Click  in the line below to see the code.

Sample Response

{

    "PageNumber": 1,

    "PageSize": 20,

    "TotalRows": 1,

    "TotalPages": 1,

    "Result": [

        {

            "ID": {

                "_id": 40009,

                "_server_id": 1,

                "_server_guid": "b993c729-bf98-490c-989d-5621e3b48139",

                "IDString": "40009_1"

            },

            "Name": "Test",

            "Description": "",

            "JobCreatorName": "",

            "CreatedDate": "2025-06-23T13:00:30.42",

            "NoOfChildren": 0,

            "NoOfFolders": 3,

            "NoOfTDJobs": 0,

            "InheritPermissions": true,

            "InheritFileNamingRules": false,

            "AlwaysDisplayParent": false,

            "DeleteLocked": false,

            "Type": "Normal",

            "CreatorID": {

                "_id": 1,

                "_server_id": 1,

                "_server_guid": "b993c729-bf98-490c-989d-5621e3b48139",

                "IDString": "1_1"

            },

            "ParentJobID": null,

            "Attributes": [],

            "JobItems": null,

            "NoOfNotes": 0,

            "Path": "Test",

            "EntityObject": {

                "parent_project_id": null,

                "creator_name": "",

                "num_children": 0,

                "num_folders": 3,

                "num_td_projects": 0,

                "inherit_permissions": true,

                "always_display_parent": false,

                "rule_set": null,

                "inherits_file_naming_rules": false,

                "inherits_triggers_from_parent": false,

                "delete_locked": false,

                "cad_publish_output_path": null,

                "customisation_info": null,

                "form_attachments": null,

                "id": {

                    "_id": 40009,

                    "_server_id": 1,

                    "_server_guid": "b993c729-bf98-490c-989d-5621e3b48139",

                    "IDString": "40009_1"

                },

                "name": "Test",

                "create_date": "2025-06-23T13:00:30.42",

                "creator_id": {

                    "_id": 1,

                    "_server_id": 1,

                    "_server_guid": "b993c729-bf98-490c-989d-5621e3b48139",

                    "IDString": "1_1"

                },

                "attributes": [],

                "description": "<HTML><HEAD>\r\n<META name=GENERATOR content=\"MSHTML 11.00.10570.1001\"></HEAD>\r\n<BODY></BODY></HTML>",

                "type": 0

            }

        }

    ]

}

This request can also be seen here: Find job by name