Request

Response

    Create Worker
    POST

    workers

    Creates a new Worker.

    Resource Information

    Method and URI
    POST
    https://api.aps.autodesk.com/fusion-operations/v2/workers
    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 worker object to be created, conforming to the specified schema.

    Expand all
    number*
    int
    The number assigned to the worker
    name*
    string
    Max length: 255
    disabled
    boolean
    shift*
    The current active shift for the worker
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf*
    The current active shift for the worker
    0*
    1*
    customCode
    string
    NFC/RFId/SmartCard/Barcode for login

    Max length: 255

    costPerHour
    number
    The value assigned to each hour of labor
    language
    enum:string
    Possible values: PT, EN, DE, ES, PL, ZH, FR, IT, JP, KR, TR, PT_BR, BG
    sections
    array: object
    id
    int
    Unique identifier of the referenced entity.
    name
    string
    Name of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    * Required

    Response

    HTTP Status Code Summary

    201
    Created
    Worker 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 worker.
    number
    int
    The number assigned to the worker
    name
    string
    Max length: 255
    disabled
    boolean
    shift
    The current active shift for the worker
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    The current active shift for the worker
    0
    1
    customCode
    string
    NFC/RFId/SmartCard/Barcode for login

    Max length: 255

    costPerHour
    number
    The value assigned to each hour of labor
    language
    enum:string
    Possible values: PT, EN, DE, ES, PL, ZH, FR, IT, JP, KR, TR, PT_BR, BG
    sections
    array: object
    id
    int
    Unique identifier of the referenced entity.
    name
    string
    Name of the referenced entity.

    Max length: 255

    anyOf
    0
    1

    Example

    Worker successfully created.

    Example single worker request with codes

    Request

    curl -v 'https://developer.api.autodesk.com/fusion-operations/v2/workers' \
      -X 'POST' \
      -H 'Authorization: ' \
      -H 'Content-Type: application/json' \
      -d '{
            "number": 66,
            "name": "Peter Johnson",
            "disabled": false,
            "shift": {
              "code": "Morning"
            },
            "customCode": "1234qwer",
            "costPerHour": 25.5,
            "language": "EN",
            "sections": [
              {
                "name": "Assembly"
              },
              {
                "name": "Packaging"
              }
            ]
          }'
    
    Show More

    Example single worker request with ids

    Request

    curl -v 'https://developer.api.autodesk.com/fusion-operations/v2/workers' \
      -X 'POST' \
      -H 'Authorization: ' \
      -H 'Content-Type: application/json' \
      -d '{
            "number": 66,
            "name": "Peter Johnson",
            "disabled": false,
            "shift": {
              "id": 3
            },
            "customCode": "1234qwer",
            "costPerHour": 25.5,
            "language": "EN",
            "sections": [
              {
                "id": 2
              },
              {
                "id": 4
              }
            ]
          }'
    
    Show More

    Response

    {
      "id": 382,
      "number": 66,
      "name": "Peter Johnson",
      "disabled": false,
      "shift": {
        "id": 3,
        "code": "Morning"
      },
      "customCode": "1234qwer",
      "costPerHour": 25.5,
      "language": "EN",
      "sections": [
        {
          "id": 2,
          "code": "Assembly",
          "name": "Assembly Section"
        },
        {
          "id": 4,
          "code": "Packaging",
          "name": "Packaging Section"
        }
      ]
    }
    
    Show More