Skip to main content
cURL
curl --request POST \
 --url https://api.pipedream.com/v1/connect/{project_id}/actions/configure \
 --header 'Authorization: Bearer <token>' \
 --header 'Content-Type: application/json' \
 --header 'x-pd-environment: <x-pd-environment>' \
 --data '
{
 "id": "<string>",
 "external_user_id": "<string>",
 "prop_name": "<string>",
 "version": "1.2.3",
 "blocking": true,
 "configured_props": {},
 "dynamic_props_id": "<string>",
 "page": 123,
 "prev_context": {},
 "query": "<string>"
}
'
{
 "options": [
 {
 "label": "<string>",
 "value": "<string>"
 }
 ],
 "string_options": [
 "<string>"
 ],
 "observations": [
 {
 "k": "<string>",
 "ts": 123,
 "err": {
 "name": "<string>",
 "message": "<string>",
 "stack": "<string>"
 },
 "msg": "<string>"
 }
 ],
 "context": {},
 "errors": [
 "<string>"
 ]
}
POST
/
v1
/
connect
/
{project_id}
/
actions
/
configure
cURL
curl --request POST \
 --url https://api.pipedream.com/v1/connect/{project_id}/actions/configure \
 --header 'Authorization: Bearer <token>' \
 --header 'Content-Type: application/json' \
 --header 'x-pd-environment: <x-pd-environment>' \
 --data '
{
 "id": "<string>",
 "external_user_id": "<string>",
 "prop_name": "<string>",
 "version": "1.2.3",
 "blocking": true,
 "configured_props": {},
 "dynamic_props_id": "<string>",
 "page": 123,
 "prev_context": {},
 "query": "<string>"
}
'
{
 "options": [
 {
 "label": "<string>",
 "value": "<string>"
 }
 ],
 "string_options": [
 "<string>"
 ],
 "observations": [
 {
 "k": "<string>",
 "ts": 123,
 "err": {
 "name": "<string>",
 "message": "<string>",
 "stack": "<string>"
 },
 "msg": "<string>"
 }
 ],
 "context": {},
 "errors": [
 "<string>"
 ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

x-pd-environment
enum<string>
required

The environment in which the server client is running

Available options:
development,
production

Path Parameters

project_id
string
required

The project ID, which starts with proj_.

Body

application/json

Request options for configuring a component's prop

id
string
required

The component ID

external_user_id
string
required

The external user ID

prop_name
string
required

The name of the prop to configure

version
string | null

Optional component version (in SemVer format, for example '1.0.0'), defaults to latest

Example:

"1.2.3"

blocking
boolean

Whether this operation should block until completion

configured_props
object

The configured properties of the component

dynamic_props_id
string

The ID for dynamic props

page
number

Page number for paginated results

prev_context
object

Previous context for pagination

query
string

Search query for filtering options

Response

action configuration started

Response received after configuring a component's prop

options
object[] | null

Available options (with labels) for the configured prop

A configuration option for a component's prop

string_options
string[] | null

Available options for the configured prop

observations
object[] | null
context
object

New context after configuring the prop

errors
string[]

Any errors that occurred during configuration

Was this page helpful?

⌘I

AltStyle によって変換されたページ (->オリジナル) /