# Update matter

Updates a matters details

Endpoint: PATCH /v2/matters/{matterId}

## Path parameters:

  - `matterId` (integer, required)
    The system identifier for the matter
    Example: 1056

## Request fields (application/merge-patch+json):

  - `name` (string,null)
    The user defined name of the matter 

When simple ticketing is enabled for the organization then the Name is going to be optional and will default to simple ticketing rules, otherwise is required.

  - `owner` (object,null)
    The user assigned as the owner of the matter

  - `owner.id` (string)
    The identifier of the user
    Example: "f0f1e06e-3005-4093-af7f-1934d55617e1"

  - `manager` (object,null)
    The user managing the matter or the intake queue for an organization.

Only one of User and IntakeQueue can be assigned to a matter at a time.

  - `manager.intakeQueue` (object,null)
    The intake queue for the organization that is assigned to manage the matter

  - `manager.intakeQueue.organizationId` (integer)
    The organization the user belongs to
    Example: 8134

  - `manager.user` (object,null)
    The user who is assigned to manage the matter

  - `externalId` (string,null)
    A unique user defined identifier that can be used to reference another system

  - `fields` (object,null)
    The collection of fields associated with the matter
    Example: {"my_text_field":"my text value","my_decimal_field":78659.84,"my_boolean_field":true,"my_date_field":"2025-05-06","my_option_field":{"value":"option_1"},"my_multioption_field":[{"value":"option_a"},{"value":"option_d"}],"my_user_field":{"id":"f0f1e06e-3005-4093-af7f-1934d55617e1"}}

  - `restricted` (boolean,null)
    Is the matter only available to members

An indicator where the matter requires membership to access

  - `status` (string,null)
    The current status of the matter
    Enum: "Draft", "Scoping", "Review", "Active", "TasksLate", "MilestonesLate", "TasksAndMilestonesLate", "AwaitingManagerAcceptance", "AwaitingOwnerAcceptance", "Complete", "Archived", "OnHold"

  - `teamAssigned` (object,null)
    The team which this matter is assigned to

  - `teamAssigned.id` (integer)
    The identifier of the team
    Example: 469

## Response 400 fields (application/problem+json):

  - `detail` (string)
    More information about the problem.

  - `errors` (object)
    A dictionary of validation errors, where each key is a field api name and the value is a list of error messages.

  - `instance` (string)
    The URI of the resource which the error relates to.

  - `operationId` (string)
    A unique trace identifier for the request. This should be provided when requesting support.

  - `status` (integer)
    The HTTP status code for the problem.

  - `title` (string)
    A short description of the error.

  - `type` (string)
    A URI which can be followed to find out more about the problem.

## Response 403 fields (application/problem+json):

  - `detail` (string)
    More information about the problem.

  - `instance` (string)
    The URI of the resource which the error relates to.

  - `operationId` (string)
    A unique trace identifier for the request. This should be provided when requesting support.

  - `status` (integer)
    The HTTP status code for the problem.

  - `title` (string)
    A short description of the error.

  - `type` (string)
    A URI which can be followed to find out more about the problem.

## Response 404 fields (application/problem+json):

  - `detail` (string)
    More information about the problem.

  - `instance` (string)
    The URI of the resource which the error relates to.

  - `operationId` (string)
    A unique trace identifier for the request. This should be provided when requesting support.

  - `status` (integer)
    The HTTP status code for the problem.

  - `title` (string)
    A short description of the error.

  - `type` (string)
    A URI which can be followed to find out more about the problem.

## Response 409 fields (application/problem+json):

  - `detail` (string)
    More information about the problem.

  - `instance` (string)
    The URI of the resource which the error relates to.

  - `operationId` (string)
    A unique trace identifier for the request. This should be provided when requesting support.

  - `status` (integer)
    The HTTP status code for the problem.

  - `title` (string)
    A short description of the error.

  - `type` (string)
    A URI which can be followed to find out more about the problem.