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

# Save Currents

> Saves the history elements as the current value for their respective lists.

If more than one item is submitted for the same list, they are added sequently, meaning that the last one is the most current.
NsApiSlow threshold: 5000 ms.



## OpenAPI

````yaml /openapi/agent/openapi-v3-ViewStateAgent.json post /api/v1/Agents/ViewState/SaveCurrents
openapi: 3.0.0
info:
  version: v1-Agents
  title: SuperOffice Agent API v1
  description: SuperOffice Agent API - ViewStateAgent
  contact:
    name: SuperOffice DevNet
    url: https://docs.superoffice.com/en/api/index.html
    email: sdk@superoffice.com
servers:
  - url: http://localhost:56350
  - url: https://localhost:56350
security: []
tags: []
externalDocs:
  description: >-
    The SuperOffice DevNet Community has more documentation, examples, and
    discussion forums.
  url: https://community.superoffice.com/en/developer/
paths:
  /api/v1/Agents/ViewState/SaveCurrents:
    post:
      tags:
        - ViewState_Agent
      summary: Save Currents
      description: "Saves the history elements as the current value for their respective lists.\n\nIf more than one item is submitted for the same list, they are added sequently, meaning that the last one is the most current.\r\nNsApiSlow threshold: 5000 ms."
      operationId: v1ViewStateAgent_SaveCurrents
      parameters:
        - name: $select
          in: query
          description: >-
            Optional comma separated list of properties to include in the
            result. Other fields are then nulled out to reduce payload size:
            "Name,department,category". Default = show all fields.
          required: false
          schema:
            type: string
        - name: Accept-Language
          in: header
          description: >-
            Convert string references and multi-language values into a specified
            language (iso2) code.
          required: false
          schema:
            type: string
        - name: SO-Language
          in: header
          description: >-
            Convert string references and multi-language values into a specified
            language (iso2) code. Overrides Accept-Language value.
          required: false
          schema:
            type: string
        - name: SO-Culture
          in: header
          description: >-
            Number, date formatting in a specified culture (iso2 language) code.
            Partially overrides SO-Language/Accept-Language value. Ignored if no
            Language set.
          required: false
          schema:
            type: string
        - name: SO-TimeZone
          in: header
          description: >-
            Specify the timezone code that you would like date/time responses
            converted to.
          required: false
          schema:
            type: string
        - name: SO-AppToken
          in: header
          description: >-
            The application token that identifies the partner app. Used when
            calling Online WebAPI from a server.
          required: false
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/SuperOffice.WebApi.v1.Carriers.ViewStateCarriers.SaveCurrentsRequest
          text/json:
            schema:
              $ref: >-
                #/components/schemas/SuperOffice.WebApi.v1.Carriers.ViewStateCarriers.SaveCurrentsRequest
          application/xml:
            schema:
              $ref: >-
                #/components/schemas/SuperOffice.WebApi.v1.Carriers.ViewStateCarriers.SaveCurrentsRequest
          text/xml:
            schema:
              $ref: >-
                #/components/schemas/SuperOffice.WebApi.v1.Carriers.ViewStateCarriers.SaveCurrentsRequest
          application/x-www-form-urlencoded:
            schema:
              $ref: >-
                #/components/schemas/SuperOffice.WebApi.v1.Carriers.ViewStateCarriers.SaveCurrentsRequest
          application/json-patch+json:
            schema:
              $ref: >-
                #/components/schemas/SuperOffice.WebApi.v1.Carriers.ViewStateCarriers.SaveCurrentsRequest
          application/merge-patch+json:
            schema:
              $ref: >-
                #/components/schemas/SuperOffice.WebApi.v1.Carriers.ViewStateCarriers.SaveCurrentsRequest
        description: Currents
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SuperOffice.CRM.Services.History'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SuperOffice.CRM.Services.History'
            application/xml:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SuperOffice.CRM.Services.History'
            text/xml:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SuperOffice.CRM.Services.History'
            application/json-patch+json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SuperOffice.CRM.Services.History'
            application/merge-patch+json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SuperOffice.CRM.Services.History'
      security:
        - SuperOffice_Password: []
          SuperId_Authentication: []
components:
  schemas:
    SuperOffice.WebApi.v1.Carriers.ViewStateCarriers.SaveCurrentsRequest:
      description: >-
        SaveCurrents: Saves the history elements as the current value for their
        respective lists. If more than one item is submitted for the same list,
        they are added sequently, meaning that the last one is the most current.
      type: object
      properties:
        Currents:
          type: array
          items:
            $ref: '#/components/schemas/SuperOffice.CRM.Services.History'
    SuperOffice.CRM.Services.History:
      description: "The usage history of the currently logged in user is represented as History objects.\r\n<para />\r\nCarrier object for History.\r\nServices for the History Carrier is available from the <see cref=\"T:SuperOffice.CRM.Services.IViewStateAgent\">ViewState Agent</see>."
      type: object
      properties:
        Rank:
          format: int32
          description: Sort order, indexed so it can used for sorting in the query
          type: integer
        Id:
          format: int32
          description: >-
            Id of the history item, for instance a contact id. Represents the
            history table's RecordId field, if the item is based on a history
            table record
          type: integer
        HistoryName:
          description: >-
            The name of the history list, for instance contact. Represents the
            history table's TableId field
          type: string
        HistoryId:
          format: int32
          description: Primary key
          type: integer
        AssociateId:
          format: int32
          description: Owner of history list
          type: integer
        Name:
          description: Name of the history item, for instance contact name
          type: string
        ItemInfo:
          description: >-
            Extra information on the history item, e.g. The Associate Type for
            an associate or other relevant info.
          type: string
        TableRight:
          $ref: '#/components/schemas/SuperOffice.CRM.Security.TableRight'
        FieldProperties:
          description: >-
            Field property dictionary mapping field names to field access
            rights.
          type: object
          additionalProperties:
            $ref: '#/components/schemas/SuperOffice.CRM.Security.FieldProperty'
    SuperOffice.CRM.Security.TableRight:
      description: "Wraps a table right together with an explanatory reason.\r\nCode can indicate why access is restricted."
      type: object
      properties:
        Mask:
          type: string
        Reason:
          type: string
    SuperOffice.CRM.Security.FieldProperty:
      description: >-
        Class holding properties like field length, field type about a field in
        the carrier.
      type: object
      properties:
        FieldRight:
          $ref: '#/components/schemas/SuperOffice.CRM.Security.FieldRight'
        FieldType:
          type: string
        FieldLength:
          format: int32
          description: ''
          type: integer
    SuperOffice.CRM.Security.FieldRight:
      description: "Wraps the field right together with an explanatory reason.\r\nAlso adds logical operators to the field rights so that they can be easily combined."
      type: object
      properties:
        Mask:
          type: string
        Reason:
          type: string

````

## Related topics

- [Save Current](/en/api/reference/restful/agent/viewstate_agent/save-current.md)
- [SuperOffice.WebApi.Data.ViewState SaveCurrentsRequest](/en/api/reference/webapi/SuperOffice.WebApi.Data.ViewState_SaveCurrentsRequest.md)
- [SuperOffice.WebApi.Data.ViewState SaveCurrentRequest](/en/api/reference/webapi/SuperOffice.WebApi.Data.ViewState_SaveCurrentRequest.md)
- [NSViewStateAgent](/en/automation/crmscript/reference/CRMScript.NetServer.NSViewStateAgent.md)
- [SuperOffice.WebApi.Agents.IViewStateAgent](/en/api/reference/webapi/SuperOffice.WebApi.Agents.IViewStateAgent.md)
- [SuperOffice.WebApi.Agents.ViewStateAgent](/en/api/reference/webapi/SuperOffice.WebApi.Agents.ViewStateAgent.md)