Update external grader

​

Replaces the mutable fields of an external grader. If the incoming url differs from the stored one, the platform re-runs the live test call before persisting; a matching url with only a status flip skips the probe.

OAuth scopes
  • https://timeback-platform.trilogy.com/content/scope/content.write

Path Parameters

  • graderId
    Type: stringFormat: uuid
    required

    External grader identifier (UUID)

Body·

required
application/json

Body for replacing an external grader's mutable fields. Full-replace semantics — every field is required, including authenticationCredential (must be re-supplied even when unchanged so the platform can re-probe with plaintext).

  • authenticationCredential
    Type:
    min length:  
    1
    max length:  
    16384
    write-only
    required

    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>.

  • authenticationType
    Type: enum
    required

    How the platform authenticates outbound calls to the grader.

    values
    noneapi_key
  • status
    Type: enum
    required

    Lifecycle state of an external grader

    values
    activerevoked
  • url
    Type: string
    max length:  
    2048    Format: uri
    required

    HTTPS URL of the grading endpoint. Must resolve to a public host.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for put/content/1.0/external-graders/{graderId}
curl https://platform.dev.timeback.com/content/1.0/external-graders/123e4567-e89b-12d3-a456-426614174000 \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "url": "",
  "status": "active",
  "authenticationType": "none",
  "authenticationCredential": null
}'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "url": "https://example.com",
  "authenticationType": "none",
  "status": "active",
  "dateCreated": "2026-10-15T15:46:52.932Z",
  "dateLastModified": "2026-10-15T15:46:52.932Z"
}

External grader updated

Previous
Get external grader
Next
Revoke external grader