ConnectSessions

The ConnectSession resource

Properties

Name
object
Type
string
Description
Type of object is always connectSession.
Name
id
Type
string
Description
Unique identifier for the Connect Session.
Example: csn_0SNlurA049MEWV1GWxpaE5D0t2D6
Name
callbackUrl
Type
nullable string
Description
The URL to which the user will be redirected after the Connect Session is completed.
Example: https://example.com
Name
intent
Type
object
Description
Name
url
Type
nullable string
Description
The session URL. Redirect your users to this URL to take them to Connect. It is only present on all create responses or in the update responses that associate the session with a user. It should not be stored, logged or exposed to anyone other than the user.
Example: https://connect.gigs.com/checkout/entry?session=csn_0SNlurA049MEWV1GWxpaE5D0t2D6&token=lzODbEyaUQjVRAmalD4pdaq5Nkn1Lw0qTL6Rdsh7PwLVES6N7ImWxnCYbJA99AXp
Name
user
Type
nullable string
Description
The unique identifier of the user that the session is for.
Example: usr_0SNlurA049MEWV4OpCwsNyC9Kn2d

Response

{
  "object": "connectSession",
  "id": "csn_0SNlurA049MEWV1GWxpaE5D0t2D6",
  "callbackUrl": "https://example.com",
  "intent": {
    "cancelSubscription": {
      "subscription": "sub_0SNlurA049MEWV2gSfSxi00xlPIi"
    },
    "changeSubscription": {
      "subscription": "sub_0SNlurA049MEWV2gSfSxi00xlPIi"
    },
    "checkoutAddon": {
      "subscription": "sub_0SNlurA049MEWV2gSfSxi00xlPIi"
    },
    "checkoutNewSubscription": {
      "device": "dev_0SNlurA049MEWV55CrA9qMvI2FVJ",
      "plan": "pln_0SNlurA049MEWV3V0q7gjQbM4EVo",
      "sim": "sim_0SNlurA049MEWV1BAAmWZULA4lf6",
      "imei": "492388841798923"
    },
    "completePorting": {
      "subscription": "sub_0SNlurA049MEWV2gSfSxi00xlPIi"
    },
    "confirmPayment": {
      "payment": "pay_0SNlurA049MEWV2HRA0slWFuS8DV"
    },
    "resumeSubscription": {
      "subscription": "sub_0SNlurA049MEWV2gSfSxi00xlPIi"
    },
    "type": "cancelSubscription",
    "viewEsimInstallation": {
      "subscription": "sub_0SNlurA049MEWV2gSfSxi00xlPIi"
    },
    "viewSubscription": {
      "subscription": "sub_0SNlurA049MEWV2gSfSxi00xlPIi"
    }
  },
  "url": "https://connect.gigs.com/checkout/entry?session=csn_0SNlurA049MEWV1GWxpaE5D0t2D6&token=lzODbEyaUQjVRAmalD4pdaq5Nkn1Lw0qTL6Rdsh7PwLVES6N7ImWxnCYbJA99AXp",
  "user": "usr_0SNlurA049MEWV4OpCwsNyC9Kn2d"
}

GET/projects/{project}/connectSessions/{connectSessionId}

Retrieve a connect session

Retrieves the details of an existing Connect Session.

Preview

This endpoint is currently in preview and might change in the future.

We’re excited to hear your feedback and ideas. Please send an email to support@gigs.com to share your thoughts.

Path Parameters

Name
project
Type
string
required
Description
The unique identifier for the project.
Example: gigs
Name
connectSessionId
Type
string
required
Description

Response Schemas

Name
object
Type
string
required
Description
Type of object is always connectSession.
Name
id
Type
string
required
Description
Unique identifier for the Connect Session.
Example: csn_0SNlurA049MEWV1GWxpaE5D0t2D6
Name
callbackUrl
Type
nullable string
required
Description
The URL to which the user will be redirected after the Connect Session is completed.
Example: https://example.com
Name
intent
Type
object
required
Description
Name
url
Type
nullable string
required
Description
The session URL. Redirect your users to this URL to take them to Connect. It is only present on all create responses or in the update responses that associate the session with a user. It should not be stored, logged or exposed to anyone other than the user.
Example: https://connect.gigs.com/checkout/entry?session=csn_0SNlurA049MEWV1GWxpaE5D0t2D6&token=lzODbEyaUQjVRAmalD4pdaq5Nkn1Lw0qTL6Rdsh7PwLVES6N7ImWxnCYbJA99AXp
Name
user
Type
nullable string
required
Description
The unique identifier of the user that the session is for.
Example: usr_0SNlurA049MEWV4OpCwsNyC9Kn2d

Request

GET

/projects/{project}/connectSessions/{connectSessionId}

curl https://api.gigs.com/projects/{project}/connectSessions/{connectSessionId} \
-X GET \
-H "Content-type: application/json" \
-H "Authorization: Bearer {token}" \
-H "Accept: application/json"

Response

{
  "object": "connectSession",
  "id": "csn_0SNlurA049MEWV1GWxpaE5D0t2D6",
  "callbackUrl": "https://example.com",
  "intent": {
    "cancelSubscription": {
      "subscription": "sub_0SNlurA049MEWV2gSfSxi00xlPIi"
    },
    "type": "cancelSubscription",
    "subscription": null
  },
  "url": "https://connect.gigs.com/checkout/entry?session=csn_0SNlurA049MEWV1GWxpaE5D0t2D6&token=lzODbEyaUQjVRAmalD4pdaq5Nkn1Lw0qTL6Rdsh7PwLVES6N7ImWxnCYbJA99AXp",
  "user": "usr_0SNlurA049MEWV4OpCwsNyC9Kn2d"
}

PATCH/projects/{project}/connectSessions/{connectSessionId}

Update a connect session

Updates the Connect Session with the given parameters.

The user or userDetails attributes can only be set when the session is not associated with a user yet.

Related guide: Connect Sessions

Preview

This endpoint is currently in preview and might change in the future.

We’re excited to hear your feedback and ideas. Please send an email to support@gigs.com to share your thoughts.

Body

Name
callbackUrl
Type
nullable string
Description
The URL to which the user will be redirected after the Connect Session is completed.
Example: https://example.com
Name
user
Type
nullable string
Description
The unique identifier of the user.
Example: usr_0SNlurA049MEWV4OpCwsNyC9Kn2d
Name
userDetails
Type
object
Description

Path Parameters

Name
project
Type
string
required
Description
The unique identifier for the project.
Example: gigs
Name
connectSessionId
Type
string
required
Description

Response Schemas

Name
object
Type
string
required
Description
Type of object is always connectSession.
Name
id
Type
string
required
Description
Unique identifier for the Connect Session.
Example: csn_0SNlurA049MEWV1GWxpaE5D0t2D6
Name
callbackUrl
Type
nullable string
required
Description
The URL to which the user will be redirected after the Connect Session is completed.
Example: https://example.com
Name
intent
Type
object
required
Description
Name
url
Type
nullable string
required
Description
The session URL. Redirect your users to this URL to take them to Connect. It is only present on all create responses or in the update responses that associate the session with a user. It should not be stored, logged or exposed to anyone other than the user.
Example: https://connect.gigs.com/checkout/entry?session=csn_0SNlurA049MEWV1GWxpaE5D0t2D6&token=lzODbEyaUQjVRAmalD4pdaq5Nkn1Lw0qTL6Rdsh7PwLVES6N7ImWxnCYbJA99AXp
Name
user
Type
nullable string
required
Description
The unique identifier of the user that the session is for.
Example: usr_0SNlurA049MEWV4OpCwsNyC9Kn2d

Request

PATCH

/projects/{project}/connectSessions/{connectSessionId}

curl https://api.gigs.com/projects/{project}/connectSessions/{connectSessionId} \
-X PATCH \
-H "Content-type: application/json" \
-H "Authorization: Bearer {token}" \
-H "Accept: application/json" \
-d "{\"callbackUrl\":\"https://example.com\",\"user\":\"usr_0SNlurA049MEWV4OpCwsNyC9Kn2d\",\"userDetails\":{\"birthday\":\"2017-07-21\",\"email\":\"jerry@example.com\",\"fullName\":\"Jerry Seinfeld\",\"metadata\":{},\"preferredLocale\":\"en-US\"}}"

Response

{
  "object": "connectSession",
  "id": "csn_0SNlurA049MEWV1GWxpaE5D0t2D6",
  "callbackUrl": "https://example.com",
  "intent": {
    "cancelSubscription": {
      "subscription": "sub_0SNlurA049MEWV2gSfSxi00xlPIi"
    },
    "type": "cancelSubscription",
    "subscription": null
  },
  "url": "https://connect.gigs.com/checkout/entry?session=csn_0SNlurA049MEWV1GWxpaE5D0t2D6&token=lzODbEyaUQjVRAmalD4pdaq5Nkn1Lw0qTL6Rdsh7PwLVES6N7ImWxnCYbJA99AXp",
  "user": "usr_0SNlurA049MEWV4OpCwsNyC9Kn2d"
}

POST/projects/{project}/connectSessions

Create a connect session

Creates a new Connect Session for the given parameters.

Related guide: Connect Sessions

Preview

This endpoint is currently in preview and might change in the future.

We’re excited to hear your feedback and ideas. Please send an email to support@gigs.com to share your thoughts.

Body

Name
callbackUrl
Type
nullable string
Description
The URL to which the user will be redirected after the Connect Session is completed.
Example: https://example.com
Name
intent
Type
object
required
Description
Name
user
Type
nullable string
Description
The unique identifier of the user.
Example: usr_0SNlurA049MEWV4OpCwsNyC9Kn2d
Name
userDetails
Type
object
Description

Path Parameters

Name
project
Type
string
required
Description
The unique identifier for the project.
Example: gigs

Response Schemas

Name
object
Type
string
required
Description
Type of object is always connectSession.
Name
id
Type
string
required
Description
Unique identifier for the Connect Session.
Example: csn_0SNlurA049MEWV1GWxpaE5D0t2D6
Name
callbackUrl
Type
nullable string
required
Description
The URL to which the user will be redirected after the Connect Session is completed.
Example: https://example.com
Name
intent
Type
object
required
Description
Name
url
Type
nullable string
required
Description
The session URL. Redirect your users to this URL to take them to Connect. It is only present on all create responses or in the update responses that associate the session with a user. It should not be stored, logged or exposed to anyone other than the user.
Example: https://connect.gigs.com/checkout/entry?session=csn_0SNlurA049MEWV1GWxpaE5D0t2D6&token=lzODbEyaUQjVRAmalD4pdaq5Nkn1Lw0qTL6Rdsh7PwLVES6N7ImWxnCYbJA99AXp
Name
user
Type
nullable string
required
Description
The unique identifier of the user that the session is for.
Example: usr_0SNlurA049MEWV4OpCwsNyC9Kn2d

Request

POST

/projects/{project}/connectSessions

curl https://api.gigs.com/projects/{project}/connectSessions \
-X POST \
-H "Content-type: application/json" \
-H "Authorization: Bearer {token}" \
-H "Accept: application/json" \
-d "{\"callbackUrl\":\"https://example.com\",\"intent\":{\"type\":\"cancelSubscription\",\"cancelSubscription\":{\"subscription\":\"sub_0SNlurA049MEWV2gSfSxi00xlPIi\"},\"subscription\":null},\"user\":\"usr_0SNlurA049MEWV4OpCwsNyC9Kn2d\",\"userDetails\":{\"birthday\":\"2017-07-21\",\"email\":\"jerry@example.com\",\"fullName\":\"Jerry Seinfeld\",\"metadata\":{},\"preferredLocale\":\"en-US\"}}"

Response

{
  "object": "connectSession",
  "id": "csn_0SNlurA049MEWV1GWxpaE5D0t2D6",
  "callbackUrl": "https://example.com",
  "intent": {
    "cancelSubscription": {
      "subscription": "sub_0SNlurA049MEWV2gSfSxi00xlPIi"
    },
    "type": "cancelSubscription",
    "subscription": null
  },
  "url": "https://connect.gigs.com/checkout/entry?session=csn_0SNlurA049MEWV1GWxpaE5D0t2D6&token=lzODbEyaUQjVRAmalD4pdaq5Nkn1Lw0qTL6Rdsh7PwLVES6N7ImWxnCYbJA99AXp",
  "user": "usr_0SNlurA049MEWV4OpCwsNyC9Kn2d"
}