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

# Update Registration Plate

> Update the registration plate of the specified vehicle.

**Parameters:**
- `vehicle_id`: The unique identifier (ID) of the vehicle to update.

**Returns:**
- A response containing the updated vehicle information.

**Note:**
- The `vehicle_id` should correspond to a valid and existing vehicle identifier.


Possible Codes in Error Response (see [Errors](https://docs.volteras.com/api-reference/errors) for error response schema and meaning of codes):

- AUTHENTICATION_ERROR
- REQUEST_VALIDATION_ERROR
- RESOURCE_NOT_FOUND
- SERVER_ERROR



## OpenAPI

````yaml post /v1/vehicles/{vehicle_id}/registration-plate
openapi: 3.1.0
info:
  title: VOLTERAS CONNECT
  version: 0.1.0
servers:
  - url: https://api.volteras.com
  - url: https://api.sandbox.volteras.com
security: []
paths:
  /v1/vehicles/{vehicle_id}/registration-plate:
    post:
      tags:
        - Vehicles
      summary: Update Registration Plate
      description: >-
        Update the registration plate of the specified vehicle.


        **Parameters:**

        - `vehicle_id`: The unique identifier (ID) of the vehicle to update.


        **Returns:**

        - A response containing the updated vehicle information.


        **Note:**

        - The `vehicle_id` should correspond to a valid and existing vehicle
        identifier.



        Possible Codes in Error Response (see
        [Errors](https://docs.volteras.com/api-reference/errors) for error
        response schema and meaning of codes):


        - AUTHENTICATION_ERROR

        - REQUEST_VALIDATION_ERROR

        - RESOURCE_NOT_FOUND

        - SERVER_ERROR
      operationId: >-
        update_registration_plate_v1_vehicles__vehicle_id__registration_plate_post
      parameters:
        - name: vehicle_id
          in: path
          required: true
          schema:
            type: string
            title: Vehicle ID
            description: Unique internal identifier for the vehicle.
          description: Unique internal identifier for the vehicle.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VehicleUpdateRegistration'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Vehicle'
      security:
        - OAuth2ClientCredentialsBearer:
            - vehicle:information
components:
  schemas:
    VehicleUpdateRegistration:
      properties:
        registrationPlate:
          anyOf:
            - type: string
              maxLength: 50
              minLength: 1
            - type: 'null'
          title: Registrationplate
      type: object
      required:
        - registrationPlate
      title: VehicleUpdateRegistration
    Vehicle:
      properties:
        make:
          type: string
          title: Make
          description: Manufacturer of the vehicle.
        model:
          anyOf:
            - type: string
            - type: 'null'
          title: Model
          description: >-
            Subcategory of the make, used to differentiate between different
            variations of a vehicle within the same make.
        trim:
          anyOf:
            - type: string
            - type: 'null'
          title: Trim
          description: >-
            Subcategory of the model, used to differentiate between different
            variations of a vehicle within the same model. Also referred to as
            version or generation.
        modelYear:
          anyOf:
            - type: string
            - type: 'null'
          title: Modelyear
          description: >-
            Year the vehicle model was released. Could be different than the
            year the vehicle was manufactured.
        vin:
          type: string
          title: Vin
          description: Vehicle identification number. Unique identifier for the vehicle.
        registrationPlate:
          anyOf:
            - type: string
            - type: 'null'
          title: Registrationplate
          description: >-
            Plate that is attached to a vehicle and displays a unique
            combination of letters and numbers assigned to the vehicle by a
            government agency. Also referred to as license plate or registration
            number.
        isRegNoValidated:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Isregnovalidated
          description: Indicates whether the registration plate has been validated
        regNoValidatedAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Regnovalidatedat
          description: Timestamp of when the registration plate was last validated
        id:
          type: string
          title: Id
          description: Unique internal identifier for the vehicle.
        metadata:
          $ref: '#/components/schemas/VehicleMetaData'
          description: Additional information about the vehicle.
        isListening:
          type: boolean
          title: Islistening
          description: >-
            Indicates whether the vehicle is currently accepting data ingestion
            and commands. Defaults to True when no listening state entries have
            been recorded.
          default: true
        listeningLastUpdated:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Listeninglastupdated
          description: >-
            UTC timestamp for the most recent listening-state update, or null
            when no entries exist.
        connectionStatus:
          anyOf:
            - type: string
            - type: 'null'
          title: Connectionstatus
          description: >-
            Connection status of the vehicle (e.g. CONNECTED,
            PENDING_CONNECTION, DISCONNECTED).
        connectionErrorCode:
          anyOf:
            - type: string
            - type: 'null'
          title: Connectionerrorcode
          description: Error code if the vehicle has a connection issue.
        connectionErrorMessage:
          anyOf:
            - type: string
            - type: 'null'
          title: Connectionerrormessage
          description: Human-readable error message for connection issues.
        actionCategory:
          anyOf:
            - type: string
            - type: 'null'
          title: Actioncategory
          description: >-
            Who must act on the connection error: CUSTOMER_ACTION,
            CONTACT_SUPPORT, or UNDER_REVIEW.
      type: object
      required:
        - make
        - vin
        - id
        - metadata
      title: Vehicle
    VehicleMetaData:
      properties:
        lastSeenAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Lastseenat
          description: >-
            The last recorded interaction with the vehicle endpoints. This is a
            timestamp in ISO 8601 format: YYYY-MM-DDThh:mm:ssTZD.
        consentId:
          anyOf:
            - type: string
            - type: 'null'
          title: Consentid
          description: >-
            Unique identifier for the consent that was used to retrieve the
            vehicle data.
        accountId:
          anyOf:
            - type: string
            - type: 'null'
          title: Accountid
          description: >-
            Unique identifier for the account that was used to retrieve the
            vehicle data.
        registrationDate:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Registrationdate
          description: >-
            Vehicle registration date (ISO 8601, day granularity). Captured at
            vehicle upload; used as the date-axis baseline for service-interval
            alerts.
      type: object
      required:
        - lastSeenAt
        - consentId
        - accountId
      title: VehicleMetaData
  securitySchemes:
    OAuth2ClientCredentialsBearer:
      type: oauth2
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /v1/oauth2/token

````