Triggers

Download schema

Triggers enable to trigger your Functions using events from a message queue.

List all triggers

GET

https://api.scaleway.com

/functions/v1beta1/regions/{region}/triggers

List all triggers belonging to a specified Organization or Project.

List all triggers › path Parameters

region

string · enum · required

The region you want to target

Enum values:

fr-par

nl-ams

pl-waw

List all triggers › query Parameters

page

integer · int32

Page number to return.

page_size

integer · uint32

Maximum number of triggers to return per page.

order_by

string · enum

Order in which to return results.

Enum values:

created_at_asc

created_at_desc

Default: created_at_asc

List all triggers › Responses

200

scaleway.functions.v1beta1.ListTriggersResponse

total_count

integer · uint32

Total count of existing triggers (matching any filters specified).

scaleway.functions.v1beta1.Trigger[]

Triggers on this page.

GET/functions/v1beta1/regions/{region}/triggers

curl -X GET \
  -H "X-Auth-Token: $SCW_SECRET_KEY" \
  "https://api.scaleway.com/functions/v1beta1/regions/{region}/triggers"

Example Responses

{
  "total_count": 0,
  "triggers": [
    {
      "id": "id",
      "name": "name",
      "description": "description",
      "function_id": "function_id",
      "input_type": "unknown_input_type",
      "status": "unknown_status",
      "error_message": "error_message",
      "scw_sqs_config": {
        "queue": "queue",
        "mnq_project_id": "mnq_project_id",
        "mnq_region": "mnq_region",
        "mnq_credential_id": "mnq_credential_id"
      },
      "scw_nats_config": {
        "subject": "subject",
        "mnq_nats_account_id": "mnq_nats_account_id",
        "mnq_project_id": "mnq_project_id",
        "mnq_region": "mnq_region",
        "mnq_credential_id": "mnq_credential_id"
      }
    }
  ]
}

json

application/json

Create a trigger

POST

https://api.scaleway.com

/functions/v1beta1/regions/{region}/triggers

Create a new trigger for a specified function.

Create a trigger › path Parameters

region

string · enum · required

The region you want to target

Enum values:

fr-par

nl-ams

pl-waw

Create a trigger › Request Body

name

string · required

Name of the trigger.

function_id

string · required

ID of the function to trigger.

description

string

Description of the trigger.

object

Configuration for a Scaleway Messaging and Queuing SQS queue.

object

Configuration for a Scaleway Messaging and Queuing NATS subject.

Create a trigger › Responses

200

scaleway.functions.v1beta1.Trigger

id

string

ID of the trigger.

name

string

Name of the trigger.

description

string

Description of the trigger.

function_id

string

ID of the function to trigger.

input_type

string · enum

Type of the input.

Enum values:

unknown_input_type

sqs

scw_sqs

nats

scw_nats

Default: unknown_input_type

status

string · enum

Status of the trigger.

Enum values:

unknown_status

ready

deleting

error

creating

pending

Default: unknown_status

error_message

string

Error message of the trigger.

object

Configuration for a Scaleway Messaging and Queuing SQS queue.

object

Configuration for a Scaleway Messaging and Queuing NATS subject.

POST/functions/v1beta1/regions/{region}/triggers

curl -X POST \
  -H "X-Auth-Token: $SCW_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"function_id":"string","name":"string"}' \
  "https://api.scaleway.com/functions/v1beta1/regions/{region}/triggers"

Example Request Body

{
  "name": "name",
  "function_id": "function_id",
  "description": "description",
  "scw_sqs_config": {
    "queue": "queue",
    "mnq_project_id": "mnq_project_id",
    "mnq_region": "mnq_region"
  },
  "scw_nats_config": {
    "subject": "subject",
    "mnq_nats_account_id": "mnq_nats_account_id",
    "mnq_project_id": "mnq_project_id",
    "mnq_region": "mnq_region"
  }
}

json

Example Responses

{
  "id": "id",
  "name": "name",
  "description": "description",
  "function_id": "function_id",
  "input_type": "unknown_input_type",
  "status": "unknown_status",
  "error_message": "error_message",
  "scw_sqs_config": {
    "queue": "queue",
    "mnq_project_id": "mnq_project_id",
    "mnq_region": "mnq_region",
    "mnq_credential_id": "mnq_credential_id"
  },
  "scw_nats_config": {
    "subject": "subject",
    "mnq_nats_account_id": "mnq_nats_account_id",
    "mnq_project_id": "mnq_project_id",
    "mnq_region": "mnq_region",
    "mnq_credential_id": "mnq_credential_id"
  }
}

json

application/json

Get a trigger

GET

https://api.scaleway.com

/functions/v1beta1/regions/{region}/triggers/{trigger_id}

Get a trigger with a specified ID.

Get a trigger › path Parameters

region

string · enum · required

The region you want to target

Enum values:

fr-par

nl-ams

pl-waw

trigger_id

string · required

ID of the trigger to get.

Get a trigger › Responses

200

scaleway.functions.v1beta1.Trigger

id

string

ID of the trigger.

name

string

Name of the trigger.

description

string

Description of the trigger.

function_id

string

ID of the function to trigger.

input_type

string · enum

Type of the input.

Enum values:

unknown_input_type

sqs

scw_sqs

nats

scw_nats

Default: unknown_input_type

status

string · enum

Status of the trigger.

Enum values:

unknown_status

ready

deleting

error

creating

pending

Default: unknown_status

error_message

string

Error message of the trigger.

object

Configuration for a Scaleway Messaging and Queuing SQS queue.

object

Configuration for a Scaleway Messaging and Queuing NATS subject.

GET/functions/v1beta1/regions/{region}/triggers/{trigger_id}

curl -X GET \
  -H "X-Auth-Token: $SCW_SECRET_KEY" \
  "https://api.scaleway.com/functions/v1beta1/regions/{region}/triggers/{trigger_id}"

Example Responses

{
  "id": "id",
  "name": "name",
  "description": "description",
  "function_id": "function_id",
  "input_type": "unknown_input_type",
  "status": "unknown_status",
  "error_message": "error_message",
  "scw_sqs_config": {
    "queue": "queue",
    "mnq_project_id": "mnq_project_id",
    "mnq_region": "mnq_region",
    "mnq_credential_id": "mnq_credential_id"
  },
  "scw_nats_config": {
    "subject": "subject",
    "mnq_nats_account_id": "mnq_nats_account_id",
    "mnq_project_id": "mnq_project_id",
    "mnq_region": "mnq_region",
    "mnq_credential_id": "mnq_credential_id"
  }
}

json

application/json

Delete a trigger

DELETE

https://api.scaleway.com

/functions/v1beta1/regions/{region}/triggers/{trigger_id}

Delete a trigger with a specified ID.

Delete a trigger › path Parameters

region

string · enum · required

The region you want to target

Enum values:

fr-par

nl-ams

pl-waw

trigger_id

string · required

ID of the trigger to delete.

Delete a trigger › Responses

200

scaleway.functions.v1beta1.Trigger

id

string

ID of the trigger.

name

string

Name of the trigger.

description

string

Description of the trigger.

function_id

string

ID of the function to trigger.

input_type

string · enum

Type of the input.

Enum values:

unknown_input_type

sqs

scw_sqs

nats

scw_nats

Default: unknown_input_type

status

string · enum

Status of the trigger.

Enum values:

unknown_status

ready

deleting

error

creating

pending

Default: unknown_status

error_message

string

Error message of the trigger.

object

Configuration for a Scaleway Messaging and Queuing SQS queue.

object

Configuration for a Scaleway Messaging and Queuing NATS subject.

DELETE/functions/v1beta1/regions/{region}/triggers/{trigger_id}

curl -X DELETE \
  -H "X-Auth-Token: $SCW_SECRET_KEY" \
  "https://api.scaleway.com/functions/v1beta1/regions/{region}/triggers/{trigger_id}"

Example Responses

{
  "id": "id",
  "name": "name",
  "description": "description",
  "function_id": "function_id",
  "input_type": "unknown_input_type",
  "status": "unknown_status",
  "error_message": "error_message",
  "scw_sqs_config": {
    "queue": "queue",
    "mnq_project_id": "mnq_project_id",
    "mnq_region": "mnq_region",
    "mnq_credential_id": "mnq_credential_id"
  },
  "scw_nats_config": {
    "subject": "subject",
    "mnq_nats_account_id": "mnq_nats_account_id",
    "mnq_project_id": "mnq_project_id",
    "mnq_region": "mnq_region",
    "mnq_credential_id": "mnq_credential_id"
  }
}

json

application/json

Update a trigger

PATCH

https://api.scaleway.com

/functions/v1beta1/regions/{region}/triggers/{trigger_id}

Update a trigger with a specified ID.

Update a trigger › path Parameters

region

string · enum · required

The region you want to target

Enum values:

fr-par

nl-ams

pl-waw

trigger_id

string · required

ID of the trigger to update.

Update a trigger › Request Body

name

string

Name of the trigger.

description

string

Description of the trigger.

Update a trigger › Responses

200

scaleway.functions.v1beta1.Trigger

id

string

ID of the trigger.

name

string

Name of the trigger.

description

string

Description of the trigger.

function_id

string

ID of the function to trigger.

input_type

string · enum

Type of the input.

Enum values:

unknown_input_type

sqs

scw_sqs

nats

scw_nats

Default: unknown_input_type

status

string · enum

Status of the trigger.

Enum values:

unknown_status

ready

deleting

error

creating

pending

Default: unknown_status

error_message

string

Error message of the trigger.

object

Configuration for a Scaleway Messaging and Queuing SQS queue.

object

Configuration for a Scaleway Messaging and Queuing NATS subject.

PATCH/functions/v1beta1/regions/{region}/triggers/{trigger_id}

curl -X PATCH \
  -H "X-Auth-Token: $SCW_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  "https://api.scaleway.com/functions/v1beta1/regions/{region}/triggers/{trigger_id}"

Example Request Body

{
  "name": "name",
  "description": "description"
}

json

Example Responses

{
  "id": "id",
  "name": "name",
  "description": "description",
  "function_id": "function_id",
  "input_type": "unknown_input_type",
  "status": "unknown_status",
  "error_message": "error_message",
  "scw_sqs_config": {
    "queue": "queue",
    "mnq_project_id": "mnq_project_id",
    "mnq_region": "mnq_region",
    "mnq_credential_id": "mnq_credential_id"
  },
  "scw_nats_config": {
    "subject": "subject",
    "mnq_nats_account_id": "mnq_nats_account_id",
    "mnq_project_id": "mnq_project_id",
    "mnq_region": "mnq_region",
    "mnq_credential_id": "mnq_credential_id"
  }
}

json

application/json

Tokens

List all triggers

GET

https://api.scaleway.com

/functions/v1beta1/regions/{region}/triggers

List all triggers belonging to a specified Organization or Project.

List all triggers › path Parameters

region

string · enum · required

The region you want to target

Enum values:

fr-par

nl-ams

pl-waw

List all triggers › query Parameters

page

integer · int32

Page number to return.

page_size

integer · uint32

Maximum number of triggers to return per page.

order_by

string · enum

Order in which to return results.

Enum values:

created_at_asc

created_at_desc

Default: created_at_asc

List all triggers › Responses

200

scaleway.functions.v1beta1.ListTriggersResponse

total_count

integer · uint32

Total count of existing triggers (matching any filters specified).

scaleway.functions.v1beta1.Trigger[]

Triggers on this page.

Create a trigger

POST

https://api.scaleway.com

/functions/v1beta1/regions/{region}/triggers

Create a new trigger for a specified function.

Create a trigger › path Parameters

region

string · enum · required

The region you want to target

Enum values:

fr-par

nl-ams

pl-waw

Create a trigger › Request Body

name

string · required

Name of the trigger.

function_id

string · required

ID of the function to trigger.

description

string

Description of the trigger.

object

Configuration for a Scaleway Messaging and Queuing SQS queue.

object

Configuration for a Scaleway Messaging and Queuing NATS subject.

Create a trigger › Responses

200

scaleway.functions.v1beta1.Trigger

id

string

ID of the trigger.

name

string

Name of the trigger.

description

string

Description of the trigger.

function_id

string

ID of the function to trigger.

input_type

string · enum

Type of the input.

Enum values:

unknown_input_type

sqs

scw_sqs

nats

scw_nats

Default: unknown_input_type

status

string · enum

Status of the trigger.

Enum values:

unknown_status

ready

deleting

error

creating

pending

Default: unknown_status

error_message

string

Error message of the trigger.

object

Configuration for a Scaleway Messaging and Queuing SQS queue.

object

Configuration for a Scaleway Messaging and Queuing NATS subject.

Get a trigger

GET

https://api.scaleway.com

/functions/v1beta1/regions/{region}/triggers/{trigger_id}

Get a trigger with a specified ID.

Get a trigger › path Parameters

region

string · enum · required

The region you want to target

Enum values:

fr-par

nl-ams

pl-waw

trigger_id

string · required

ID of the trigger to get.

Get a trigger › Responses

200

scaleway.functions.v1beta1.Trigger

id

string

ID of the trigger.

name

string

Name of the trigger.

description

string

Description of the trigger.

function_id

string

ID of the function to trigger.

input_type

string · enum

Type of the input.

Enum values:

unknown_input_type

sqs

scw_sqs

nats

scw_nats

Default: unknown_input_type

status

string · enum

Status of the trigger.

Enum values:

unknown_status

ready

deleting

error

creating

pending

Default: unknown_status

error_message

string

Error message of the trigger.

object

Configuration for a Scaleway Messaging and Queuing SQS queue.

object

Configuration for a Scaleway Messaging and Queuing NATS subject.

Delete a trigger

DELETE

https://api.scaleway.com

/functions/v1beta1/regions/{region}/triggers/{trigger_id}

Delete a trigger with a specified ID.

Delete a trigger › path Parameters

region

string · enum · required

The region you want to target

Enum values:

fr-par

nl-ams

pl-waw

trigger_id

string · required

ID of the trigger to delete.

Delete a trigger › Responses

200

scaleway.functions.v1beta1.Trigger

id

string

ID of the trigger.

name

string

Name of the trigger.

description

string

Description of the trigger.

function_id

string

ID of the function to trigger.

input_type

string · enum

Type of the input.

Enum values:

unknown_input_type

sqs

scw_sqs

nats

scw_nats

Default: unknown_input_type

status

string · enum

Status of the trigger.

Enum values:

unknown_status

ready

deleting

error

creating

pending

Default: unknown_status

error_message

string

Error message of the trigger.

object

Configuration for a Scaleway Messaging and Queuing SQS queue.

object

Configuration for a Scaleway Messaging and Queuing NATS subject.

Update a trigger

PATCH

https://api.scaleway.com

/functions/v1beta1/regions/{region}/triggers/{trigger_id}

Update a trigger with a specified ID.

Update a trigger › path Parameters

region

string · enum · required

The region you want to target

Enum values:

fr-par

nl-ams

pl-waw

trigger_id

string · required

ID of the trigger to update.

Update a trigger › Request Body

name

string

Name of the trigger.

description

string

Description of the trigger.

Update a trigger › Responses

200

scaleway.functions.v1beta1.Trigger

id

string

ID of the trigger.

name

string

Name of the trigger.

description

string

Description of the trigger.

function_id

string

ID of the function to trigger.

input_type

string · enum

Type of the input.

Enum values:

unknown_input_type

sqs

scw_sqs

nats

scw_nats

Default: unknown_input_type

status

string · enum

Status of the trigger.

Enum values:

unknown_status

ready

deleting

error

creating

pending

Default: unknown_status

error_message

string

Error message of the trigger.

object

Configuration for a Scaleway Messaging and Queuing SQS queue.

object

Configuration for a Scaleway Messaging and Queuing NATS subject.