> ## 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. # List OAuth clients > List the custom OAuth clients available to the project, including the parent workspace's ## OpenAPI ````yaml get /v1/connect/{project_id}/oauth_apps 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}/oauth_apps: 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 get: summary: List OAuth clients description: >- List the custom OAuth clients available to the project, including the parent workspace's operationId: listOauthApps parameters: - name: after in: query required: false description: The cursor to start from for pagination schema: type: string - name: before in: query required: false description: The cursor to end before for pagination schema: type: string - name: limit in: query required: false description: The maximum number of results to return schema: type: integer - name: app in: query required: false description: Only return OAuth clients for this app (ID or name slug) schema: type: string - name: q in: query required: false description: A search query to filter the OAuth clients by name or description schema: type: string responses: '200': description: OAuth clients listed content: application/json: schema: $ref: '#/components/schemas/ListOauthAppsResponse' '404': description: missing OAuth token '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.oauthapps.requests.OauthAppsListRequest; public class Example { public static void main(String[] args) { BaseClient client = BaseClient.withCredentials("", "") .projectId("YOUR_PROJECT_ID") .build() ; client.oauthApps().list( OauthAppsListRequest .builder() .after("after") .before("before") .limit(1) .app("app") .q("q") .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", ) response = client.oauth_apps.list( after="after", before="before", limit=1, app="app", q="q", ) for item in response: yield item # alternatively, you can paginate page-by-page for page in response.iter_pages(): yield page - 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" }); const pageableResponse = await client.oauthApps.list({ after: "after", before: "before", limit: 1, app: "app", q: "q" }); for await (const item of pageableResponse) { console.log(item); } // Or you can manually iterate page-by-page let page = await client.oauthApps.list({ after: "after", before: "before", limit: 1, app: "app", q: "q" }); while (page.hasNextPage()) { page = page.getNextPage(); } // You can also access the underlying response const response = page.response; components: schemas: ListOauthAppsResponse: type: object description: Response received when listing custom OAuth clients required: - data - page_info properties: data: type: array items: $ref: '#/components/schemas/OauthApp' page_info: $ref: '#/components/schemas/PageInfo' OauthApp: description: >- A custom OAuth client (bring your own app), presented as its app's metadata merged with the client's own fields. `name` and `description` fall back to the app's when the client doesn't set them. The client secret is write-only and never returned. allOf: - $ref: '#/components/schemas/App' - type: object required: - id - client_id - owner_id properties: id: type: string pattern: ^oa_[0-9A-Za-z]+$ description: Hash ID for the OAuth client client_id: type: string description: The OAuth client ID registered with the upstream provider scopes: type: array items: type: string description: OAuth scopes requested when users connect through this client additional_scopes: type: array items: type: string nullable: true description: Extra OAuth scopes users may grant on top of the base scopes redirect_uri: type: string description: The redirect URI to register with the upstream OAuth provider 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 PageInfo: type: object properties: count: type: integer description: Number of items returned example: 10 total_count: type: integer description: Total number of items example: 120 start_cursor: type: string description: Used to fetch the previous page of items nullable: true end_cursor: type: string description: Used to fetch the next page of items nullable: true 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. ````