useGrant
Clients

Create client

Create a new client within a specified provider.

POST
/v1/providers/{providerId}/clients

Authorization

AuthorizationBearer <token>

In: header

Request Body

application/jsonRequired
namestring

Name of the client.

audiencestring

Audience of the client.

Path Parameters

providerIdstring

Unique identifier for a provider.

Format"uuid"

Response Body

Client created successfully.

TypeScript Definitions

Use the response body type in TypeScript.

idstring

Unique identifier for a client.

Format"uuid"
namestring

Name of the client.

audiencestring

Audience of the client.

Invalid request parameters.

TypeScript Definitions

Use the response body type in TypeScript.

codestring
messagestring

Missing or invalid or expired auth token.

TypeScript Definitions

Use the response body type in TypeScript.

codestring
messagestring

Resource not found.

TypeScript Definitions

Use the response body type in TypeScript.

codestring
messagestring

Internal server error.

TypeScript Definitions

Use the response body type in TypeScript.

codestring
messagestring
curl -X POST "https://sdk.usegrant.dev/v1/providers/497f6eca-6276-4993-bfeb-53cbbbba6f08/clients" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Auth Client",
    "audience": "sts.amazonaws.com"
  }'
const body = JSON.stringify({
  "name": "Acme Auth Client",
  "audience": "sts.amazonaws.com"
})

fetch("https://sdk.usegrant.dev/v1/providers/497f6eca-6276-4993-bfeb-53cbbbba6f08/clients", {
  headers: {
    "Authorization": "Bearer <token>"
  },
  body
})
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
  "strings"
)

func main() {
  url := "https://sdk.usegrant.dev/v1/providers/497f6eca-6276-4993-bfeb-53cbbbba6f08/clients"
  body := strings.NewReader(`{
    "name": "Acme Auth Client",
    "audience": "sts.amazonaws.com"
  }`)
  req, _ := http.NewRequest("POST", url, body)
  req.Header.Add("Authorization", "Bearer <token>")
  req.Header.Add("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://sdk.usegrant.dev/v1/providers/497f6eca-6276-4993-bfeb-53cbbbba6f08/clients"
body = {
  "name": "Acme Auth Client",
  "audience": "sts.amazonaws.com"
}
response = requests.request("POST", url, json = body, headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
})

print(response.text)
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "Acme Auth Client",
  "audience": "sts.amazonaws.com"
}
{
  "code": "string",
  "message": "string"
}
{
  "code": "string",
  "message": "string"
}
{
  "code": "string",
  "message": "string"
}
{
  "code": "string",
  "message": "string"
}