Pages – Sarbacane – Documentation API

List yours landings pages

Allows you to retrieve all your landings pages

HTTP request

GET

GET https://api.sarbacane.com/v1/landings

Header parameters

Parameter	Description	Required
accountId	Accound Id	true
apiKey	API key	true

URL parameters

Parameter	Description	Required
offset	Start position	false
limit	Maximum number of returned elements - Max: 1 000	false

Errors

HTML Code	Error message	Description
401	NEED_ACCOUNT_ID	No account ID is specified in the request
401	NEED_API_KEY	No API key is specified in the request
401	API_KEY_UNAUTHORIZED	Invalid API key
404	SERVICE_*_UNREACHABLE	The requested service is unavailable
500	INTERNAL_SERVER_ERROR	Internal error, please contact support

HTTP Authentication

curl -X GET "https://api.sarbacane.com/v1/landings"
  -u "YOUR_ACCOUNTID:YOUR_API_KEY"

HTTP Headers Authentication

curl -X GET "https://api.sarbacane.com/v1/landings"
  -H "accountId: YOUR_ACCOUNTID"
  -H "apiKey: YOUR_API_KEY"

HTTP success response code

HTTP/2 200

Response body

[
    {
        "id": "md1166aAQXOIdsDLcBzyQA",
        "name": "Name",
        "createdAt": "2019-01-01T00:00:00Z",
        "updatedAt": "2019-01-01T00:00:00Z",
    }
]

Details of a landing page

Used to retrieve the details of a landing page

HTTP request

GET

GET https://api.sarbacane.com/v1/landings/{landingId}

Header parameters

Parameter	Description	Required
accountId	Accound Id	true
apiKey	API key	true

URL parameters

Parameter	Description	Required
landingId	Id of the landing page	true

Errors

HTML Code	Error message	Description
401	NEED_ACCOUNT_ID	No account ID is specified in the request
401	NEED_API_KEY	No API key is specified in the request
401	API_KEY_UNAUTHORIZED	Invalid API key
404	SERVICE_*_UNREACHABLE	The requested service is unavailable
500	INTERNAL_SERVER_ERROR	Internal error, please contact support

HTTP Authentication

curl -X GET "https://api.sarbacane.com/v1/landings/{landingId}"
  -u "YOUR_ACCOUNTID:YOUR_API_KEY"

HTTP Headers Authentication

curl -X GET "https://api.sarbacane.com/v1/landings/{landingId}"
  -H "accountId: YOUR_ACCOUNTID"
  -H "apiKey: YOUR_API_KEY"

HTTP success response code

HTTP/2 200

Response body

{
    "id": "md1166aAQXOIdsDLcBzyQA",
    "name": "Name",
    "createdAt": "2019-01-01T00:00:00Z",
    "updatedAt": "2019-01-01T00:00:00Z",
}

Change the name of a landing page

Allows you to change the name of a landing page

HTTP request

PUT

PUT https://api.sarbacane.com/v1/landings/{landingId}/name

Header parameters

Parameter	Description	Required
accountId	Accound Id	true
apiKey	API key	true

Body Parameters

Parameter	Description	Required
name	New landing page name	true

Errors

HTML Code	Error message	Description
401	NEED_ACCOUNT_ID	No account ID is specified in the request
401	NEED_API_KEY	No API key is specified in the request
401	API_KEY_UNAUTHORIZED	Invalid API key
404	SERVICE_*_UNREACHABLE	The requested service is unavailable
500	FAILED TO ACQUIRE LOCK	Item already in use by another ressource
500	INTERNAL_SERVER_ERROR	Internal error, please contact support

HTTP Authentication

curl -X PUT "https://api.sarbacane.com/v1/landings/{landingId}/name"
  -u "YOUR_ACCOUNTID:YOUR_API_KEY"
  -d '{"name": ["Name 1"]}'

HTTP Headers Authentication

curl -X PUT "https://api.sarbacane.com/v1/landings/{landingId}/name"
  -H "accountId: YOUR_ACCOUNTID"
  -H "apiKey: YOUR_API_KEY"
  -d '{"name": ["Name 1"]}'

HTTP success response code

HTTP/2 200

List the teams of a landing page

Used to retrieve the teams associated with a landing page

HTTP request

GET

GET https://api.sarbacane.com/v1/landings/{landingId}/teams

Header parameters

Parameter	Description	Required
accountId	Accound Id	true
apiKey	API key	true

Errors

HTML Code	Error message	Description
401	NEED_ACCOUNT_ID	No account ID is specified in the request
401	NEED_API_KEY	No API key is specified in the request
401	API_KEY_UNAUTHORIZED	Invalid API key
404	SERVICE_*_UNREACHABLE	The requested service is unavailable
500	FAILED TO ACQUIRE LOCK	Item already in use by another ressource
500	INTERNAL_SERVER_ERROR	Internal error, please contact support

HTTP Authentication

curl -X PUT "https://api.sarbacane.com/v1/landings/{landingId}/teams"
  -u "YOUR_ACCOUNTID:YOUR_API_KEY"
  -d '{"name": ["Name 1"]}'

HTTP Headers Authentication

curl -X GET "https://api.sarbacane.com/v1/landings/{landingId}/teams"
  -H "accountId: YOUR_ACCOUNTID"
  -H "apiKey: YOUR_API_KEY"

HTTP success response code

HTTP/2 200

Response body

{
    "teams": [
      "9cee994b1836fe00018126b1",
      "9cee994b1836fe00018126b2"
    ]
}

Edit landing page teams

Allows you to modify the teams associated with a landing page

HTTP request

PUT

PUT https://api.sarbacane.com/v1/landings/{landingId}/teams

Header parameters

Parameter	Description	Required
accountId	Accound Id	true
apiKey	API key	true

Body Parameters

Parameter	Description	Required
teams	Array containing team ids to link with the landing page	true

Errors

HTML Code	Error message	Description
401	NEED_ACCOUNT_ID	No account ID is specified in the request
401	NEED_API_KEY	No API key is specified in the request
401	API_KEY_UNAUTHORIZED	Invalid API key
404	SERVICE_*_UNREACHABLE	The requested service is unavailable
500	INTERNAL_SERVER_ERROR	Internal error, please contact support
500	FAILED TO ACQUIRE LOCK	Item already in use by another ressource

HTTP Authentication

curl -X PUT "https://api.sarbacane.com/v1/landings/{landingId}/teams"
  -u "YOUR_ACCOUNTID:YOUR_API_KEY"
  -d '{"teams": ["9cee994b1836fe00018126b1", "9cee994b1836fe00018126b2"]}'

HTTP Headers Authentication

curl -X PUT "https://api.sarbacane.com/v1/landings/{landingId}/teams"
  -H "accountId: YOUR_ACCOUNTID"
  -H "apiKey: YOUR_API_KEY"
  -d '{"teams": ["9cee994b1836fe00018126b1", "9cee994b1836fe00018126b2"]}'

HTTP success response code

HTTP/2 200