Assignment completed - Award Force

{
  "entry": {
    "slug": "AbCdEfGh",
    "link": "https://api.au.cr4ce.com/entry/AbCdEfGh",
    "title": "Project title"
  },
  "category": {
    "slug": "WxYzAbCd",
    "link": "https://api.au.cr4ce.com/category/WxYzAbCd",
    "name": {
      "en_GB": "Documentary"
    }
  },
  "chapter": {
    "slug": "MnOpQrSt",
    "link": "https://api.au.cr4ce.com/chapter/MnOpQrSt",
    "name": {
      "en_GB": "Film"
    }
  },
  "comments": {
    "judging": [],
    "abstention": [],
    "conflict": [],
    "criteria": [
      {
        "name": "Originality",
        "comments": []
      },
      {
        "name": "Execution",
        "comments": []
      }
    ]
  },
  "created": "2025-01-15T09:00:00Z",
  "form": "GhIjKlMn",
  "method": "Automatic (Panel)",
  "panels": [
    {
      "slug": "OpQrStUv",
      "link": "https://api.au.cr4ce.com/panel/OpQrStUv",
      "name": {
        "en_GB": "Panel A"
      }
    }
  ],
  "judge": {
    "slug": "EfGhIjKl",
    "link": "https://api.au.cr4ce.com/judge/EfGhIjKl",
    "name": "Jane Doe"
  },
  "role": null,
  "rounds": [
    {
      "slug": "QrStUvWx",
      "link": "https://api.au.cr4ce.com/round/QrStUvWx",
      "name": {
        "en_GB": "Judging"
      }
    }
  ],
  "score": null,
  "score_set": {
    "slug": "UvWxYzAb",
    "link": "https://api.au.cr4ce.com/score-set/UvWxYzAb",
    "name": {
      "en_GB": "Scoring rubric"
    }
  },
  "slug": "AbCdEfGhEfGhIjKlUvWxYzAbA",
  "status": "To be scored",
  "updated": "2025-06-20T14:30:00Z",
  "event": "Assignment completed",
  "timestamp": "2026-08-14T09:30:00Z",
  "trigger": "assignment_completed",
  "source": "ui"
}

WEBHOOK

assignment-completed

{
  "entry": {
    "slug": "AbCdEfGh",
    "link": "https://api.au.cr4ce.com/entry/AbCdEfGh",
    "title": "Project title"
  },
  "category": {
    "slug": "WxYzAbCd",
    "link": "https://api.au.cr4ce.com/category/WxYzAbCd",
    "name": {
      "en_GB": "Documentary"
    }
  },
  "chapter": {
    "slug": "MnOpQrSt",
    "link": "https://api.au.cr4ce.com/chapter/MnOpQrSt",
    "name": {
      "en_GB": "Film"
    }
  },
  "comments": {
    "judging": [],
    "abstention": [],
    "conflict": [],
    "criteria": [
      {
        "name": "Originality",
        "comments": []
      },
      {
        "name": "Execution",
        "comments": []
      }
    ]
  },
  "created": "2025-01-15T09:00:00Z",
  "form": "GhIjKlMn",
  "method": "Automatic (Panel)",
  "panels": [
    {
      "slug": "OpQrStUv",
      "link": "https://api.au.cr4ce.com/panel/OpQrStUv",
      "name": {
        "en_GB": "Panel A"
      }
    }
  ],
  "judge": {
    "slug": "EfGhIjKl",
    "link": "https://api.au.cr4ce.com/judge/EfGhIjKl",
    "name": "Jane Doe"
  },
  "role": null,
  "rounds": [
    {
      "slug": "QrStUvWx",
      "link": "https://api.au.cr4ce.com/round/QrStUvWx",
      "name": {
        "en_GB": "Judging"
      }
    }
  ],
  "score": null,
  "score_set": {
    "slug": "UvWxYzAb",
    "link": "https://api.au.cr4ce.com/score-set/UvWxYzAb",
    "name": {
      "en_GB": "Scoring rubric"
    }
  },
  "slug": "AbCdEfGhEfGhIjKlUvWxYzAbA",
  "status": "To be scored",
  "updated": "2025-06-20T14:30:00Z",
  "event": "Assignment completed",
  "timestamp": "2026-08-14T09:30:00Z",
  "trigger": "assignment_completed",
  "source": "ui"
}

Headers

Signature

string

required

HMAC SHA256 signature of the request body. Generated using the webhook's signing key and the raw JSON payload.

Generate the same value in your endpoint and compare it with this header to validate the webhook payload.

Example:

"a1b2c3d4e5f67890abcdef1234567890abcdef1234567890abcdef1234567890"

Body

application/json

Payload delivered for assignment-related events.

Single judging task for an entry, addressed to either a judge or a role within a given round and score set.

entry

object

Entry the assignment refers to.

Show child attributes

category

object

Category the entry belongs to.

Show child attributes

chapter

object

Chapter the category belongs to.

Show child attributes

comments

object | null

Comments attached to the assignment, null for role-based assignments.

Show child attributes

created

string<date-time>

Date and time when the assignment was created.

form

string

Slug of the form attached to the entry.

method

string

How the assignment was created, for example Manual, Automatic (Panel), Recused, or Stray.

panels

object[]

Panels the assignment is associated with.

Show child attributes

judge

object | null

Judge assigned to score the entry, null for role-based assignments.

Show child attributes

role

object | null

Role assigned to score the entry, null for judge-specific assignments.

Show child attributes

rounds

object[]

Rounds the assignment applies to.

Show child attributes

score

object | null

Score for this assignment, formatted per the score-set mode, null when no score has been recorded.

score_set

object | null

Score set used to evaluate the entry.

Show child attributes

slug

string

Short URL-safe identifier for the assignment.

status

string

Current state of the assignment, for example To be scored, In progress, or Complete.

updated

string<date-time>

Date and time when the assignment was last updated.

event

string

Human-readable name of the event that triggered the webhook.

Example:

"Assignment completed"

timestamp

string<date-time>

ISO 8601 formatted datetime indicating when the event occurred.

Example:

"2020-01-01T00:00:00Z"

trigger

string

Machine-readable event key that fired the webhook. Full list of events can be found here.

Example:

"assignment_completed"

source

enum<string>

default:ui

Origin of the change that triggered the event.

Available options:

ui,

api

Response

200

Return any 2xx status code to acknowledge receipt of the event.