> ## 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.1.0 - Partner Properties & Schema Updates

> Partner properties endpoints now public, updated partner schema, and refined security scopes

**Released 17th December 2025**

This minor release makes partner properties endpoints publicly available, streamlines the partner update schema, and refines security scopes for better access control.

<Check>
  **Minor Release:** This release includes breaking changes to the `PartnerUpdate` schema and introduces new public endpoints for partner properties management.
</Check>

## New Public Endpoints

<AccordionGroup>
  <Accordion title="Partner Properties Management" icon="list">
    Three partner properties endpoints are now publicly available:

    **Added:**

    * `GET /v2/orgs/partners/{partner_id}/properties` - List partner properties
    * `POST /v2/orgs/partners/{partner_id}/properties` - Create partner properties
    * `DELETE /v2/orgs/partners/{partner_id}/properties/{property_id}` - Delete partner property

    These endpoints were previously excluded from the public API and are now available for managing custom partner metadata.

    **Example Usage:**

    ```bash theme={null}
    # List all properties for a partner
    GET /v2/orgs/partners/{partner_id}/properties

    # Create a new property
    POST /v2/orgs/partners/{partner_id}/properties
    {
      "key": "custom_field",
      "value": "custom_value"
    }

    # Delete a property
    DELETE /v2/orgs/partners/{partner_id}/properties/{property_id}
    ```

    <Info>If you need to update existing properties, please use the delete endpoint followed by create.</Info>
  </Accordion>

  <Accordion title="Partner Update Endpoint" icon="wrench">
    **Added:**

    * `PATCH /v2/orgs/partners/{partner_id}` - Update partner details
  </Accordion>
</AccordionGroup>

## Security Scope Changes

<AccordionGroup>
  <Accordion title="Partner Properties Scopes Refined" icon="shield">
    **Updated Scopes:**

    | Endpoint | Old Scope | New Scope |
    | - | - | - |
    | `GET /v2/orgs/partners/{partner_id}/properties` | `partner:read` | `partner-property:read` |
    | `POST /v2/orgs/partners/{partner_id}/properties` | `partner:create` | `partner-property:create` |
    | `DELETE /v2/orgs/partners/{partner_id}/properties/{property_id}` | `partner:create` | `partner-property:create` |

    **Impact:** More granular access control for partner properties operations. Token scopes were adjusted accordingly.
  </Accordion>
</AccordionGroup>

***

## Need Help?

<CardGroup cols={2}>
  <Card title="API Reference" icon="book" href="/api-reference/telematics-api">
    View complete endpoint documentation with current API structure
  </Card>

  <Card title="Contact Support" icon="life-ring" href="mailto:support@catenaclearing.io">
    Questions about migrating 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.