Start free trial

Create staff assignment

POST/api/v1/advisory-firms/{firm_id}/users/{user_id}/assignments

Assign a member to a business with optional engagement metadata.

Operation ID: create_assignment_api_v1_advisory_firms__firm_id__users__user_id__assignments_post·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Path

firm_idstringrequired
user_idstringrequired

Request body

Schema: CreateStaffAssignmentRequest

business_idstringrequired

Business to assign.

engagement_typestring

Type of engagement: tax_preparation, audit, bookkeeping, advisory, etc.

start_datestring

Engagement start date (YYYY-MM-DD).

end_datestring

Engagement end date (YYYY-MM-DD).

notesstring

Notes about the assignment.

Responses

201Successful Response

Schema: SuccessEnvelope_StaffAssignmentResponse_

successboolean
messagestring
codestring
dataapp__api__v1__schemas__advisory_firms__firm__StaffAssignmentResponse

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

409Conflict - Resource already exists

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError
5 fields
locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject