GET /clients/{clientId} – Retrieves details of a specific client application by its ID.


Headers:

  • Authorization: Bearer <access_token> (required)
  • Content-Type: application/json or application/x-www-form-urlencoded (required)

Body:

  • None

Path Parameters:

  • clientId: The ID of the client to retrieve (required)

Query Parameters:

  • provider: The authentication provider (optional). Defaults to auth0-client if omitted. See ClientProvider.
  • userPoolId: The Cognito User Pool ID (required if provider is cognito-client)

  • 200 OK – Returns the client Client.

Status Code Meaning When it Happens
400 Bad Request Missing or invalid fields in request body
401 Unauthorized Missing or invalid authentication token
404 Not Found Specified client does not exist
500 Internal Server Error Unexpected error
{
"error": "Detailed error message here"
}

GET /clients/exampleClientId
GET /clients/exampleClientId?provider=cognito-client&userPoolId=exampleUserPoolId
	{
"id": "clientId",
"name": "string",
"secret": "string",
"callbacks": ["string"],
"allowedLogoutUrls": ["string"],
"grantTypes": ["string"],
"tokenEndpointAuthMethod": "string",
"supportedIdp": ["string"],
"description": "string",
"webOrigins": ["string"],
"appType": "string",
"clientMetadata": { "key": "value" },
"disabled": false,
"oidcConformant": true,
"auth0Id": "string"
// More fields may be present depending on the provider
}

  • Parameters

    • event: APIGatewayProxyEvent

      The API Gateway event containing the request.

    • context: Context
    • callback: Callback<APIGatewayProxyResult>

    Returns void | Promise<APIGatewayProxyResult>

    A Promise resolving to an API Gateway-compatible response.