Update an application
Updates the supplied internal note, candidate-portal state, and hiring-team assignments. Omitted fields are preserved; nullable team IDs clear their assignment, while internal_note and is_portal_enabled are write-only because the summary does not expose them. The response is re-read after the update and contains the readable application summary.
Authorizations
API tokens are passed as Bearer tokens.
Path Parameters
an application ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.
^(?:app_)?(?:[0-9a-fA-F]{32}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"app_a1b2c3d4e5f64789a1b2c3d4e5f64789"
Body
Replaces the internal note; omit to preserve. Write-only.
an employee ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.
^(?:emp_)?(?:[0-9a-fA-F]{32}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"emp_a1b2c3d4e5f64789a1b2c3d4e5f64789"
Replaces portal state; omit to preserve. Write-only.
an employee ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.
^(?:emp_)?(?:[0-9a-fA-F]{32}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"emp_a1b2c3d4e5f64789a1b2c3d4e5f64789"
an employee ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.
^(?:emp_)?(?:[0-9a-fA-F]{32}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"emp_a1b2c3d4e5f64789a1b2c3d4e5f64789"
an employee ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.
^(?:emp_)?(?:[0-9a-fA-F]{32}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"emp_a1b2c3d4e5f64789a1b2c3d4e5f64789"
Response
Success
Canonical application ID (app_ followed by 32 lowercase hexadecimal UUID characters).
^app_[0-9a-f]{32}$"app_a1b2c3d4e5f64789a1b2c3d4e5f64789"
ACTIVE, REJECTED, HIRED, CONVERTED, ARCHIVED ISO 8601 timestamp.
ISO 8601 timestamp.
ISO 8601 timestamp.