The Submissions API from Clever — 1 operation(s) for submissions.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/clever-submissions-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
description: Serves the Clever Data API
title: Data Assignments Submissions API
version: 3.1.0
servers:
- url: https://api.clever.com/v3.1
security:
- oauth: []
tags:
- name: Submissions
paths:
/sections/{section_id}/assignments/{assignment_id}/submissions/{user_id}:
get:
description: Returns a specific user's submission for an assignment.
operationId: getSubmissionForAssignment
parameters:
- in: path
name: section_id
required: true
schema:
type: string
format: mongo-id
- in: path
name: assignment_id
required: true
schema:
type: string
- in: path
name: user_id
required: true
schema:
type: string
format: mongo-id
responses:
'200':
description: OK Response
content:
application/json:
schema:
$ref: '#/components/schemas/SubmissionResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
tags:
- Submissions
patch:
description: Updates an existing submission in the specified assignment for a user.
operationId: updateSubmissionForAssignment
parameters:
- in: path
name: section_id
required: true
schema:
type: string
format: mongo-id
- in: path
name: assignment_id
required: true
schema:
type: string
- in: path
name: user_id
required: true
schema:
type: string
format: mongo-id
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SubmissionRequest'
required: true
responses:
'200':
description: OK Response
content:
application/json:
schema:
$ref: '#/components/schemas/SubmissionResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'500':
$ref: '#/components/responses/InternalError'
tags:
- Submissions
components:
schemas:
BadRequest:
properties:
message:
type: string
type: object
AttachmentRequest:
properties:
description:
type:
- string
- 'null'
title:
type:
- string
- 'null'
type:
enum:
- file
type: string
url:
type:
- string
- 'null'
type: object
InternalError:
properties:
message:
type: string
type: object
SubmissionFlag:
enum:
- excused
- late
- missing
type: string
Attachment:
properties:
description:
type:
- string
- 'null'
file_external_id:
type:
- string
- 'null'
size:
format: float
type: number
x-omitempty: true
thumbnail_url:
type:
- string
- 'null'
title:
type:
- string
- 'null'
type:
type: string
url:
type:
- string
- 'null'
type: object
SubmissionResponse:
properties:
data:
$ref: '#/components/schemas/Submission'
type: object
NotFound:
properties:
message:
type: string
type: object
SubmissionRequest:
properties:
attachments:
items:
$ref: '#/components/schemas/AttachmentRequest'
type: array
x-omitempty: true
extra_attempts:
type: integer
x-omitempty: true
flags:
items:
$ref: '#/components/schemas/SubmissionFlag'
type: array
x-omitempty: true
grade:
type:
- string
- 'null'
grade_comment:
type:
- string
- 'null'
grade_points:
format: float
type: number
x-omitempty: true
grader_id:
type:
- string
- 'null'
override_due_date:
format: datetime
type:
- string
- 'null'
state:
$ref: '#/components/schemas/SubmissionState'
type: object
SubmissionState:
enum:
- created
- submitted
- returned
- reclaimed
type: string
Unauthorized:
properties:
message:
type: string
type: object
Submission:
properties:
assignment_id:
type: string
attachments:
items:
$ref: '#/components/schemas/Attachment'
type: array
x-omitempty: true
created:
format: datetime
type:
- string
- 'null'
extra_attempts:
type: integer
x-omitempty: true
flags:
items:
$ref: '#/components/schemas/SubmissionFlag'
type: array
x-omitempty: true
grade:
type:
- string
- 'null'
grade_comment:
type:
- string
- 'null'
grade_points:
format: float
type: number
x-omitempty: true
grader_id:
type:
- string
- 'null'
id:
description: 'Deprecated. The Clever unique identifier of the submission. Will always be empty if the
upstream LMS provider is Google Classroom; it is currently still present for Canvas and
Schoology LMSs but will be removed in the near future.
'
type: string
last_modified:
format: datetime
type:
- string
- 'null'
override_due_date:
format: datetime
type:
- string
- 'null'
state:
$ref: '#/components/schemas/SubmissionState'
user_id:
type: string
type: object
responses:
Unauthorized:
description: Not authorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
BadRequest:
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
InternalError:
description: Internal Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalError'
NotFound:
description: Entity Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
securitySchemes:
oauth:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://clever.com/oauth/authorize
tokenUrl: https://clever.com/oauth/tokens
scopes: {}
x-samples-languages:
- curl
- node
- ruby
- python
- php
- java
- go