Skip to content

API Documentation

ConceptsThe Worklayer platformAuthenticationRate Limits

MemberThe Member ResourceCreate a memberRetrieve a memberRetrieve a member by external IDRetrieve a list of membersUpdate a memberAccept terms for a member

JobsThe Job ResourceRetrieve a job by short IDThe job creation flowThe Info Gathering ChecklistCreate a job from a templateRetrieve questionnaireSubmit questionnaire answersRequest a specific ProRequest a previous ProAssign a supporting clientRemove a supporting clientSubmit a jobRetrieve a list of your jobsList job documentsDelete a jobRetrieve a job checklistComplete info gathering for a jobRequest cancellationRequest reopen

Relationship ManagerRelationship Manager ResourceRetrieve a job relationship manager

Job ProgressionsApprove a draftReject a draftMark job as ready to file

ConsultationsThe Consultation Resource

Scope Change RequestsChange job scopeList consultation service itemsCreate job scope change requestApprove a job scope changeReject a job scope change

Job TemplatesThe Job Template ResourceRetrieve available job templates

Personal ProfilesThe Personal Profile ResourceRetrieve a personal profileSave a personal profileProvide a personal profile to a jobRetrieve a personal profile for a job

Spousal ProfilesThe Spousal Profile ResourceRetrieve a spousal profileSave a spousal profileProvide a spousal profile to a jobRetrieve a spousal profile for a job

Dependent ProfilesThe Dependent Profile ResourceList dependent profilesRetrieve a dependent profileCreate a dependent profileUpdate a dependent profileDelist a dependent profileProvide a dependent profile to a jobRemove a dependent profile from a jobRetrieve dependent profiles for a job

Business ProfilesThe Business Profile ResourceList business profilesCreate a business profileUpdate a business profileRetrieve a business profileRetrieve a business profile for a jobDelist a business profileProvide a business profile to a job

Tax Refund MethodsThe Tax Refund Method ResourceList tax refund methodsCreate a tax refund methodRetrieve a tax refund methodRetrieve a tax refund method for a jobUpdate a tax refund methodDelist a tax refund methodProvide a personal refund methodProvide a business refund method

DocumentsThe Document ResourceCreate a documentGet a documentDownload a documentDelete a document

Document TypesThe Document Type ResourceList document types

MessagesThe Message ResourceSend a messageList messagesGet unread count

OCRStart OCR processingGet OCR results

WebhooksConsume webhook eventsEvent resourcesCheck signatures

Magic LinkDashboardJob DetailsWaitlist

PortalPortal embedding

GuidesFilteringPostman Collection

Remove a Supporting Client

Remove a supporting client from a job.

Removes a supporting client from a job. Only clients that were added as supporting clients can be removed with this endpoint; the primary CHAMPION client cannot.

After removal, the client no longer appears in the job's members array.

Tip

Need to add a supporting client instead? See Assign a supporting client.

Endpoint

Method	Url
`DELETE`	`v1.0/jobs/{job_id}/supporting-clients/{client_id}`

Url Parameters

job_id

•

guid

ID of the job to remove the supporting client from.

client_id

•

guid

The user ID of the supporting client to remove.

Sample Request

bashCopied
1curl -X DELETE 'https://api.worklayer.com/v1.0/jobs/499d692d-67aa-4127-a45c-b9e27f54afad/supporting-clients/4fec291a-fbb8-413a-86c0-f25f51c57ddc' \
2-H 'Authorization: Bearer {token}'

Response

The updated job belonging to your workspace, with the supporting client removed from its members array. See the job resource page.

Sample Response

jsonCopied
1{
2  "id": "499d692d-67aa-4127-a45c-b9e27f54afad",
3  "short_id": "TWQXJWMABW8",
4  "name": "The name of the job",
5  "description": "Tony Stark | 2021 | 1040",
6  "status": "INFO_GATHERING",
7  "create_time": "2021-04-28T13:45:25.781Z",
8  "update_time": "2021-04-28T13:52:27.379Z",
9  "total_amount": 10,
10  "members": [
11    {
12      "role": "CHAMPION",
13      "type": "CLIENT",
14      "user_id": "a4feef24-00da-4340-8b7c-a532e0607fdd",
15      "given_name": "Tony",
16      "family_name": "Stark",
17      "display_name": "Tony Stark"
18    }
19  ]
20}

Errors

Forbidden: API Client does not have permission to manage supporting clients on the job.
Unauthorized: API Client does not have valid credentials.
BadRequest: The job type does not support supporting clients, or there was a malformed request.
NotFound: A job with the requested job_id, or a supporting client with the requested client_id, could not be found.

Last updated on July 9, 2026

Privacy Policy Terms & Conditions© 2026 Taxfyle