# Commands

Commands marked with  <img src="https://716291898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY3lX6OpIZgZbOFMvR2eR%2Fuploads%2F6sqDbAVncTZJTpCUHwI4%2Fcrown%2B.png?alt=media&#x26;token=0e5abe26-7690-4d45-b058-eb99eb79d063" alt="" data-size="original"> are Premium only commands

### Commands for user

<table data-full-width="false"><thead><tr><th width="181">Command</th><th width="314">Arguments</th><th>Explanation</th></tr></thead><tbody><tr><td>/help </td><td></td><td>Shows optional help</td></tr><tr><td>/info</td><td><p><em>optional:</em> </p><p><em><code>user: &#x3C;user></code></em></p></td><td>Displays information about you, or if a user is provided details about themselves.</td></tr><tr><td>/leaderboard</td><td></td><td>Shows the leaderboard with the Time from everybody.</td></tr><tr><td>/overview</td><td></td><td>Shows everyone who is clocked in.</td></tr><tr><td>/timerequest <img src="https://716291898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY3lX6OpIZgZbOFMvR2eR%2Fuploads%2F6sqDbAVncTZJTpCUHwI4%2Fcrown%2B.png?alt=media&#x26;token=0e5abe26-7690-4d45-b058-eb99eb79d063" alt="" data-size="original"></td><td><p><em>required:</em> </p><p><em><code>action: &#x3C;</code></em><a href="#actiontypes"><em><code>ActionTypes</code></em></a><em><code>></code></em><br><em><code>minutes: &#x3C;number></code></em><br><em><code>reason: &#x3C;string></code></em><br> </p><p><em><strong>optional:</strong></em><br><em><code>proof-link: &#x3C;string></code></em><br><em><code>proof-file: &#x3C;File></code></em></p></td><td>Request a timechange (removal or getting of time), you can also provide proof. An Admin can review your request. After reviewing the user gets an notification if his timerequest was accepted or declined. Also he get the time that he requested.</td></tr></tbody></table>

### Commands for administrators

<table data-full-width="false"><thead><tr><th width="152">Command</th><th width="276">Arguments</th><th>Explanation</th></tr></thead><tbody><tr><td>/cleanup</td><td></td><td>Deletes User that are still in database but not on the server.</td></tr><tr><td>/employee</td><td><p><em>required:</em> </p><p><em><code>user: &#x3C;user></code></em></p><p><em><code>action: &#x3C;</code></em><a href="#actiontypes"><em><code>ActionTypes</code></em></a><em><code>></code></em></p></td><td>Manage employees</td></tr><tr><td>/reset</td><td><p><em>required:</em> </p><p><em><code>user: &#x3C;user></code></em></p></td><td>Deletes an user completely and resets their times.</td></tr><tr><td>/tracking</td><td><p><em>required:</em> </p><p><em><code>action: &#x3C;</code></em><a href="#actiontypes"><em><code>ActionTypes</code></em></a><em><code>></code></em></p></td><td>Sends an message where the user can clock in and out.</td></tr><tr><td>/time</td><td><p><em>required:</em> </p><p><em><code>action: &#x3C;</code></em><a href="#actiontypes"><em><code>ActionTypes</code></em></a><em><code>></code></em></p><p><em><code>user: &#x3C;user></code></em></p><p><em><code>amount: &#x3C;number></code></em></p></td><td>Add or remove specified amount of time to/from an user.</td></tr><tr><td>/language</td><td>required: <br><code>language: &#x3C;"en" | "de"></code></td><td>Changes language to selected language.</td></tr><tr><td>/warn <img src="https://716291898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY3lX6OpIZgZbOFMvR2eR%2Fuploads%2F6sqDbAVncTZJTpCUHwI4%2Fcrown%2B.png?alt=media&#x26;token=0e5abe26-7690-4d45-b058-eb99eb79d063" alt="" data-size="original"></td><td><p><em>required:</em> </p><p><em><code>user: &#x3C;user></code></em><br><em><code>action: &#x3C;</code></em><a href="#actiontypes"><em><code>ActionTypes</code></em></a><em><code>></code></em></p></td><td>Warn, delete warns or see warns from a user.</td></tr><tr><td>/role <img src="https://716291898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY3lX6OpIZgZbOFMvR2eR%2Fuploads%2F6sqDbAVncTZJTpCUHwI4%2Fcrown%2B.png?alt=media&#x26;token=0e5abe26-7690-4d45-b058-eb99eb79d063" alt="" data-size="original"></td><td><p><em>required:</em> </p><p><em><code>role: &#x3C;Role></code></em></p><p><em><code>action: &#x3C;</code></em><a href="#actiontypes"><em><code>ActionTypes</code></em></a><em><code>></code></em></p></td><td>Bulk operations that will perfom an actions to all users that have the specified role.</td></tr><tr><td>/weekstart <img src="https://716291898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY3lX6OpIZgZbOFMvR2eR%2Fuploads%2F6sqDbAVncTZJTpCUHwI4%2Fcrown%2B.png?alt=media&#x26;token=0e5abe26-7690-4d45-b058-eb99eb79d063" alt="" data-size="original"></td><td><p><em>required:</em> </p><p><em><code>start: &#x3C;</code></em>Day<em><code>></code></em></p></td><td>Change when a week resets, if you want that a new week starts on a other day then sunday.</td></tr></tbody></table>

### Actiontypes

<table><thead><tr><th width="154">command</th><th>Action</th><th>Explanation</th></tr></thead><tbody><tr><td>/employee</td><td>hire</td><td>Allow user to track their time.</td></tr><tr><td>/employee</td><td>fire</td><td>Disable user tracking</td></tr><tr><td>/employee</td><td>stop tracking</td><td>Pause the clocked in time from the user. The user gets the time, which he stamped.</td></tr><tr><td>/employee</td><td>cancel tracking</td><td>Abort the clocked in time from the user. The Time is not counted.</td></tr><tr><td>/tracking</td><td>generate default embed</td><td>Generates the default embed, where users can clock in or out.</td></tr><tr><td>/tracking</td><td>pause general tracking</td><td>all users get clocked out, but they get their tracked time</td></tr><tr><td>/tracking</td><td>cancel general tracking</td><td>all users get clocked out, but they dont get their tracked time</td></tr><tr><td>/time</td><td>add time</td><td>Adds specified time to the user</td></tr><tr><td>/time</td><td>remove time</td><td>Removes specified time from the user</td></tr><tr><td>/warn</td><td>warn user</td><td>Warn a user (warn modal). Specify reason and duration.</td></tr><tr><td>/warn</td><td>remove warn</td><td>Opens a select menu, where you can select a warn to delete</td></tr><tr><td>/warn</td><td>show warns</td><td>Show all active warnings from user</td></tr><tr><td>/role</td><td>hire everyone with role</td><td>Everyone who has the specified role will be hired</td></tr><tr><td>/role</td><td>fire everyone with role</td><td>Everyone who has the specified role will be fired</td></tr><tr><td>/timerequest</td><td>get time</td><td>Your request is to get time</td></tr><tr><td>/timerequest</td><td>get time removed</td><td>Your request is to get time removed</td></tr></tbody></table>


---

# 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://docs.timecord.dev/en/guide/commands.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.