Update Connected App - Stytch Docs

// PUT /v1/connected_apps/clients/{client_id}
const stytch = require('stytch');

const client = new stytch.B2BClient({
  project_id: '${projectId}',
  secret: '${secret}',
});

const params = {
  client_id: "m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885",
  client_name: "My Sample Client",
  client_description: "My sample client for testing out Connected Apps",
  redirect_urls: ["https://example.com/callback"],
  full_access_allowed: false,
};

client.ConnectedApp.Clients.Update(params)
  .then(resp => { console.log(resp) })
  .catch(err => { console.log(err) });

// PUT /v1/connected_apps/clients/{client_id}
package main

import (
	"context"
	"log"

	"github.com/stytchauth/stytch-go/v18/stytch/b2b/b2bstytchapi"
	"github.com/stytchauth/stytch-go/v18/stytch/consumer/connectedapps/clients"
)

func main() {
	client, err := b2bstytchapi.NewClient(
		"${projectId}",
		"${secret}",
	)
	if err != nil {
		log.Fatalf("error instantiating client: %v", err)
	}

	params := &clients.UpdateParams{
		ClientID:          "m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885",
		ClientName:        "My Sample Client",
		ClientDescription: "My sample client for testing out Connected Apps",
		RedirectURLs:      []string{"https://example.com/callback"},
		FullAccessAllowed: false,
	}

	resp, err := client.ConnectedApp.Clients.Update(context.Background(), params)
	if err != nil {
		log.Fatalf("error in method call: %v", err)
	}

	log.Println(resp)
}

// PUT /v1/connected_apps/clients/{client_id}
package com.example;

import com.stytch.java.b2b.StytchB2BClient;
import com.stytch.java.common.StytchResult;
import com.stytch.java.consumer.models.connectedappsclients.UpdateRequest;

public class Main {
    public static void main(String[] args) {
        StytchB2BClient.configure("${projectId}", "${secret}");

        UpdateRequest params = new UpdateRequest();
        params.setClientId("m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885");
        params.setClientName("My Sample Client");
        params.setClientDescription("My sample client for testing out Connected Apps");
        params.setRedirectURLs(new String("https://example.com/callback"));
        params.setFullAccessAllowed(false);

        Object result = StytchB2BClient.getConnectedApp().getClients().update(params);
        if (result instanceof StytchResult.Success) {
          System.out.println(((StytchResult.Success) result).getValue());
        } else {
          System.out.println(((StytchResult.Error) result).getException());
        }
    }
}

// PUT /v1/connected_apps/clients/{client_id}
package com.example

import com.stytch.java.b2b.StytchB2BClient
import com.stytch.java.consumer.models.connectedappsclients.UpdateRequest

fun main() {
    StytchB2BClient.configure(
        projectId = "${projectId}",
        secret = "${secret}",
    )

    when (
        val result =
            StytchB2BClient.connectedApp.clients.update(
                UpdateRequest(
                    clientId = "m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885",
                    clientName = "My Sample Client",
                    clientDescription = "My sample client for testing out Connected Apps",
                    redirectURLs = arrayOf("https://example.com/callback"),
                    fullAccessAllowed = false,
                ),
            )
    ) {
        is StytchResult.Success -> println(result.value)
        is StytchResult.Error -> println(result.exception)
    }
}

// PUT /v1/connected_apps/clients/{client_id}
const stytch = require('stytch');

const client = new stytch.B2BClient({
  project_id: '${projectId}',
  secret: '${secret}',
});

const params = {
  client_id: "m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885",
  client_name: "My Sample Client",
  client_description: "My sample client for testing out Connected Apps",
  redirect_urls: ["https://example.com/callback"],
  full_access_allowed: false,
};

client.connectedApp.clients.update(params)
  .then(resp => { console.log(resp) })
  .catch(err => { console.log(err) });

$response = $client->connected_app->clients->update([
    'client_id' => 'm2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885',
    'client_name' => 'My Sample Client',
    'client_description' => 'My sample client for testing out Connected Apps',
    'redirect_urls' => ['https://example.com/callback'],
    'full_access_allowed' => false,
]);

# PUT /v1/connected_apps/clients/{client_id}
from stytch import B2BClient

client = B2BClient(
    project_id="${projectId}",
    secret="${secret}",
)

resp = client.connected_app.clients.update(
    client_id="m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885",
    client_name="My Sample Client",
    client_description="My sample client for testing out Connected Apps",
    redirect_urls=["https://example.com/callback"],
    full_access_allowed=False,
)

print(resp)

# frozen_string_literal: true

# PUT /v1/connected_apps/clients/{client_id}
require 'stytch'

client = StytchB2B::Client.new(
  project_id: "${projectId}",
  secret: "${secret}"
)

resp = client.connected_app.clients.update(
  client_id: "m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885",
  client_name: "My Sample Client",
  client_description: "My sample client for testing out Connected Apps",
  redirect_urls: ['https://example.com/callback'],
  full_access_allowed: false
  
)

puts resp

// PUT /v1/connected_apps/clients/{client_id}
use stytch::b2b::client::Client;
use stytch::consumer::connected_apps_clients::UpdateRequest;

fn main() {
    let client = Client::new("${projectId}", "${secret}").unwrap();
    let resp = client.connected_app.clients.update(
        UpdateRequest{
            client_id: "m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885",
            client_name: Some(String::from("My Sample Client")),
            client_description: Some(String::from("My sample client for testing out Connected Apps")),
            redirect_urls: vec!["https://example.com/callback"],
            full_access_allowed: false,
            ..Default::default()
        }
    ).await;
    println!("The response is {:?}", resp);
}

# PUT /v1/connected_apps/clients/{client_id}
curl --request PUT \
  --url https://test.stytch.com/v1/connected_apps/clients/m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885 \
  -u '${projectId}:${secret}' \
  -H 'Content-Type: application/json' \
  -d '{
    "client_name": "My Sample Client",
    "client_description": "My sample client for testing out Connected Apps",
    "redirect_urls": ["https://example.com/callback"],
    "full_access_allowed": false
  }'

{
  "request_id": "<string>",
  "connected_app": {
    "client_id": "<string>",
    "client_name": "<string>",
    "client_description": "<string>",
    "status": "<string>",
    "full_access_allowed": true,
    "client_type": "<string>",
    "redirect_urls": [
      "<string>"
    ],
    "access_token_expiry_minutes": 123,
    "access_token_template_content": "<string>",
    "post_logout_redirect_urls": [
      "<string>"
    ],
    "bypass_consent_for_offline_access": true,
    "creation_method": "<string>",
    "id_token_template_content": "<string>",
    "client_secret_last_four": "<string>",
    "next_client_secret_last_four": "<string>",
    "access_token_custom_audience": "<string>",
    "logo_url": "<string>",
    "client_id_metadata_url": "<string>"
  },
  "status_code": 123
}

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unauthorized_credentials",
  "error_message": "Unauthorized credentials.",
  "error_url": "https://stytch.com/docs/api/errors/401"
}

{
  "status_code": 429,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "too_many_requests",
  "error_message": "Too many requests have been made.",
  "error_url": "https://stytch.com/docs/api/errors/429"
}

{
  "status_code": 500,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "internal_server_error",
  "error_message": "Oops, something seems to have gone wrong, please reach out to support@stytch.com to let us know what went wrong.",
  "error_url": "https://stytch.com/docs/api/errors/500"
}

PUT

connected_apps

clients

{client_id}

// PUT /v1/connected_apps/clients/{client_id}
const stytch = require('stytch');

const client = new stytch.B2BClient({
  project_id: '${projectId}',
  secret: '${secret}',
});

const params = {
  client_id: "m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885",
  client_name: "My Sample Client",
  client_description: "My sample client for testing out Connected Apps",
  redirect_urls: ["https://example.com/callback"],
  full_access_allowed: false,
};

client.ConnectedApp.Clients.Update(params)
  .then(resp => { console.log(resp) })
  .catch(err => { console.log(err) });

// PUT /v1/connected_apps/clients/{client_id}
package main

import (
	"context"
	"log"

	"github.com/stytchauth/stytch-go/v18/stytch/b2b/b2bstytchapi"
	"github.com/stytchauth/stytch-go/v18/stytch/consumer/connectedapps/clients"
)

func main() {
	client, err := b2bstytchapi.NewClient(
		"${projectId}",
		"${secret}",
	)
	if err != nil {
		log.Fatalf("error instantiating client: %v", err)
	}

	params := &clients.UpdateParams{
		ClientID:          "m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885",
		ClientName:        "My Sample Client",
		ClientDescription: "My sample client for testing out Connected Apps",
		RedirectURLs:      []string{"https://example.com/callback"},
		FullAccessAllowed: false,
	}

	resp, err := client.ConnectedApp.Clients.Update(context.Background(), params)
	if err != nil {
		log.Fatalf("error in method call: %v", err)
	}

	log.Println(resp)
}

// PUT /v1/connected_apps/clients/{client_id}
package com.example;

import com.stytch.java.b2b.StytchB2BClient;
import com.stytch.java.common.StytchResult;
import com.stytch.java.consumer.models.connectedappsclients.UpdateRequest;

public class Main {
    public static void main(String[] args) {
        StytchB2BClient.configure("${projectId}", "${secret}");

        UpdateRequest params = new UpdateRequest();
        params.setClientId("m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885");
        params.setClientName("My Sample Client");
        params.setClientDescription("My sample client for testing out Connected Apps");
        params.setRedirectURLs(new String("https://example.com/callback"));
        params.setFullAccessAllowed(false);

        Object result = StytchB2BClient.getConnectedApp().getClients().update(params);
        if (result instanceof StytchResult.Success) {
          System.out.println(((StytchResult.Success) result).getValue());
        } else {
          System.out.println(((StytchResult.Error) result).getException());
        }
    }
}

// PUT /v1/connected_apps/clients/{client_id}
package com.example

import com.stytch.java.b2b.StytchB2BClient
import com.stytch.java.consumer.models.connectedappsclients.UpdateRequest

fun main() {
    StytchB2BClient.configure(
        projectId = "${projectId}",
        secret = "${secret}",
    )

    when (
        val result =
            StytchB2BClient.connectedApp.clients.update(
                UpdateRequest(
                    clientId = "m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885",
                    clientName = "My Sample Client",
                    clientDescription = "My sample client for testing out Connected Apps",
                    redirectURLs = arrayOf("https://example.com/callback"),
                    fullAccessAllowed = false,
                ),
            )
    ) {
        is StytchResult.Success -> println(result.value)
        is StytchResult.Error -> println(result.exception)
    }
}

// PUT /v1/connected_apps/clients/{client_id}
const stytch = require('stytch');

const client = new stytch.B2BClient({
  project_id: '${projectId}',
  secret: '${secret}',
});

const params = {
  client_id: "m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885",
  client_name: "My Sample Client",
  client_description: "My sample client for testing out Connected Apps",
  redirect_urls: ["https://example.com/callback"],
  full_access_allowed: false,
};

client.connectedApp.clients.update(params)
  .then(resp => { console.log(resp) })
  .catch(err => { console.log(err) });

$response = $client->connected_app->clients->update([
    'client_id' => 'm2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885',
    'client_name' => 'My Sample Client',
    'client_description' => 'My sample client for testing out Connected Apps',
    'redirect_urls' => ['https://example.com/callback'],
    'full_access_allowed' => false,
]);

# PUT /v1/connected_apps/clients/{client_id}
from stytch import B2BClient

client = B2BClient(
    project_id="${projectId}",
    secret="${secret}",
)

resp = client.connected_app.clients.update(
    client_id="m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885",
    client_name="My Sample Client",
    client_description="My sample client for testing out Connected Apps",
    redirect_urls=["https://example.com/callback"],
    full_access_allowed=False,
)

print(resp)

# frozen_string_literal: true

# PUT /v1/connected_apps/clients/{client_id}
require 'stytch'

client = StytchB2B::Client.new(
  project_id: "${projectId}",
  secret: "${secret}"
)

resp = client.connected_app.clients.update(
  client_id: "m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885",
  client_name: "My Sample Client",
  client_description: "My sample client for testing out Connected Apps",
  redirect_urls: ['https://example.com/callback'],
  full_access_allowed: false
  
)

puts resp

// PUT /v1/connected_apps/clients/{client_id}
use stytch::b2b::client::Client;
use stytch::consumer::connected_apps_clients::UpdateRequest;

fn main() {
    let client = Client::new("${projectId}", "${secret}").unwrap();
    let resp = client.connected_app.clients.update(
        UpdateRequest{
            client_id: "m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885",
            client_name: Some(String::from("My Sample Client")),
            client_description: Some(String::from("My sample client for testing out Connected Apps")),
            redirect_urls: vec!["https://example.com/callback"],
            full_access_allowed: false,
            ..Default::default()
        }
    ).await;
    println!("The response is {:?}", resp);
}

# PUT /v1/connected_apps/clients/{client_id}
curl --request PUT \
  --url https://test.stytch.com/v1/connected_apps/clients/m2m-client-test-d731954d-dab3-4a2b-bdee-07f3ad1be885 \
  -u '${projectId}:${secret}' \
  -H 'Content-Type: application/json' \
  -d '{
    "client_name": "My Sample Client",
    "client_description": "My sample client for testing out Connected Apps",
    "redirect_urls": ["https://example.com/callback"],
    "full_access_allowed": false
  }'

{
  "request_id": "<string>",
  "connected_app": {
    "client_id": "<string>",
    "client_name": "<string>",
    "client_description": "<string>",
    "status": "<string>",
    "full_access_allowed": true,
    "client_type": "<string>",
    "redirect_urls": [
      "<string>"
    ],
    "access_token_expiry_minutes": 123,
    "access_token_template_content": "<string>",
    "post_logout_redirect_urls": [
      "<string>"
    ],
    "bypass_consent_for_offline_access": true,
    "creation_method": "<string>",
    "id_token_template_content": "<string>",
    "client_secret_last_four": "<string>",
    "next_client_secret_last_four": "<string>",
    "access_token_custom_audience": "<string>",
    "logo_url": "<string>",
    "client_id_metadata_url": "<string>"
  },
  "status_code": 123
}

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unauthorized_credentials",
  "error_message": "Unauthorized credentials.",
  "error_url": "https://stytch.com/docs/api/errors/401"
}

{
  "status_code": 429,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "too_many_requests",
  "error_message": "Too many requests have been made.",
  "error_url": "https://stytch.com/docs/api/errors/429"
}

{
  "status_code": 500,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "internal_server_error",
  "error_message": "Oops, something seems to have gone wrong, please reach out to support@stytch.com to let us know what went wrong.",
  "error_url": "https://stytch.com/docs/api/errors/500"
}

Cannot update Client Type, Client ID, or Secrets.

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

client_id

string

required

The ID of the client.

Body

application/json

Request type

client_name

string

A human-readable name for the client.

client_description

string

A human-readable description for the client.

redirect_urls

string[]

Array of redirect URI values for use in OAuth Authorization flows.

full_access_allowed

boolean

Valid for first party clients only. If true, an authorization token granted to this Client can be exchanged for a full Stytch session.

access_token_expiry_minutes

integer<int32>

The number of minutes before the access token expires. The default is 60 minutes.

access_token_custom_audience

string

The custom audience for the access token.

access_token_template_content

string

The content of the access token custom claims template. The template must be a valid JSON object.

post_logout_redirect_urls

string[]

Array of redirect URI values for use in OIDC Logout flows.

logo_url

string

The logo URL of the Connected App, if any.

Valid for first party clients only. If true, the client does not need to request explicit user consent for the offline_access scope.

id_token_template_content

string

Response

Successful response

request_id

string

required

Globally unique UUID that is returned with every API call. This value is important to log for debugging purposes; we may ask for this value to help identify a specific API call when helping you debug an issue.

connected_app

object

required

The Connected App affected by this operation.

Show child attributes

status_code

integer<int32>

required

The HTTP status code of the response. Stytch follows standard HTTP response status code patterns, e.g. 2XX values equate to success, 3XX values are redirects, 4XX are client errors, and 5XX are server errors.

⌘I