Skip to main content
Create a new builder
curl --request POST \
  --url https://sapi.withsutro.com/builders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-sutro-api-client: <api-key>' \
  --data '
{
  "sid": "<string>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sid": "<string>",
  "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Documentation Index

Fetch the complete documentation index at: https://docs.withsutro.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Builder authentication and authorization

​
x-sutro-api-client
string
header
required

A unique identifier for the API Client making a request

Body

application/json
​
sid
string
required

A Builder's SID is the security ID associated with a Customer User. This SID comes from the Customer and should uniquely identify a User in their Authentication system. This SID is what should be in the sub claim of any JWTs used to authenticate requests to the Sutro API from the Customer API.

Response

The newly created builder

A builder is an end user or client who builds and runs apps that integrate with Sutro.

​
id
string<uuid>
required

Unique identifier for the builder

​
sid
string
required

Security ID that uniquely identifies this builder in the customer's authentication system. Maps to the sub claim in JWTs.

​
customerId
string<uuid>
required

The ID of the customer organization this builder belongs to