---
title: "Using Personal Access Tokens (PAT)"
slug: "usingpersonalaccesstokenspat"
updated: 2026-04-13T02:15:55Z
published: 2026-04-13T02:15:55Z
canonical: "help.12dsynergy.com/usingpersonalaccesstokenspat"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.12dsynergy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Personal Access Tokens (PAT)

> [!TIP]
> - 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](/v1/docs/createpersonalaccesstokenpatforanappdoc)

### 1.1. Using Personal Access Tokens (PAT)

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**

```SampleRequest
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 ![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/expand.png) in the line below to see the code.

****Sample Response****

```SampleResponse
{

    "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](/v1/docs/findjobbynamedoc)