# Submit A Civitas Request

Use this guide to submit a PTO or HR request in Civitas.

## Before you start

* You need access to the Civitas module.
* For PTO requests, confirm leave types are configured in your organization.

## Steps

1. Open `App > Civitas`.
2. In the `Personal` tab, expand `Create new Civitas request`.
3. Select `Request type`:
   * PTO request
   * Certificate request
   * HR request
   * General request
4. Complete required fields:
   * PTO: leave type + start/end date
   * Other types: title/description context
5. Set `Point of contact user` and `Manager` if needed.
6. Add optional attachments:
   * Add link, or
   * Upload file
7. Click `Submit request`.
8. Confirm success message and verify the request appears in `Latest requests`.

## What happens next

* The request enters the Civitas queue.
* If direct manager logic is configured, PTO requests can auto-assign to a manager.
* Your request status updates as it moves through processing.

## If something does not work

* Missing leave types: ask an org admin to configure them in `Organization settings > Civitas settings`.
* Submit blocked: check required fields (especially PTO dates).
* Attachment issues: retry with a valid URL or re-upload the file.

## Screenshot Checklist (GitBook Publishing)

* [ ] Capture `Personal` tab with `Create new Civitas request` expanded.
* [ ] Capture a completed request form before submit.
* [ ] Capture successful submission state in `Latest requests`.
* [ ] Capture ticket details view with status and comments area.
* [ ] Redact names, emails, IDs, and any personal documents.

## Screenshot Placeholders

* `TG-CIVITAS-REQUEST-01-context`: Civitas personal tab and request panel.
* `TG-CIVITAS-REQUEST-02-action`: Request form completed before submit.
* `TG-CIVITAS-REQUEST-03-result`: Request visible in `Latest requests`.
* `TG-CIVITAS-REQUEST-04-detail` (optional): Ticket detail page with comments/attachments.


---

# 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://xdbx.gitbook.io/axon/task-guides/submit-a-civitas-request.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.