Patch a customer

PATCH

/api/tenant/{tenantId}/Customers/{id}

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Patch,
    RequestUri = new Uri("https://api.nimles.com/e-commerce/api/tenant/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/Customers/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"),
    Headers =
    {
        { "Authorization", "Bearer <token>" },
    },
    Content = new StringContent("[ { \"op\": \"example\", \"path\": \"example\", \"from\": \"example\", \"value\": \"example\" } ]")
    {
        Headers =
        {
            ContentType = new MediaTypeHeaderValue("application/json")
        }
    }
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

const url = 'https://api.nimles.com/e-commerce/api/tenant/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/Customers/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '[{"op":"example","path":"example","from":"example","value":"example"}]'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request PATCH \
  --url https://api.nimles.com/e-commerce/api/tenant/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/Customers/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '[ { "op": "example", "path": "example", "from": "example", "value": "example" } ]'

Applies JSON Patch operations (add, remove, replace, move, copy and test) to the members a PUT changes: /description, /seller and /buyer (also below them, e.g. /buyer/email).

Authorizations

bearerAuth

Parameters

Path Parameters

required

string format: uuid

The customer’s id.

tenantId

required

string format: uuid

Your tenant id.

Request Body

The operations, applied in order.

application/json

Array<object>

object

required

string

path

required

string

>= 1 characters

from

string

nullable

value

nullable

Example ^generated

[
  {
    "op": "example",
    "path": "example",
    "from": "example",
    "value": "example"
  }
]

Responses

200

application/json

object

fields

object

key

additional properties

string

data

object

fields

object

key

additional properties

object

value

required

nullable

valueType

string

nullable

accessibility

string

nullable

string format: uuid

relations

Array<object>

nullable

object

fields

object

key

additional properties

object

value

required

nullable

valueType

string

nullable

accessibility

string

nullable

string format: uuid

name

string

nullable

entityId

required

string format: uuid

entityType

required

string

>= 1 characters

relationType

required

string

>= 1 characters

tenantId

string format: uuid

nullable

resourceGroupId

string format: uuid

nullable

creatorId

string format: uuid

nullable

createdDate

string format: date-time

nullable

version

integer format: int32

nullable

lastModified

string format: date-time

nullable

userId

string format: uuid

nullable

references

object

key

additional properties

string

buyer

object

fields

object

key

additional properties

object

value

required

nullable

valueType

string

nullable

accessibility

string

nullable

string format: uuid

organizationId

string format: uuid

nullable

userId

string format: uuid

nullable

siteId

string format: uuid

nullable

customerType

string

nullable

identityNumber

string

nullable

organizationName

string

nullable

firstName

string

nullable

lastName

string

nullable

email

string

nullable

phoneNumber

string

nullable

deliveryAddress

object

coAddress

string

nullable

state

string

nullable

country

string

nullable

name

string

nullable

firstName

string

nullable

lastName

string

nullable

street

string

nullable

postalCode

string

nullable

city

string

nullable

billingAddress

object

coAddress

string

nullable

state

string

nullable

country

string

nullable

name

string

nullable

firstName

string

nullable

lastName

string

nullable

street

string

nullable

postalCode

string

nullable

city

string

nullable

useDeliveryAddress

boolean

seller

object

fields

object

key

additional properties

object

value

required

nullable

valueType

string

nullable

accessibility

string

nullable

string format: uuid

organizationId

string format: uuid

nullable

userId

string format: uuid

nullable

siteId

string format: uuid

nullable

description

string

nullable

paymentMethods

Array<object>

nullable

object

fields

object

key

additional properties

object

value

required

nullable

valueType

string

nullable

accessibility

string

nullable

string format: uuid

reference

string

nullable

name

string

nullable

description

string

nullable

cardNumber

string

nullable

expMonth

integer format: int64

nullable

expYear

integer format: int64

nullable

clientReference

string

nullable

cardHolder

string

nullable

holder

string

nullable

cardType

string

nullable

customerReference

string

nullable

clientReference

string

nullable

paymentClientReference

string

nullable

Example ^generated

{
  "data": {
    "fields": {
      "additionalProperty": {
        "value": "example",
        "valueType": "example"
      }
    },
    "accessibility": "example",
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "relations": [
      {
        "fields": {
          "additionalProperty": {
            "value": "example",
            "valueType": "example"
          }
        },
        "accessibility": "example",
        "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
        "name": "example",
        "entityId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
        "entityType": "example",
        "relationType": "example"
      }
    ],
    "tenantId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "resourceGroupId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "creatorId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "createdDate": "2026-04-15T12:00:00Z",
    "version": 1,
    "lastModified": "2026-04-15T12:00:00Z",
    "userId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "references": {
      "additionalProperty": "example"
    },
    "buyer": {
      "fields": {
        "additionalProperty": {
          "value": "example",
          "valueType": "example"
        }
      },
      "accessibility": "example",
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "organizationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "userId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "siteId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "customerType": "example",
      "identityNumber": "example",
      "organizationName": "example",
      "firstName": "example",
      "lastName": "example",
      "email": "example",
      "phoneNumber": "example",
      "deliveryAddress": {
        "coAddress": "example",
        "state": "example",
        "country": "example",
        "name": "example",
        "firstName": "example",
        "lastName": "example",
        "street": "example",
        "postalCode": "example",
        "city": "example"
      },
      "billingAddress": {
        "coAddress": "example",
        "state": "example",
        "country": "example",
        "name": "example",
        "firstName": "example",
        "lastName": "example",
        "street": "example",
        "postalCode": "example",
        "city": "example"
      },
      "useDeliveryAddress": true
    },
    "seller": {
      "fields": {
        "additionalProperty": {
          "value": "example",
          "valueType": "example"
        }
      },
      "accessibility": "example",
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "organizationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "userId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "siteId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
    },
    "description": "example",
    "paymentMethods": [
      {
        "fields": {
          "additionalProperty": {
            "value": "example",
            "valueType": "example"
          }
        },
        "accessibility": "example",
        "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
        "reference": "example",
        "name": "example",
        "description": "example",
        "cardNumber": "example",
        "expMonth": 1,
        "expYear": 1,
        "clientReference": "example",
        "cardHolder": "example",
        "holder": "example",
        "cardType": "example",
        "customerReference": "example"
      }
    ],
    "clientReference": "example",
    "paymentClientReference": "example"
  }
}

204

No Content: done, with no item to return.

401

Unauthorized: no bearer token, or one that is expired or not for this API.

403

Forbidden: the caller holds no role that allows this action at this scope. The body is empty, or a problem whose detail names the action.

application/json

An RFC 9457 problem.

object

detail

string

nullable

instance

string

nullable

status

integer format: int32

nullable

title

string

nullable

type

string

nullable

key

additional properties

Example ^generated

{
  "detail": "example",
  "instance": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

404

Not found: no such item in the tenant.

application/problem+json

An RFC 9457 problem.

object

detail

string

nullable

instance

string

nullable

status

integer format: int32

nullable

title

string

nullable

type

string

nullable

key

additional properties

Example ^generated

{
  "detail": "example",
  "instance": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

409

Conflict: the item kept changing under concurrent writes; read it again and retry.

application/problem+json

An RFC 9457 problem.

object

detail

string

nullable

instance

string

nullable

status

integer format: int32

nullable

title

string

nullable

type

string

nullable

key

additional properties

Example ^generated

{
  "detail": "example",
  "instance": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

422

Unprocessable: the body or the change is invalid. The errors are keyed by member.

application/problem+json

A validation problem: the messages by member (or by JSON Pointer for a patch).

object

errors

object

key

additional properties

Array<string>

status

integer format: int32

nullable

title

string

nullable

type

string

nullable

key

additional properties

Example ^generated

{
  "errors": {
    "additionalProperty": [
      "example"
    ]
  },
  "status": 1,
  "title": "example",
  "type": "example"
}

Patch a customer

Authorizations

Parameters

Path Parameters

Request Body

Example generated

Responses

200

Example generated

204

401

403

Example generated

404

Example generated

409

Example generated

422

Example generated

Example ^generated

Example ^generated

Example ^generated

Example ^generated

Example ^generated

Example ^generated