---
title: "Update a partner action"
method: PUT
path: "/partners/actions/{act}"
tags: ["Partner Action API:Actions"]
---

# Update a partner action

`PUT /partners/actions/{act}`

## Path parameters

- `act` string, uuid, required

## Request body

- UpdatePartnerActionCommand
  - `actionName` string, nullable, required — Menu item label that will appear to the end-user
  - `reference` string, nullable — Unique partner defined reference/identifier for the action
  - `url` string, uri, nullable — URL to open after the action is selected and assigned the `"Submitted"` stage.\ Templates parameters can be used in the URL to identify the resource submitted to the action <table><tr><td>`{userId}`</td><td>Replaced with the User Id of the user performing the action</td></tr><tr><td>`{jobId}`</td><td>Replaced with the Job Id</td></tr><tr><td>`{adId}`</td><td>Replaced with the Job Ad Id</td></tr><tr><td>`{candidateId}`</td><td>Replaced with the Candidate Id</td></tr><tr><td>`{applicationId}`</td><td>Replaced with the Job Application Id</td></tr><tr><td>`{placementId}`</td><td>Replaced with the Placement Id</td></tr><tr><td>`{companyId}`</td><td>Replaced with the Company Id</td></tr><tr><td>`{contactId}`</td><td>Replaced with the Contact Id</td></tr></table>
  - `urlType` 'Popup' | 'Page' | 'SideDrawer', string
  - `allowResubmit` boolean — Allow resources to be resubmitted to an action.
  - `actionFilter` PartnerActionFilterModel
    - `adminOnly` boolean — Action is available to admin users only
    - `approvedOnly` boolean — Action is only available on approved entities (currently only supported for placements)
    - `status` PartnerActionStatusFilterModel
      - `activeOnly` boolean — Action is available to entities with an active status
      - `statusId` integer[], nullable — Action is available to entities with a specific status
  - `salt` string, nullable — [The secret for hashing secured Url](https://jobadderapi.zendesk.com/hc/en-us/articles/14042921159823-Partner-Action-Security-Hashed-URL)
  - `webhookData` unknown

## Response `200`

OK

- PartnerActionRepresentation
  - `actionId` string, uuid — Unique identifier for the partner action
  - `actionType` 'Job' | 'JobAd' | 'Candidate' | 'JobApplication' | 'Placement' | 'Company' | 'Contact', string
  - `actionName` string, nullable — Menu item label that will appear to the end-user
  - `reference` string, nullable — Unique partner defined reference/identifier for the action
  - `url` string, uri, nullable — URL to open after the action is selected and assigned the `"Submitted"` stage.
  - `urlType` 'Popup' | 'Page' | 'SideDrawer', string
  - `allowResubmit` boolean — Allow resources to be resubmitted to an action.
  - `actionFilter` PartnerActionFilterModel
    - `adminOnly` boolean — Action is available to admin users only
    - `approvedOnly` boolean — Action is only available on approved entities (currently only supported for placements)
    - `status` PartnerActionStatusFilterModel
      - `activeOnly` boolean — Action is available to entities with an active status
      - `statusId` integer[], nullable — Action is available to entities with a specific status
  - `webhookData` unknown
  - `createdAt` string, date-time — Date the partner action was added
  - `updatedAt` string, date-time — Date the partner action was last updated
  - `links` ModelLinks
    - `self` string, uri, nullable

## Other responses

- `404` — Partner action was not found

---

[API](https://skmtc.net/jobadder/apis/jobadder-api.md) · [All operations](https://skmtc.net/jobadder/apis/jobadder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jobadder/jobadder-api/revisions/9f43f6a6ee6e/schema)