---
title: "Update deployment integration action"
method: PATCH
path: "/v1/deployments/{deploymentId}/integrations/{integrationConfigurationId}/resources/{resourceId}/actions/{action}"
tags: ["deployments", "integrations"]
---

# Update deployment integration action

`PATCH /v1/deployments/{deploymentId}/integrations/{integrationConfigurationId}/resources/{resourceId}/actions/{action}`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/deployments/{deploymentId}/integrations/{integrationConfigurationId}/resources/{resourceId}/actions/{action}`
- Auth: HTTP bearer

Updates the deployment integration action for the specified integration installation

## Path parameters

- `deploymentId` string, required
- `integrationConfigurationId` string, required
- `resourceId` string, required
- `action` string, required

## Request body

- object
  - `status` 'running' | 'succeeded' | 'failed'
  - `statusText` string
  - `statusUrl` string, uri
  - `outcomes` union[]
    - union
      - object
        - `kind` string, required
        - `secrets` object[], required
          - `name` string, required
          - `value` string, required
      - object: Claim rules applied after the resource’s own rules when this deployment mints a resource token. Reserved claims cannot be set.
        - `kind` string, required
        - `claimRules` object[], required: Ordered rules resolved at mint time. Later rules win and shallow-merge over earlier ones.
          - `when` object
            - `role` string[]: Applies only when the token is minted for one of these roles.
            - `environment` string[]: Applies only when the token is minted for one of these environments: `production`, `preview`, `development`, or a custom environment slug. A custom environment also matches `preview`.
          - `claims` object, required: Claims to set (string, number, boolean, or array of strings), shallow-merged over earlier rules and over the default claims. `null` removes a claim. Reserved claims cannot be set; `aud` and `sub` can be overridden with a string but not removed.

## Response `202`

## Other responses

- `400`: One of the provided values in the request body is invalid. One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `410`

## Changes

- **2026-10-15** `8939e3983223`: 2 breaking, 1 info
  - the request property `outcomes/items/oneOf[subschema #2]/claimRules/items/claims/additionalProperties/` became not nullable
  - removed `subschema #1, subschema #2, subschema #3` from the `outcomes/items/oneOf[subschema #2]/claimRules/items/claims/additionalProperties/` request property `oneOf` list
  - added `subschema #1, subschema #2` to the `outcomes/items/oneOf[subschema #2]/claimRules/items/claims/additionalProperties/` request property `anyOf` list
- **2026-09-24** `dd6a90982ed0`: 2 info
  - added `subschema #2` to the `outcomes/items/` request property `oneOf` list
  - added the non-success response with the status `404`
- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-01-22** `c12186034433`: 1 info
  - the `kind` request property const value `resource-secrets` was removed
- **2025-10-09** `50caddad4ae7`: 1 info
  - added the new optional request property `statusUrl`

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v1/deployments/:deploymentId/integrations/:integrationConfigurationId/resources/:resourceId/actions/:action/patch.md)

---

[API](https://skmtc.dev/vercel/apis/vercel-api.md) - [All operations](https://skmtc.dev/vercel/apis/vercel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/vercel-api/revisions/60686c0e1f6a?raw)