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

# Update Partner

> Update a sub-partner's details.

## Endpoint

```
PUT https://api.thiqwave.com/v1/partners/:id
```

## Description

Update the details of an existing sub-partner. You only need to include the fields you want to change — all body fields are optional. Fields you omit remain unchanged.

## Request

### Headers

<ParamField header="X-API-Key" type="string" required>
  Your Thiqwave API key.
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Must be `application/json`.
</ParamField>

### Path parameters

<ParamField path="id" type="string" required>
  The unique identifier of the sub-partner you want to update.
</ParamField>

### Body

All body fields are optional. Include only the fields you want to update.

<ParamField body="name" type="string">
  The updated legal business name.
</ParamField>

<ParamField body="email" type="string">
  The updated primary contact email address. Must be a valid email and unique across the platform.
</ParamField>

<ParamField body="businessType" type="string">
  The updated business type. Common values include `"fintech"`, `"marketplace"`, `"ecommerce"`, and `"remittance"`.
</ParamField>

## Example request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X PUT https://api.thiqwave.com/v1/partners/prtnr_01HZ2KJ8VBNC4W3M9RFQTX6YP \
    -H "X-API-Key: your-api-key" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Noon Financial Services LLC",
      "email": "platform@noonfinancial.ae"
    }'
  ```

  ```javascript JavaScript theme={null}
  const partnerId = 'prtnr_01HZ2KJ8VBNC4W3M9RFQTX6YP';

  const response = await fetch(`https://api.thiqwave.com/v1/partners/${partnerId}`, {
    method: 'PUT',
    headers: {
      'X-API-Key': 'your-api-key',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      name: 'Noon Financial Services LLC',
      email: 'platform@noonfinancial.ae',
    }),
  });

  const updated = await response.json();
  ```

  ```python Python theme={null}
  import requests

  partner_id = 'prtnr_01HZ2KJ8VBNC4W3M9RFQTX6YP'

  response = requests.put(
      f'https://api.thiqwave.com/v1/partners/{partner_id}',
      headers={
          'X-API-Key': 'your-api-key',
          'Content-Type': 'application/json',
      },
      json={
          'name': 'Noon Financial Services LLC',
          'email': 'platform@noonfinancial.ae',
      },
  )

  updated = response.json()
  ```
</CodeGroup>

## Response

A `200 OK` response returns the full updated partner object.

<ResponseField name="id" type="string">
  The partner's unique identifier.
</ResponseField>

<ResponseField name="name" type="string">
  The updated business name.
</ResponseField>

<ResponseField name="email" type="string">
  The updated contact email address.
</ResponseField>

<ResponseField name="businessType" type="string">
  The updated business type.
</ResponseField>

<ResponseField name="status" type="string">
  The partner's current account status: `"pending"`, `"active"`, or `"suspended"`.
</ResponseField>

<ResponseField name="createdAt" type="string">
  The ISO 8601 timestamp of when the partner was originally created.
</ResponseField>

<ResponseField name="updatedAt" type="string">
  The ISO 8601 timestamp of this update.
</ResponseField>

### Example response

```json theme={null}
{
  "id": "prtnr_01HZ2KJ8VBNC4W3M9RFQTX6YP",
  "name": "Noon Financial Services LLC",
  "email": "platform@noonfinancial.ae",
  "businessType": "marketplace",
  "status": "active",
  "createdAt": "2026-01-20T14:15:00Z",
  "updatedAt": "2026-04-08T11:05:00Z"
}
```

## Error responses

| Status | Code                | Description                                                                   |
| ------ | ------------------- | ----------------------------------------------------------------------------- |
| `400`  | `VALIDATION_ERROR`  | One or more fields are invalid. The response body includes a `details` array. |
| `401`  | `UNAUTHORIZED`      | Your API key is missing or invalid.                                           |
| `403`  | `FORBIDDEN`         | You do not have permission to update this partner.                            |
| `404`  | `PARTNER_NOT_FOUND` | No partner exists with the given ID.                                          |
| `409`  | `DUPLICATE_EMAIL`   | The provided email is already associated with another partner.                |