Codequiry Submissions API
Upload code and manage submissions within a check.
Operations 3
Documentation
Documentation
https://codequiry.com/usage/api
APIReference
https://codequiry.com/usage/api/reference
Upload code and manage submissions within a check.
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/codequiry-com:codequiry-com-submissions-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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:
title: Codequiry Com Submissions API
version: 1.0.0
contact:
name: Codequiry Support
url: https://codequiry.com/contact
license:
name: Proprietary
url: https://codequiry.com/terms-of-service
description: 'Operations tagged Submissions across 2 of this provider''s published API definitions: codequiry-com-openapi-original.json, codequiry-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://codequiry.com/api/v1
description: Production
security:
- apikey: []
tags:
- name: Submissions
description: Upload code and manage submissions within a check.
paths:
/check/upload:
post:
tags:
- Submissions
operationId: uploadFile
summary: Upload a submission (ZIP)
description: Uploads one ZIP archive of source code into a check. Max 10 MB. Call once per submission, or use /check/upload-batch.
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
required:
- check_id
- file
properties:
check_id:
type: integer
description: Target check id.
example: 12345
file:
type: string
format: binary
description: ZIP archive (mimes:zip, max 10 MB).
example: nowak_alice_a4.zip
responses:
'200':
description: Upload accepted
content:
application/json:
schema:
$ref: '#/components/schemas/UploadResult'
'401':
$ref: '#/components/responses/InvalidKey'
'402':
$ref: '#/components/responses/BillingSuspended'
'429':
$ref: '#/components/responses/RateLimited'
'403':
$ref: '#/components/responses/Forbidden'
'422':
$ref: '#/components/responses/ValidationError'
'500':
$ref: '#/components/responses/ServerError'
servers:
- url: https://codequiry.com/api/v1
description: Production
/check/upload-batch:
post:
tags:
- Submissions
operationId: batchUpload
summary: Upload many submissions
description: 'Uploads 1-50 ZIP files into a check in one request. Validation is all-or-nothing: if any file is not a ZIP, is over 10 MB, or is not a file at all, the whole batch is rejected with 422 and nothing is stored - check the files before sending them. A file that passes validation but fails while being stored is reported in `failed_uploads`, alongside the ones that succeeded, with a 200 response.'
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
required:
- check_id
- files
properties:
check_id:
type: integer
example: 12345
files:
type: array
minItems: 1
maxItems: 50
items:
type: string
format: binary
example: nowak_alice_a4.zip
description: 1–50 ZIP archives (each mimes:zip, max 10 MB).
responses:
'200':
description: Batch processed
content:
application/json:
schema:
$ref: '#/components/schemas/BatchUploadResult'
'401':
$ref: '#/components/responses/InvalidKey'
'402':
$ref: '#/components/responses/BillingSuspended'
'429':
$ref: '#/components/responses/RateLimited'
'403':
$ref: '#/components/responses/Forbidden'
'422':
$ref: '#/components/responses/ValidationError'
'500':
$ref: '#/components/responses/ServerError'
servers:
- url: https://codequiry.com/api/v1
description: Production
/check/deleteSubmission:
post:
tags:
- Submissions
operationId: deleteSubmission
summary: Delete a submission
description: Removes one submission from a check. Not available on free trials (403) or demo checks (403).
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- check_id
- submission_id
properties:
check_id:
type: integer
example: 12345
submission_id:
type: integer
example: 90271
minimum: 1
responses:
'200':
description: Deleted
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
message:
type: string
example: The submission has been deleted successfully.
'401':
$ref: '#/components/responses/InvalidKey'
'402':
$ref: '#/components/responses/BillingSuspended'
'429':
$ref: '#/components/responses/RateLimited'
'403':
$ref: '#/components/responses/Forbidden'
'422':
$ref: '#/components/responses/ValidationError'
'500':
$ref: '#/components/responses/ServerError'
servers:
- url: https://codequiry.com/api/v1
description: Production
components:
responses:
ServerError:
description: Unexpected server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
ValidationError:
description: Request validation failed.
content:
application/json:
schema:
type: object
properties:
error:
type: string
validation_errors:
type: object
additionalProperties:
type: array
items:
type: string
BillingSuspended:
description: The account is suspended for an unpaid invoice. Every endpoint returns this until the invoice is paid from the billing dashboard; it is not retryable and the request was not performed.
content:
application/json:
schema:
type: object
properties:
error:
type: string
invoice:
type: string
nullable: true
description: Stripe invoice id of the unpaid invoice.
example:
error: Account suspended due to an unpaid invoice. Pay the outstanding invoice from your billing dashboard to restore API access.
invoice: in_1QxYz...
Forbidden:
description: Not permitted (e.g. free-trial limitation, or a read-only demo check).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
InvalidKey:
description: Missing or invalid API key. The API key is checked before any endpoint logic runs, so this is returned for every operation.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
missing:
summary: No apikey header
value:
error: No API Key (apikey) provided in header request
invalid:
summary: Unknown or malformed key
value:
error: Unauthorized, make sure your API Key is valid an associated with an account. Create an account at codequiry.com
RateLimited:
description: 'Rate limit exceeded: more than 60 requests in one minute from this IP. Retry after the number of seconds in the Retry-After header. Successful responses carry X-RateLimit-Limit and X-RateLimit-Remaining too, so you can pace a client without waiting to be refused.'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
X-RateLimit-Limit:
description: Always 60.
schema:
type: integer
X-RateLimit-Remaining:
description: Calls left in the window (0 here).
schema:
type: integer
X-RateLimit-Reset:
description: Unix timestamp when the window reopens. Sent only on 429.
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
schemas:
Check:
type: object
description: A check (internally an assignment). Endpoints return the full assignment row, so more fields are present than are listed here; only the stable, documented ones are shown.
properties:
stats:
type: object
nullable: true
description: Present only when the list was requested with with_stats=1. Averages and maxima are over finished submissions and are null when there are none.
properties:
submissions:
type: integer
example: 24
completed:
type: integer
example: 24
failed:
type: integer
example: 0
avg_group:
type: number
nullable: true
example: 18.4
max_group:
type: number
nullable: true
example: 82
avg_web:
type: number
nullable: true
example: 9.1
max_web:
type: number
nullable: true
example: 100
flagged:
type: integer
example: 2
description: Finished submissions at or above 75% Group or Web.
avg_ai:
type: number
nullable: true
example: 31.6
max_ai:
type: number
nullable: true
example: 97.2
ai_submissions:
type: integer
example: 24
ai_flagged:
type: integer
example: 3
description: Submissions whose mean AI probability is 75% or more.
matches:
type: integer
example: 41
description: 'Match total as the dashboard counts it: peer fragments, web sources (one per source) and AI blocks.'
id:
type: integer
example: 12345
name:
type: string
example: CS-201 Assignment 4
status_id:
type: integer
example: 4
language_id:
type: integer
example: 13
test_type:
type: integer
example: 1
ai_run:
type: integer
description: 1 if AI-generated-code detection runs for this check.
example: 1
base_code_detection:
type: integer
description: 1 if base/boilerplate-code detection is enabled.
example: 0
created_at:
type: string
example: '2026-08-11 09:14:02'
updated_at:
type: string
example: '2026-08-11 09:41:37'
assignmentstatuses:
type: object
description: Expanded status, included only by GET/POST /checks. Not returned by /check/create, /check/get or /check/update - use status_id there, or the top-level status string that /check/get returns.
properties:
id:
type: integer
example: 4
status:
type: string
example: Completed
Error:
type: object
properties:
error:
type: string
example: Invalid check_id provided.
UploadResult:
type: object
properties:
data:
type: array
description: The submission rows created by this upload.
items:
type: object
properties:
id:
type: integer
example: 90271
filename:
type: string
description: Archive name without the .zip extension.
example: nowak_alice_a4
file_size:
type: integer
description: Bytes stored.
example: 10874
status_id:
type: integer
description: 2 (ready) immediately after upload.
example: 2
created_at:
type: string
example: '2026-08-11 09:14:02'
file:
type: string
example: nowak_alice_a4.zip
file_size:
type: integer
example: 10874
submission_count:
type: integer
example: 12
check:
$ref: '#/components/schemas/Check'
BatchUploadResult:
type: object
properties:
success:
type: boolean
example: true
message:
type: string
example: 3 of 4 files uploaded.
uploaded:
type: array
items:
type: object
properties:
id:
type: integer
example: 90271
filename:
type: string
example: nowak_alice_a4.zip
file_size:
type: integer
example: 10874
status_id:
type: integer
example: 2
uploaded_count:
type: integer
example: 3
failed_count:
type: integer
example: 1
failed_uploads:
type: array
items:
type: object
properties:
file:
type: string
example: duffy_erin_a4.rar
error:
type: string
example: 'The files.3 must be a file of type: zip.'
check:
$ref: '#/components/schemas/Check'
securitySchemes:
apikey:
type: apiKey
in: header
name: apikey
description: Your 64-character API key from the Codequiry dashboard.
x-refined-from:
- codequiry-com-openapi-original.json
- codequiry-com-openapi.yml