Forms – Sarbacane – Documentation API

List yours forms

Allows you to retrieve all your forms

HTTP request

GET

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

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/forms"
  -u "YOUR_ACCOUNTID:YOUR_API_KEY"

HTTP Headers Authentication

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

HTTP success response code

HTTP/2 200

Response body

[
    {
        "id": "md1166aAQXOIdsDLcBzyQA",
        "name": "Name"
    }
]

Details of a form

Used to retrieve the details of a form

HTTP request

GET

GET https://api.sarbacane.com/v1/forms{formId}

Header parameters

Parameter	Description	Required
accountId	Accound Id	true
apiKey	API key	true

URL parameters

Parameter	Description	Required
formId	Id of the form	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/forms/{formId}"
  -u "YOUR_ACCOUNTID:YOUR_API_KEY"

HTTP Headers Authentication

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

HTTP success response code

HTTP/2 200

Response body

{
        "id": "md1166aAQXOIdsDLcBzyQA",
        "name": "Name"
    }

Change the name of a form

Lets you change the name of a form

HTTP request

PUT

PUT https://api.sarbacane.com/v1/forms{formId}/name

Header parameters

Parameter	Description	Required
accountId	Accound Id	true
apiKey	API key	true

Body Parameters

Parameter	Description	Required
name	New form 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	INTERNAL_SERVER_ERROR	Internal error, please contact support

HTTP Authentication

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

HTTP Headers Authentication

curl -X PUT "https://api.sarbacane.com/v1/forms/{formId}/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 form

Used to retrieve the teams associeted with a form

HTTP request

PUT

GET https://api.sarbacane.com/v1/forms{formId}/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	INTERNAL_SERVER_ERROR	Internal error, please contact support

HTTP Authentication

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

HTTP Headers Authentication

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

HTTP success response code

HTTP/2 200

Response body

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

Edit the teams of a form

Allows you to modify the teams associated with a form

HTTP request

PUT

PUT https://api.sarbacane.com/v1/forms{formId}/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 form	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/forms/{formId}/teams"
  -u "YOUR_ACCOUNTID:YOUR_API_KEY"
  -d '{"teams": ["9cee994b1836fe00018126b1", "9cee994b1836fe00018126b2"]}'

HTTP Headers Authentication

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

HTTP success response code

HTTP/2 200