> ## Documentation Index
> Fetch the complete documentation index at: https://developer.mogl.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Athlete Availability Confirmation and Contract Cancellation

> Learn how athletes confirm or decline availability for a deal, what brands see in each case, and how to cancel a contract when plans change.

Before work begins on a deal, MOGL asks the hired athlete to confirm they're available and ready to proceed. This step protects both parties — it ensures the athlete is genuinely prepared to deliver, and it gives the brand confidence before the campaign kicks off. If availability cannot be confirmed, or if circumstances change after a contract is active, MOGL provides a clear path to cancel the contract for both athletes and brands.

## What is availability confirmation?

After an athlete is hired for a deal, they receive a request to confirm their availability. This happens before any deliverables are due, giving the athlete a chance to acknowledge the deal details and commit to the timeline. Until the athlete confirms, the deal is in a pending state.

Availability confirmation is a formal step — not just a UI flag. It updates the deal's status and triggers notifications to the relevant parties.

## How athletes confirm or decline availability

<Tabs>
  <Tab title="Mobile app">
    Athletes receive a push notification when availability confirmation is required. Opening the notification takes you directly to the deal details screen, where you can review the deliverables, timeline, and compensation before responding.

    <Steps>
      <Step title="Open the availability request">
        Tap the notification or navigate to **My Deals** and look for deals with a pending confirmation badge.
      </Step>

      <Step title="Review the deal details">
        Check the deliverables, due dates, and compensation. Make sure the timeline works for you before confirming.
      </Step>

      <Step title="Confirm or decline">
        Tap **Confirm Availability** to accept, or use the decline option if you're unable to proceed. If you decline, the deal returns to the brand for reassignment.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Web">
    On the web platform, pending availability confirmations appear in your deals dashboard. Deals waiting for your confirmation are clearly marked.

    <Steps>
      <Step title="Go to My Deals">
        Navigate to your deals dashboard. Deals pending your availability confirmation are listed at the top or highlighted.
      </Step>

      <Step title="Review and respond">
        Open the deal and review the details. Select **Confirm** or **Decline** to submit your response.
      </Step>
    </Steps>
  </Tab>
</Tabs>

To retrieve all deals currently waiting for your availability confirmation:

```http theme={"dark"}
GET /athlete/pending-jobs-for-confirmation
```

| Query parameter | Description                               |
| --------------- | ----------------------------------------- |
| `job_id`        | Filter by a specific deal ID (optional)   |
| `limit`         | Number of results per page (default: 100) |

To submit your availability confirmation:

```http theme={"dark"}
POST /athlete/confirm-the-availability
```

| Field    | Description                                     |
| -------- | ----------------------------------------------- |
| `job_id` | The ID of the deal you're confirming (required) |

<Note>
  For single-hire deals, confirming your availability automatically declines the other applicants for that position. This is handled automatically — you don't need to take any additional steps.
</Note>

### For agents confirming on behalf of an athlete

If you manage athletes through an agent account, you can confirm availability on their behalf:

```http theme={"dark"}
POST /agent/confirm-the-availability
```

| Field        | Description                      |
| ------------ | -------------------------------- |
| `job_id`     | The deal ID (required)           |
| `athlete_id` | The athlete's user ID (required) |

To see all pending confirmations across your roster:

```http theme={"dark"}
GET /agent/athlete-pending-jobs-for-confirmation
```

## What brands and partners see

Once an athlete responds to the availability request, the deal's status updates immediately and you'll receive a notification.

| Athlete response | What you see                                                    |
| ---------------- | --------------------------------------------------------------- |
| **Confirmed**    | Deal status updates to active; work can proceed                 |
| **Declined**     | Deal returns to open status; you can invite a different athlete |
| **No response**  | Deal remains in pending state; you may follow up or reassign    |

<Tip>
  If an athlete hasn't responded to an availability request within a reasonable timeframe, contact MOGL support — they can review the deal status and help you proceed.
</Tip>

## Cancelling a contract

Either party can initiate a contract cancellation if circumstances change after a contract becomes active. Cancellation is a formal process that updates the deal status, notifies all involved parties, and handles any pending payment milestones.

<Warning>
  Cancelling an active contract cannot be undone. Make sure you've reviewed the deal details and confirmed the cancellation is appropriate before proceeding. Pending milestone payments are cancelled as part of this process.
</Warning>

### How to cancel a contract (brands and partners)

<Steps>
  <Step title="Locate the active contract">
    Go to your deals dashboard and open the deal you need to cancel.
  </Step>

  <Step title="Select Cancel Contract">
    Find the cancellation option in the deal actions menu. You'll be asked to provide a reason for the cancellation.
  </Step>

  <Step title="Confirm the cancellation">
    Review the details and confirm. The cancellation takes effect immediately.
  </Step>
</Steps>

To cancel a contract via API:

```http theme={"dark"}
POST /partner/cancel-the-contract
```

| Field              | Description                                             |
| ------------------ | ------------------------------------------------------- |
| `job_id`           | The deal ID (required)                                  |
| `athlete_id`       | The athlete's user ID (required)                        |
| `cancelled_reason` | The reason for cancellation (required)                  |
| `surface`          | The platform where cancellation is initiated (required) |

### What happens after cancellation

When a contract is cancelled:

* The contract status is updated to **cancelled**
* Pending milestone payments are voided
* Both the brand and the athlete receive notifications via email, SMS, and in-app
* For single-athlete positions, the deal is reset so you can invite a new athlete if needed
* A cancellation reason is recorded and visible to MOGL support for audit purposes

## Dismissing a pending contract request

If an athlete has submitted a pending contract request (such as a cancellation or due date extension request) that you want to reject without cancelling the full contract, you can dismiss it:

```http theme={"dark"}
POST /partner/dismiss-contract-request
```

| Field        | Description                      |
| ------------ | -------------------------------- |
| `job_id`     | The deal ID (required)           |
| `athlete_id` | The athlete's user ID (required) |

Dismissing a request rejects the athlete's pending ask and removes it from the queue. It does not affect the active contract itself.

## Notifications during this process

MOGL sends multi-channel notifications (in-app, email, and SMS) at the following points:

| Event                               | Who is notified                  |
| ----------------------------------- | -------------------------------- |
| Availability confirmation requested | Athlete                          |
| Athlete confirms availability       | Brand / partner                  |
| Athlete declines availability       | Brand / partner                  |
| Contract cancelled                  | Both athlete and brand / partner |
| Contract request dismissed          | Athlete                          |