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

# v2.42.0 - TMS Invitation Permissions

> Permissions field added to TMS invitation endpoints

**Released 19th August 2026**

## TMS Invitation Permissions

This release adds a `permissions` field to the TMS invitation schema, giving you finer-grained control over what access is granted when inviting a TMS partner to your organization.

<Check>
  **Backward-compatible addition:** Existing integrations continue to work without changes. The `permissions` field is optional in request bodies and will now be present in all TMS invitation responses.
</Check>

### TMS invitation changes

<AccordionGroup>
  <Accordion title="Permissions field added to TMS invitations" icon="key">
    The `permissions` field has been added to the `TmsInvitation` schema. It is now returned in all TMS invitation responses and can optionally be provided when creating an invitation.

    **Affected endpoints:**

    | Method | Endpoint |
    | - | - |
    | `GET` | `/v2/orgs/tms-invitations` |
    | `POST` | `/v2/orgs/tms-invitations` |
    | `GET` | `/v2/orgs/tms-invitations/{tms_invitation_id}` |
    | `PATCH` | `/v2/orgs/tms-invitations/{tms_invitation_id}` |
    | `POST` | `/v2/orgs/tms-invitations/{tms_invitation_id}/accept` |
    | `POST` | `/v2/orgs/tms-invitations/{tms_invitation_id}/decline` |

    **Request body (POST `/v2/orgs/tms-invitations`):**

    The `permissions` field is now accepted as an optional property when creating a TMS invitation.

    ```json theme={null}
    {
      "permissions": ["read:vehicles", "read:drivers"]
    }
    ```

    **Response (all TMS invitation endpoints):**

    The `permissions` field is now included as a required field in all TMS invitation responses.

    ```json theme={null}
    {
      "tms_invitation_id": "inv_123",
      "permissions": ["read:vehicles", "read:drivers"],
      "status": "pending"
    }
    ```
  </Accordion>
</AccordionGroup>

***

## Need help?

<CardGroup cols={2}>
  <Card title="API Reference" icon="book" href="/api-reference/organizations-api">
    View complete endpoint documentation for the Organizations API
  </Card>

  <Card title="Contact Support" icon="life-ring" href="mailto:support@catenaclearing.io">
    Questions about your integration? Our team is here to help
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.