Clients

Update a client

Changed on

Edit a client's display name and/or its config. Two ways to change the config: config replaces it wholesale, and set changes named fields over the config read inside the write transaction — prefer set, because a whole-config round-trip composed from a stale read reverts whatever landed in between.

Config edits require expectedConfigId and renames require expectedName. A stale token is 409 CONFLICT whose details carries the current value: re-read the client and retry. A config edit that resolves to byte-identical settings writes nothing at all.

Guest callers are denied (a write).

patch/projects/{projectId}/clients/{client}

Request

  • Base URL
    https://app.mcpjam.com/api/v1
  • URL
    https://app.mcpjam.com/api/v1/projects/{projectId}/clients/{client}
  • Auth
    HTTP bearer

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

clientstring required

Client name or ID. A name is matched case-insensitively and must be unique in the project; an ambiguous name is refused with 409 CONFLICT listing the candidate ids rather than resolved to one of them.

Request body

OR
OR

Response

The updated client settings.

versionIdstring

Saved client history entry read together with config. Absent on older clients or deployments.

versionNumberinteger

Client configuration version, numbered from 1 in saved edit order.

idstring required
namestring required
configIdstring

The concurrency token — see Client.configId.

configobject required

Client config v2 DTO. Opaque object; shape mirrors the inspector's client editor.

ownerScopeobject nullable required
hasComputerboolean
createdAtnumber

Unix epoch milliseconds.

updatedAtnumber

Unix epoch milliseconds.

Changes

  • 9826d734d268Revision changes
    • breaking

      removed from the / request property oneOf list

    • info

      added to the / request property oneOf list

  • c9e609871357Revision changes
    • info

      added the new optional request property /