v1

latestOpenAPI 3.1.02026-07-24181585937.4 KB
Offer

offer.setDecidedAt

Updates an offer's decidedAt timestamp.

Requires the offersWrite permission.

post/offer.setDecidedAt

Request body

offerIdstring uuid required

The id of the offer whose decided at timestamp should be updated.

decidedAtstring date-time required

The time the offer was accepted or declined.

excludeFormDefinitionboolean nullable

If true, omit the form definition from the response.

Response

Responses from the offer.setDecidedAt endpoint

OR

Example response

{
  "success": true,
  "results": {
    "id": "8bd7d0d4-98bb-4bfa-8d42-13b2efd3ba88",
    "decidedAt": "2026-06-01T12:00:00.000Z",
    "applicationId": "3d9539db-cd22-4f7f-a8f9-a9d5d1f364dd",
    "acceptanceStatus": "Pending",
    "offerStatus": "WaitingOnCandidateResponse",
    "latestVersion": {
      "id": "698a9280-0a1d-4e72-acd0-b45c771363e8",
      "startDate": "2026-05-01",
      "salary": {
        "value": 100000,
        "currencyCode": "USD"
      },
      "createdAt": "2026-04-25T02:07:01.594Z",
      "openingId": "1bdb1c73-6ed5-4fc2-8486-16ce03a57c67",
      "customFields": [],
      "fileHandles": [],
      "approvalStatus": null
    },
    "formDefinition": {
      "sections": [
        {
          "fields": [
            {
              "isRequired": true,
              "field": {
                "id": "69c5aa80-34c1-4385-88ed-b2b2676e639d",
                "type": "UUID",
                "path": "opening.id",
                "humanReadablePath": "Opening",
                "title": "Opening",
                "isNullable": false
              }
            }
          ]
        }
      ]
    },
    "versions": []
  }
}