Application employment

Update an employment entry

Replaces an employment entry with the values you send and returns it. Every field is overwritten, so anything you leave out is cleared. Requires the rental_applications:write permission.

PUT

https://services.magicdoor.com/leasing/company-portal/rental-applications/{applicationId}/employment/{id}

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

applicationIdstringrequired

The rental application to work with. A Snowflake id, sent as a decimal string.

example: 1830472847398404096

idstringrequired

The employment entry to work with. A Snowflake id, sent as a decimal string.

example: 1832746510293847552

Body

application/json

Send the entry in full — this is a replace, not a merge.

namestring

Employer name. At most 250 characters.

phonestring

Employer phone number.

salarynumber

Annual salary for this job, as a decimal amount, for example 72000.00.

jobTitlestring

The applicant's job title. At most 250 characters.

startDatestring · date

First day at this employer, as YYYY-MM-DD.

endDatestring · date

Last day at this employer, as YYYY-MM-DD. Leave it out while the job is current.

commentstring

Free-text note. At most 500 characters.

Response

200 · The updated employment entry. `files` is always empty here — read the application to see attached documents.

idstring

The employment entry.

namestring

Employer name. Absent when the applicant did not give one.

phonestring

Employer phone number.

salarynumber

Annual salary the applicant stated for this job, as a decimal amount, for example 72000.00.

jobTitlestring

The applicant's job title.

startDatestring · date

First day at this employer.

endDatestring · date

Last day at this employer. Absent while the job is current.

commentstring

Free-text note stored with the entry.

filesFile[]

Documents attached to this employment entry, such as pay stubs. Empty when none.

createdstring · date-time

When the entry was added, in the company's timezone.

updatedstring · date-time

When the entry was last changed, in the company's timezone.

401 · The access token is missing, expired, or not valid.

403 · The caller is authenticated but does not hold the `rental_applications:write` permission.

404 · No employment entry with this id exists on this rental application, or the rental application itself was not found.

Allowed in every application status

This is not gated on the application's status — it works on a draft, on a submitted application, and on a retracted one. Only the applicant-facing portal locks an application once it is submitted.