Create Homework Submission

curl --request POST \
  --url https://api.example.com/v1/homeworks/:homeworkId/submissions \
  --header 'Content-Type: <content-type>' \
  --header 'x-tenant-api-secret: <x-tenant-api-secret>' \
  --data '
{
  "studentId": "<string>",
  "files": {}
}
'

import requests

url = "https://api.example.com/v1/homeworks/:homeworkId/submissions"

payload = {
    "studentId": "<string>",
    "files": {}
}
headers = {
    "Content-Type": "<content-type>",
    "x-tenant-api-secret": "<x-tenant-api-secret>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Content-Type': '<content-type>',
    'x-tenant-api-secret': '<x-tenant-api-secret>'
  },
  body: JSON.stringify({studentId: '<string>', files: {}})
};

fetch('https://api.example.com/v1/homeworks/:homeworkId/submissions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/homeworks/:homeworkId/submissions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'studentId' => '<string>',
    'files' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: <content-type>",
    "x-tenant-api-secret: <x-tenant-api-secret>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/homeworks/:homeworkId/submissions"

	payload := strings.NewReader("{\n  \"studentId\": \"<string>\",\n  \"files\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "<content-type>")
	req.Header.Add("x-tenant-api-secret", "<x-tenant-api-secret>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/v1/homeworks/:homeworkId/submissions")
  .header("Content-Type", "<content-type>")
  .header("x-tenant-api-secret", "<x-tenant-api-secret>")
  .body("{\n  \"studentId\": \"<string>\",\n  \"files\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/homeworks/:homeworkId/submissions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = '<content-type>'
request["x-tenant-api-secret"] = '<x-tenant-api-secret>'
request.body = "{\n  \"studentId\": \"<string>\",\n  \"files\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "id": "sub_123456789",
  "homeworkId": "123e4567-e89b-12d3-a456-426614174000",
  "chatId": "chat_987654321",
  "status": "submitted",
  "chatIframeUrl": "https://chat.lexiconlabs.ai/?chat_id=chat_987654321",
  "createdAt": "2023-07-15T14:32:17Z",
  "analysis": "",
  "grade": ""
}

POST

homeworks

:homeworkId

submissions

Create Homework Submission

curl --request POST \
  --url https://api.example.com/v1/homeworks/:homeworkId/submissions \
  --header 'Content-Type: <content-type>' \
  --header 'x-tenant-api-secret: <x-tenant-api-secret>' \
  --data '
{
  "studentId": "<string>",
  "files": {}
}
'

import requests

url = "https://api.example.com/v1/homeworks/:homeworkId/submissions"

payload = {
    "studentId": "<string>",
    "files": {}
}
headers = {
    "Content-Type": "<content-type>",
    "x-tenant-api-secret": "<x-tenant-api-secret>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Content-Type': '<content-type>',
    'x-tenant-api-secret': '<x-tenant-api-secret>'
  },
  body: JSON.stringify({studentId: '<string>', files: {}})
};

fetch('https://api.example.com/v1/homeworks/:homeworkId/submissions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/homeworks/:homeworkId/submissions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'studentId' => '<string>',
    'files' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: <content-type>",
    "x-tenant-api-secret: <x-tenant-api-secret>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/homeworks/:homeworkId/submissions"

	payload := strings.NewReader("{\n  \"studentId\": \"<string>\",\n  \"files\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "<content-type>")
	req.Header.Add("x-tenant-api-secret", "<x-tenant-api-secret>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/v1/homeworks/:homeworkId/submissions")
  .header("Content-Type", "<content-type>")
  .header("x-tenant-api-secret", "<x-tenant-api-secret>")
  .body("{\n  \"studentId\": \"<string>\",\n  \"files\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/homeworks/:homeworkId/submissions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = '<content-type>'
request["x-tenant-api-secret"] = '<x-tenant-api-secret>'
request.body = "{\n  \"studentId\": \"<string>\",\n  \"files\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "id": "sub_123456789",
  "homeworkId": "123e4567-e89b-12d3-a456-426614174000",
  "chatId": "chat_987654321",
  "status": "submitted",
  "chatIframeUrl": "https://chat.lexiconlabs.ai/?chat_id=chat_987654321",
  "createdAt": "2023-07-15T14:32:17Z",
  "analysis": "",
  "grade": ""
}

Create Homework Submission

This endpoint allows students to upload their homework files for review.

Path Parameters

string

required

The UUID of the homework being submitted

Request Body

string

required

The ID of the student submitting the homework

array of files

required

The files containing the student’s homework solution (max 10 files)

Headers

string

required

multipart/form-data

string

required

Your API authentication key

Response

string

The unique identifier for the submission

string

The ID of the homework being submitted

string

The ID of the chat session created for this submission review

string

The current status of the submission. Possible values: ‘submitted’ (initial state), ‘reviewed’ (AI has reviewed), ‘approved’ (meets requirements), or ‘needs_revision’ (requires changes).

string

URL for the chat interface

string

Timestamp when the submission was created

string

AI analysis of the submission

string

Grade assigned to the submission. Possible values: ‘A’, ‘B’, ‘C’, ‘D’, ‘E’, ‘F’.

{
  "id": "sub_123456789",
  "homeworkId": "123e4567-e89b-12d3-a456-426614174000",
  "chatId": "chat_987654321",
  "status": "submitted",
  "chatIframeUrl": "https://chat.lexiconlabs.ai/?chat_id=chat_987654321",
  "createdAt": "2023-07-15T14:32:17Z",
  "analysis": "",
  "grade": ""
}

Error Responses

400: Bad Request

Invalid input parameters

401: Unauthorized

Invalid or missing API key

404: Not Found

Homework not found

500: Internal Server Error

Processing error

Example Usage

cURL

curl -X POST "https://api.lexiconlabs.ai/v1/homeworks/123e4567-e89b-12d3-a456-426614174000/submissions" \
  -H "Content-Type: multipart/form-data" \
  -H "x-tenant-api-secret: YOUR_API_KEY" \
  -F "studentId=student123" \
  -F "files=@solution.py" \
  -F "files=@report.txt"

JavaScript

const formData = new FormData();
formData.append('studentId', 'student123');
formData.append('files', fileInput.files[0]);
formData.append('files', fileInput.files[1]);

// Replace with the actual homework UUID
const homeworkId = '123e4567-e89b-12d3-a456-426614174000';
fetch(`https://api.lexiconlabs.ai/v1/homeworks/${homeworkId}/submissions`, {
  method: 'POST',
  headers: {
    'x-tenant-api-secret': 'YOUR_API_KEY'
  },
  body: formData
})
.then(response => response.json())
.then(data => {
  const chatId = data.chatId;
  // Redirect to chat interface or embed iframe
  window.location.href = `https://chat.lexiconlabs.ai/?chat_id=${chatId}`;
})
.catch(error => console.error('Error:', error));

Chats

Homeworks

Create Homework Submission

Create Homework Submission

Path Parameters

Request Body

Headers

Response

Error Responses

Example Usage

cURL

JavaScript

​Create Homework Submission

​Path Parameters

​Request Body

​Headers

​Response

​Error Responses

​Example Usage

​cURL

​JavaScript

Create Homework Submission

Path Parameters

Request Body

Headers

Response

Error Responses

Example Usage

cURL

JavaScript