Skip to main content
POST
/
goals
/
{studentId}
/
subjects
Create a learner-facing subject goal
curl --request POST \
  --url https://api.alpha-1edtech.ai/goals/{studentId}/subjects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "subject": "Reading",
  "objective": {
    "type": "grade_mastery",
    "value": "<string>"
  },
  "pacing": {
    "mode": "target_date",
    "endDate": "<string>",
    "dailyTargetXP": 123
  }
}
'
{
  "subject": {
    "subject": "<string>",
    "baseline": {
      "goalId": "<string>",
      "dailyTargetXP": 123,
      "defaultDailyTargetXP": 123,
      "startDate": "<string>",
      "updatedAt": "<string>"
    },
    "goal": {
      "id": "<string>",
      "type": "grade_mastery",
      "status": "active",
      "startDate": "<string>",
      "updatedAt": "<string>",
      "objective": {
        "type": "grade_mastery",
        "value": "<string>"
      },
      "pacing": {
        "mode": "target_date",
        "endDate": "<string>",
        "dailyTargetXP": 123
      }
    },
    "execution": {
      "stageId": "<string>",
      "courseIds": [
        "<string>"
      ]
    },
    "computed": {
      "xp": {
        "total": 123,
        "earned": 123,
        "remaining": 123,
        "pctComplete": 123
      },
      "pace": {
        "requiredDailyXP": 123,
        "effectiveDailyXP": 123,
        "schoolDaysRemaining": 123
      },
      "projection": {
        "currentGrade": "<string>",
        "daysToNextGrade": 123,
        "gradeTimeline": [
          {
            "grade": "<string>",
            "remainingXP": 123,
            "daysToComplete": 123,
            "projectedDate": "<string>",
            "status": "completed",
            "totalXP": 123,
            "earnedXP": 123,
            "courseIds": [
              "<string>"
            ]
          }
        ]
      },
      "resolution": {
        "strategy": "percentile",
        "resolvedTargetGrade": "<string>",
        "targetRit": 123
      },
      "issue": {
        "code": "missing_starting_grade",
        "message": "<string>",
        "service": "<string>",
        "path": "<string>",
        "status": 123
      }
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.timeback.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

studentId
string
required

Student sourcedId

Body

application/json
subject
enum<string>
required

Subject for the learner-facing goal

Available options:
Reading,
Language,
Vocabulary,
Social Studies,
Writing,
Science,
FastMath,
Math,
None,
Other
objective
object
required
pacing
object
required

Pacing controls for the subject goal

Response

Subject goal created

subject
object
required