> For the complete documentation index, see [llms.txt](https://docs.octoo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.octoo.com/providers/jobs.md).

# Jobs

After a provider has expressed interest in an opportunity they are assigned to the job at the customer or partner's discretion. When a provider is assigned they will receive a job confirmation email with details including team members' names.

Providers can view their upcoming jobs (and job history) at: [https://app.octoo.com/jobs](https://app.octoo.com/opportunities).

## Job statuses

Each job has a status that reflects where it stands in the assignment process.

| Status                 | Description                                                                                                             |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Pending**            | The provider has expressed interest in the opportunity but has not yet been assigned.                                   |
| **Awarded**            | The provider has been assigned to the job and is confirmed to provide services.                                         |
| **Contingent**         | The provider has been assigned but the assignment is contingent on finding additional team members.                     |
| **Replacement sought** | The provider is currently assigned but has requested to be replaced. Their partner is working on finding a replacement. |
| **Cancelled**          | The provider has been removed from a job they were previously assigned to.                                              |
| **Declined**           | The provider declined the opportunity and is not interested in providing services.                                      |

## Viewing upcoming jobs

Providers can navigate to their upcoming jobs from the dashboard or by visiting the [/jobs](https://app.octoo.com/jobs) section. When navigating from the dashboard, filters will be initialized to show all upcoming jobs.

<figure><img src="/files/XGWUfzAtkqIu562hs28Q" alt="" width="375"><figcaption><p>Use filters to review all job history</p></figcaption></figure>

To see only this week's jobs, providers can navigate to "My jobs this week".

## Removing from a job

If a provider can no longer provide services for a job they have been assigned, they will need to initialize the job cancellation workflow.

The provider should find the job through the [/jobs](https://app.octoo.com/jobs) section and select the three dots to the right to expose the contextual menu and choose "Cancel job".

From there, the provider will need to answer a few questions and their cancellation request will be submitted to their partner. The partner will begin working on processing the cancellation and notifying the requester and team of the provider's absence.

<figure><img src="/files/pWqBxLEk4vsClTsWMIvy" alt="Screen shot of the modal window asking for a cancellation reason and message to the requester" width="375"><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.octoo.com/providers/jobs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
