> ## Documentation Index > Fetch the complete documentation index at: https://pipedream.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Update app override > Update an app override's name, custom field values, or OAuth client selection ## OpenAPI ````yaml put /v1/connect/{project_id}/app_overrides/{id} openapi: 3.0.4 info: version: 2.0.0 title: Pipedream REST API servers: - url: https://api.pipedream.com security: [] paths: /v1/connect/{project_id}/app_overrides/{id}: parameters: - name: project_id in: path required: true description: The project ID, which starts with `proj_`. schema: type: string pattern: ^proj_[a-zA-Z0-9]+$ x-fern-sdk-variable: project_id - name: id in: path required: true description: The app override ID, which starts with `ao_`. schema: type: string pattern: ^ao_[0-9A-Za-z]+$ put: summary: Update app override description: >- Update an app override's name, custom field values, or OAuth client selection operationId: updateAppOverride parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateAppOverrideOpts' responses: '200': description: app override updated content: application/json: schema: $ref: '#/components/schemas/AppOverride' '400': description: sensitive custom field cannot be pre-defined '429': description: too many requests headers: Retry-After: description: Number of seconds until the rate limit resets schema: type: integer X-RateLimit-Limit: schema: type: integer description: The rate limit threshold X-RateLimit-Remaining: schema: type: integer description: Number of requests remaining (always 0 when throttled) X-RateLimit-Reset: schema: type: integer description: Unix timestamp when the rate limit resets content: application/json: schema: type: object properties: error: type: string example: Throttled security: - OAuth2: [] x-codeSamples: - lang: java label: Java SDK source: > package com.example.usage; import com.pipedream.api.BaseClient; import com.pipedream.api.resources.appoverrides.requests.UpdateAppOverrideOpts; public class Example { public static void main(String[] args) { BaseClient client = BaseClient.withCredentials("", "") .projectId("YOUR_PROJECT_ID") .build() ; client.appOverrides().update( "id", UpdateAppOverrideOpts .builder() .build() ); } } - lang: python label: Python SDK source: | from pipedream import Pipedream client = Pipedream( project_id="YOUR_PROJECT_ID", client_id="YOUR_CLIENT_ID", client_secret="YOUR_CLIENT_SECRET", ) client.app_overrides.update( id="id", ) - lang: typescript label: TypeScript SDK source: | import { PipedreamClient } from "@pipedream/sdk"; const client = new PipedreamClient({ clientId: "YOUR_CLIENT_ID", clientSecret: "YOUR_CLIENT_SECRET", projectEnvironment: "YOUR_PROJECT_ENVIRONMENT", projectId: "YOUR_PROJECT_ID" }); await client.appOverrides.update("id"); components: schemas: UpdateAppOverrideOpts: type: object properties: name: type: string description: Name of the override, unique per owner oauth_app_id: type: string nullable: true description: Hash ID of the custom OAuth client to use. Pass null to clear it. cfmap: type: object additionalProperties: true description: >- Pre-defined custom field values, keyed by the app's custom field names. Sensitive (password-type) fields are rejected. AppOverride: type: object description: >- A named set of pre-defined custom field values for an app, owned by the workspace or a project. For OAuth apps it can select the custom OAuth client to use. required: - id - name - app - cfmap - owner_id properties: id: type: string pattern: ^ao_[0-9A-Za-z]+$ description: Hash ID for the app override name: type: string description: Name of the override, unique per owner app: $ref: '#/components/schemas/App' oauth_app_id: type: string nullable: true pattern: ^oa_[0-9A-Za-z]+$ description: Hash ID of the custom OAuth client the override selects, if any cfmap: type: object additionalProperties: true description: >- Pre-defined custom field values, keyed by the app's custom field names. Sensitive (password-type) fields cannot be pre-defined. owner_id: type: string description: >- Hash ID of the owner: the workspace (o_...) or the project (proj_...) created_at: type: string format: date-time updated_at: type: string format: date-time App: type: object description: Response object for a Pipedream app's metadata required: - name_slug - name - img_src - custom_fields_json - categories - featured_weight - scope_profiles properties: id: type: string description: ID of the app. Only applies for OAuth apps. nullable: true name_slug: type: string description: >- The name slug of the target app (see https://pipedream.com/docs/connect/quickstart#find-your-apps-name-slug) name: type: string description: The human-readable name of the app auth_type: $ref: '#/components/schemas/AppAuthType' description: type: string description: A short description of the app nullable: true img_src: type: string description: The URL to the app's logo custom_fields_json: type: string description: A JSON string representing the custom fields for the app nullable: true categories: type: array items: type: string description: Categories associated with the app featured_weight: type: number description: >- A rough directional ordering of app popularity, subject to changes by Pipedream scope_profiles: type: array description: >- Named subsets of the app's OAuth scopes that may be requested when users connect their accounts (via the `oauth_scope_profile` parameter). Empty for apps that don't define any. items: type: object required: - name - scopes properties: name: type: string enum: - read_only - read_write - admin description: >- The profile name. Pass this back as `oauth_scope_profile` when starting the OAuth flow for this app. scopes: type: array items: type: string description: >- The actual OAuth scopes of the upstream API that the user will be asked to authorize when this profile is selected. AppAuthType: type: string enum: - keys - oauth - none description: The authentication type used by the app nullable: true securitySchemes: OAuth2: description: >- A short-lived OAuth access token for server-side requests. Generate one via the Generate OAuth Token flow or automatically when initializing the SDK client. type: oauth2 flows: clientCredentials: tokenUrl: https://api.pipedream.com/v1/oauth/token scopes: '*': Full access to every OAuth-protected endpoint. connect:*: >- Full access to all Connect API endpoints (components, projects, triggers, accounts, etc.). connect:actions:*: Full access to Connect actions. connect:triggers:*: Full access to Connect triggers. connect:accounts:read: List and fetch Connect accounts for an external user. connect:accounts:write: Create or remove Connect accounts. connect:deployed_triggers:read: >- Read deployed triggers and related data like events, pipelines and webhooks. connect:deployed_triggers:write: Modify or delete deployed triggers. connect:users:read: List and fetch external users connect:users:write: Delete external users. connect:projects:read: List and fetch projects owned by the workspace. connect:projects:write: Create, update, or delete projects owned by the workspace. connect:oauth_apps:read: List and fetch custom OAuth clients. connect:oauth_apps:write: Create, update, or delete custom OAuth clients. connect:app_overrides:read: List and fetch app overrides. connect:app_overrides:write: Create, update, or delete app overrides. connect:usage:read: List Connect usage records for a time window. connect:tokens:create: Create Connect session tokens. connect:proxy: Invoke the Connect proxy. connect:workflow:invoke: Invoke Connect workflows on behalf of a user. ````