Create Line Item

The Assignment & Grades endpoint tools call to create a grade line. You never call this — LTIAAS relays it to your Service URL as a LINEITEMS_POST service request.

Path Parameters

contextId string required
The URL-encoded context identifier — the same context value you supplied when starting the launch.
Example: 2022CSEa5e6c431b91

application/json

Request Body required

label string required
scoreMaximum number required
resourceLinkId string
tag string

Responses

• 201
• 400
• 401
• 403

---

Line item created

application/json

Schema

Example (from schema)

---

Schema

id string required

Your stable identifier for this grade line.

label string required
scoreMaximum number required
resourceLinkId string

Present when the grade line belongs to a specific activity.

tag string

Present when the grade line carries a tool-defined tag.

{
  "id": "412",
  "label": "My first grade line",
  "scoreMaximum": 99,
  "resourceLinkId": "412",
  "tag": "new_tag"
}

One or more request parameters were missing or malformed.

application/json

Schema

Example (from schema)

---

Schema

status integer
error string
details object
errors object[]
One entry per field that failed validation.
Array [
field string
message string
]

{
  "status": 400,
  "error": "Bad Request",
  "details": {
    "errors": [
      {
        "field": "clientId",
        "message": "Missing 'clientId' parameter."
      }
    ]
  }
}

The Authorization header was missing, malformed, or carried the wrong key.

application/json

Schema

Example (from schema)

Example

---

Schema

status integer
error string
details object

Context for the failure. Always carries a message code; the other keys depend on what went wrong.

message string

description string

property name* any

Context for the failure. Always carries a message code; the other keys depend on what went wrong.

{
  "status": 403,
  "error": "Forbidden",
  "details": {
    "message": "INACTIVE_SERVICE",
    "description": "string"
  }
}

{
  "status": 401,
  "error": "Unauthorized",
  "details": {
    "message": "INVALID_BEARER_AUTHORIZATION_HEADER",
    "description": "Invalid API Key for account."
  }
}

The LTI® service this endpoint depends on is not enabled on your account.

application/json

Schema

Example (from schema)

Example

---

Schema

status integer
error string
details object

Context for the failure. Always carries a message code; the other keys depend on what went wrong.

message string

description string

property name* any

Context for the failure. Always carries a message code; the other keys depend on what went wrong.

{
  "status": 403,
  "error": "Forbidden",
  "details": {
    "message": "INACTIVE_SERVICE",
    "description": "string"
  }
}

{
  "status": 403,
  "error": "Forbidden",
  "details": {
    "message": "INACTIVE_SERVICE",
    "service": "Deep Linking"
  }
}

Loading...