Request

Response

    Create Inventory Movement
    POST

    inventory-movements

    Creates a new Inventory Movement.

    Resource Information

    Method and URI
    POST
    https://api.aps.autodesk.com/fusion-operations/v2/inventory-movements
    Authentication Context
    No security required
    Required OAuth Scopes
    data:read data:write
    Data Format
    JSON

    Request

    Headers

    Authorization*
    string
    JWT Access Token
    Content-Type*
    string
    Must be application/json
    * Required

    Request

    Body Structure

    The inventory movement object to be created, conforming to the specified schema.

    Expand all
    date*
    datetime: ISO 8601
    Date of the inventory movement (e.g. 2025-06-21T14:07:17Z)
    product*
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf*
    0*
    1*
    quantity*
    number
    The quantity of the Product moved
    receiving
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    shipping
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    type*
    string
    Type of inventory movement. PRODUCTION and CONSUMPTION stock movements cannot be created. They are automatically created in the Production endpoints. The TRANSIT type cannot be used to create inventory movements.
    lot
    code
    string
    Max length: 255
    expirationDate
    string
    Expiration date of the lot (e.g. 2025-06-21)
    supplierLot
    string
    Max length: 255
    anyOf
    0
    1
    warehouseLocation
    Warehouse location associated with the inventory movement. If null the Production warehouse is considered
    anyOf
    Warehouse location associated with the inventory movement. If null the Production warehouse is considered
    0
    object
    1
    all of
    0
    all of
    0
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    1
    all of
    0
    object
    code
    string
    Max length: 255
    name
    string
    Max length: 255
    site
    all of
    Site associated with the Inventory Movement.
    0
    all of
    0
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    comment
    string
    Max length: 255
    cost
    number
    worker
    id
    int
    number
    int
    anyOf
    0
    1
    site
    Site associated with the Inventory Movement.
    anyOf
    Site associated with the Inventory Movement.
    0
    object
    1
    all of
    0
    all of
    0
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    * Required

    Response

    HTTP Status Code Summary

    201
    Created
    Inventory Movement successfully created.
    400
    Bad Request
    Bad request due to invalid data.
    401
    Unauthorized
    The access token is invalid. It may have either expired or may not be a three-legged access token. Please verify the token and retry the request.
    403
    Forbidden
    The request was successfully validated but lacked required permission. Please verify your token permissions and retry the request.
    429
    Too Many Requests
    Rate limit exceeded; wait some time before retrying.
    500
    Internal Server Error
    An unknown server-side error occurred. Please try again later. If the problem persists, please contact support.

    Response

    Header (429)

    Retry-After
    integer
    The number of seconds to wait before retrying the request.

    Response

    Body Structure (201)

    Expand all
    id
    int
    Unique identifier of the inventory movement.
    date
    datetime: ISO 8601
    Date of the inventory movement (e.g. 2025-06-21T14:07:17Z)
    product
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    name
    string
    Name of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    quantity
    number
    The quantity of the Product moved
    unitOfMeasurement
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    name
    string
    Name of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    receiving
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    shipping
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    production
    object
    id
    int
    Unique identifier of the Production linked to the inventory movement. Applies only for consumptions and produced materials during Production.
    maintenanceOrder
    object
    id
    int
    Unique identifier of the Maintenance Order linked to the inventory movement. Applies only for consumptions in Maintenance Orders.
    type
    string
    Type of inventory movement. PRODUCTION and CONSUMPTION stock movements cannot be created. They are automatically created in the Production endpoints. The TRANSIT type cannot be used to create inventory movements.
    lot
    id
    int
    Unique identifier of the lot.
    code
    string
    Max length: 255
    expirationDate
    string
    Expiration date of the lot (e.g. 2025-06-21)
    supplierLot
    string
    Max length: 255
    anyOf
    0
    1
    warehouseLocation
    Warehouse location associated with the inventory movement. If null the Production warehouse is considered
    anyOf
    Warehouse location associated with the inventory movement. If null the Production warehouse is considered
    0
    object
    1
    all of
    0
    all of
    0
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    name
    string
    Name of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    1
    all of
    0
    object
    id
    int
    Unique identifier of the warehouse.
    code
    string
    Max length: 255
    name
    string
    Max length: 255
    site
    all of
    Site associated with the Inventory Movement.
    0
    all of
    0
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    comment
    string
    Max length: 255
    cost
    number
    worker
    id
    int
    number
    int
    name
    string
    Max length: 255
    anyOf
    0
    1
    site
    Site associated with the Inventory Movement.
    anyOf
    Site associated with the Inventory Movement.
    0
    object
    1
    all of
    0
    all of
    0
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    0
    1

    Example

    Inventory Movement successfully created.

    Example single inventory movement request with codes

    Request

    curl -v 'https://developer.api.autodesk.com/fusion-operations/v2/inventory-movements' \
      -X 'POST' \
      -H 'Authorization: ' \
      -H 'Content-Type: application/json' \
      -d '{
            "date": "2024-04-27T10:00:00Z",
            "product": {
              "code": "Johannes"
            },
            "quantity": 100,
            "type": "RECEIVING",
            "worker": {
              "number": 66
            },
            "comment": "My wonderful inventory Movement note with less than 255 characters",
            "warehouseLocation": {
              "code": "Main Warehouse",
              "warehouse": {
                "code": "Central Warehouse"
              }
            }
          }'
    
    Show More

    Example single inventory movement request with ids

    Request

    curl -v 'https://developer.api.autodesk.com/fusion-operations/v2/inventory-movements' \
      -X 'POST' \
      -H 'Authorization: ' \
      -H 'Content-Type: application/json' \
      -d '{
            "date": "2024-04-27T10:00:00Z",
            "product": {
              "id": 21
            },
            "quantity": 100,
            "type": "RECEIVING",
            "worker": {
              "id": 12
            },
            "comment": "My wonderful inventory Movement note with less than 255 characters",
            "warehouseLocation": {
              "id": 5,
              "warehouse": {
                "id": 2
              }
            }
          }'
    
    Show More

    Example of create inventory movement to production warehouse location

    Request

    curl -v 'https://developer.api.autodesk.com/fusion-operations/v2/inventory-movements' \
      -X 'POST' \
      -H 'Authorization: ' \
      -H 'Content-Type: application/json' \
      -d '{
            "date": "2024-04-27T10:00:00Z",
            "product": {
              "id": 21
            },
            "quantity": 100,
            "type": "RECEIVING",
            "worker": {
              "id": 12
            },
            "comment": "My wonderful inventory Movement note with less than 255 characters"
          }'
    
    Show More

    Response

    {
      "id": 382,
      "date": "2024-04-27T10:00:00Z",
      "product": {
        "id": 21,
        "code": "ProductA",
        "name": "Product A 204"
      },
      "quantity": 100,
      "type": "RECEIVING",
      "worker": {
        "id": 12,
        "number": 66,
        "name": "Peter"
      },
      "comment": "My wonderful inventory Movement note with less than 255 characters",
      "warehouseLocation": {
        "id": 5,
        "code": "Main Warehouse",
        "name": "Main Warehouse",
        "warehouse": {
          "id": 2,
          "code": "Central Warehouse",
          "name": "Central Warehouse"
        },
        "site": {
          "id": 12,
          "code": "SITE-01"
        }
      }
    }
    
    Show More