# Monday

### Prerequisites

* A Monday account with access to view all workspaces/boards you want to sync with Coworker.

{% hint style="info" %}

## API token permissions

Each personal token can only do actions that the user can do in the UI. For example, if a user cannot access a particular private board, the API token will not be able to access that data either. This extends to any [column](https://support.monday.com/hc/en-us/articles/360011926640-Column-permissions), [item](https://support.monday.com/hc/en-us/articles/360021172320-Item-viewing-permissions-), or [account permissions](https://support.monday.com/hc/en-us/articles/360003457320-Account-permissions) that apply to a user.
{% endhint %}

### Generating the credentials

**API for admins users** 

Each admin on the account has their own API Token -- make sure to keep this safe! To generate your API Token: 

1. Log into your monday.com account.
2. Click on your avatar in the top right corner.
3. Select "Administration."
4. Click "Connections" on the left side of the admin page. 
5. Select "API" in the top menu. 
6. Click "Generate" in the top right.
7. Click on the "Copy" button to the right of the personal API Token. This is what you should be looking at:

<figure><img src="https://3561055466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcl1KIMhPQkmG41x5eGvL%2Fuploads%2FBZT0gFsdwIpMSCUDIkDb%2Fimage.png?alt=media&#x26;token=f5bfe129-0fac-4b34-bb8c-a895099a0007" alt=""><figcaption></figcaption></figure>

**API for non-admin users**

If you are not an admin of your monday.com account, you can get your API Tokens via the developers' section, following these steps:&#x20;

1. Log into your monday.com account.
2. Click on your avatar in the top right corner.
3. Select "Developers."
4. Click "Developer" and then "My Access Tokens" at the top.&#x20;
5. By selecting "Show" next to the API token, you'll then be able to copy it as well.&#x20;

### Information required for the Coworker connection:

* `auth_token`: The access token created above
* `start_date`: Date of the first record to synchronize, in a ISO8601 format (eg. `2024-01-01`) . Commits before this date will not be synchronized.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://village-labs.gitbook.io/coworker-product-and-developer-docs/data-connections/monday.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.