v1

latestOpenAPI 3.1.02026-07-24181585937.4 KB
Take Home Assignment

takeHomeAssignment.info

Beta

This endpoint is in beta and may not be available for all organizations.

Retrieves a single take-home assignment by id and links it to its interview definition through interviewId. Pass expand: ["interview"] to include that definition. Returns take_home_assignment_not_found if the id does not exist or is not visible to the caller.

Requires the interviewsRead permission.

post/takeHomeAssignment.info

Request body

takeHomeAssignmentIdstring uuid required

The id of the take-home assignment

expandstring[] nullable

Choose to expand the result and include the related interview definition.

Example request

{
  "takeHomeAssignmentId": "e9ed20fd-d45f-4aad-8a00-a19bfba0083e"
}

Response

Responses from the takeHomeAssignment.info endpoint

OR

Example response

{
  "success": true,
  "results": {
    "id": "e9ed20fd-d45f-4aad-8a00-a19bfba0083e",
    "applicationId": "7211e226-7802-41fd-8d55-2720fe9d534f",
    "candidateId": "bf94fe6c-2571-4745-a59e-50921782705e",
    "interviewStageId": "c153b3e9-8b97-4fc0-bad1-6c654122c1f8",
    "interviewId": "ff6c7d9d-71e3-4c9c-88b1-28824980c276",
    "status": "WaitingOnFeedback",
    "createdAt": "2026-04-25T02:46:41.817Z",
    "updatedAt": "2026-04-25T02:46:46.230Z",
    "submission": {
      "id": "1595e4fc-8140-454e-a25d-853b0947ecf8",
      "submittedAt": "2026-04-25T02:46:46.230Z",
      "notesHtml": "<p>This is my submission.</p>",
      "notesPlain": "This is my submission.",
      "fileHandles": [
        {
          "id": "9a9fc77a-0d83-4487-ae65-bb2f90c074f8",
          "name": "take-home-submission.pdf",
          "handle": "encrypted-file-handle"
        }
      ]
    },
    "feedbackFormDefinitionId": "46648e83-f28f-43c4-a2a0-58e0599cff41",
    "reviewers": [
      {
        "userId": "a6ad83df-8f93-4dc2-8588-76f29cc0b5f0",
        "interviewEventId": "4736b6d2-5c97-43a6-a7c6-0228bf079411",
        "feedbackLink": "https://app.ashbyhq.com/interview-briefings/4736b6d2-5c97-43a6-a7c6-0228bf079411/feedback",
        "hasSubmittedFeedback": false,
        "feedbackSubmittedAt": null
      }
    ]
  }
}