Register an external grader
Registers an author-hosted grading endpoint as a Tier 2 external grader. The platform makes a live test call against the URL; only endpoints that return a coercible grading response are accepted. Returns the registered grader’s stable id, which content items reference to route grading through the platform proxy.
Authorizations
OAuth 2.0 client credentials flow. Contact timeback@trilogy.com to request credentials for your application.
Body
Body for registering a new external grader
HTTPS URL of the grading endpoint. Must resolve to a public host.
2048How the platform authenticates outbound calls to the grader.
none, api_key Credential material sent on every outbound call to the grader. Must be null when authenticationType is none; required (non-empty string) when authenticationType is api_key.
Encrypted at rest via KMS; never returned in any response.
Wire mapping: api_key → X-Api-Key: <credential>.
1 - 16384Response
External grader registered
External grader as visible to the registering caller. authenticationCredential is deliberately absent — write-only material never leaves the platform.
Stable identifier. Content items bind to graders by this id.
Grading endpoint URL.
How the platform authenticates outbound calls to the grader.
none, api_key Lifecycle state of an external grader
active, revoked ISO 8601 timestamp of registration.
ISO 8601 timestamp of the last modification.