Contents x
    Change service ticket state to Done
    • 06 Jun 2025
    • 1 Minute to read
    • Print
    • Dark
      Light
    Contents

    Change service ticket state to Done

    • Updated on 06 Jun 2025
    • 1 Minute to read
    • Print
    • Dark
      Light
    Article summary

    Post
    /api/v1/maintenance/servicetickets/done

    Changes the service ticket state to Done.

    Description

    The user can call this endpoint to close a service ticket. When this endpoint is called, the status of the service ticket is set to 'done'.

    Use Case

    The Bloxs user wants to close a service ticket.

    Request fields

    The request contains the following fields:

    FieldDescription
    referenceThe unique identifier for this service ticket within Bloxs. This is unique (per client specific environment) for all service tickets. This identifier is generated by the Bloxs system.
    externalIdentifierThe unique identifier within the system of the requesting party. This identifier is not generated by the Bloxs system.
    closingDate

    This is an optional field, which Bloxs will automatically populate, depending on the configuration, if no value is provided. The field is intended for reporting purposes, to monitor the duration of the process.


    Response fields

    The  200 response contains the following fields:

    FieldDescription
    referenceThe unique identifier for this service ticket within Bloxs. This is unique (per client specific environment) for all service tickets. This identifier is generated by the Bloxs system.
    externalIdentifierThe unique identifier within the system of the requesting party. This identifier is not generated by the Bloxs system.
    messageThe comment associated with the note, for example to indicate why the note was created or to provide additional context or clarification.


    Security
    HTTP
    Type Bearer

    Please enter a valid token

    Body parameters
    object
    reference
    string | null
    externalIdentifier
    string | null
    closingDate
    string (date-time) | null
    Responses
    200

    The service ticket state was changed to Done

    object
    externalIdentifier
    string | null
    Min length0
    Max length100
    externalLink
    string | null
    Min length0
    Max length256
    reportingDate
    string (date)
    stateName
    string
    Min length0
    Max length256
    priority
    integer (int32)
    Valid values[ 1, 2, 3 ]
    problemCategoryName
    string | null
    Min length0
    Max length256
    costsAreForTenant
    boolean
    costCategoryName
    string | null
    Min length0
    Max length256
    description
    string
    Min length0
    Max length512
    realEstateObjectReference
    string
    Min length0
    Max length100
    reporterReference
    string
    Min length0
    Max length100
    reporterContactPersonReference
    string | null
    Min length0
    Max length100
    reporterExternalContactPersonName
    string | null
    Min length0
    Max length256
    reporterExternalContactPersonPhoneNumber
    string | null
    Min length0
    Max length512
    reporterExternalContactPersonMobileNumber
    string | null
    Min length0
    Max length512
    reporterExternalContactPersonEmail
    string | null
    Min length0
    Max length254
    supplierReference
    string | null
    Min length0
    Max length100
    handledBySupplier
    boolean
    expectedCosts
    number (double) | null
    reference
    string
    Min length0
    Max length100
    mandateAmount
    number (double) | null
    400

    The service ticket state change has validation issues

    Expand All
    object
    type
    string | null
    title
    string | null
    traceId
    string | null
    status
    integer (int32)
    errors
    object | null
    property*
    Array of string | null additionalProperties
    string
    404

    There was a problem changing the state of the service ticket

    Expand All
    object
    type
    string | null
    title
    string | null
    traceId
    string | null
    status
    integer (int32)
    errors
    object | null
    property*
    Array of string | null additionalProperties
    string
    What's Next