dex/schema/workerschema
Bobby Rullo 8942a49702 server: remove client_resource api
...and dependent code.
2016-06-15 11:42:50 -07:00
..
README.md schema: remove clients API 2016-06-15 11:42:50 -07:00
util.go *: move original project to dex 2015-08-18 11:26:57 -07:00
v1-gen.go schema: remove clients API 2016-06-15 11:42:50 -07:00
v1-json.go schema: remove clients API 2016-06-15 11:42:50 -07:00
v1.json schema: remove clients API 2016-06-15 11:42:50 -07:00

Dex API

The Dex REST API

Version: v1

Models

Error

{
    error: string,
    error_description: string
}

RefreshClient

A client with associated public metadata.

{
    clientID: string,
    clientName: string,
    clientURI: string,
    logoURI: string
}

RefreshClientList

{
    clients: [
        RefreshClient
    ]
}

ResendEmailInvitationRequest

{
    redirectURL: string
}

ResendEmailInvitationResponse

{
    emailSent: boolean,
    resetPasswordLink: string
}

User

{
    admin: boolean,
    createdAt: string,
    disabled: boolean,
    displayName: string,
    email: string,
    emailVerified: boolean,
    id: string
}

UserCreateRequest

{
    redirectURL: string,
    user: User
}

UserCreateResponse

{
    emailSent: boolean,
    resetPasswordLink: string,
    user: User
}

UserDisableRequest

{
    disable: boolean // If true, disable this user, if false, enable them. No error is signaled if the user state doesn't change.
}

UserDisableResponse

{
    ok: boolean
}

UserResponse

{
    user: User
}

UsersResponse

{
    nextPageToken: string,
    users: [
        User
    ]
}

Paths

GET /account/{userid}/refresh

Summary

List RefreshClient

Description

List all clients that hold refresh tokens for the specified user.

Parameters

Name Located in Description Required Type
userid path Yes string

Responses

Code Description Type
200 RefreshClientList
default Unexpected error

DELETE /account/{userid}/refresh/{clientid}

Summary

Revoke RefreshClient

Description

Revoke all refresh tokens issues to the client for the specified user.

Parameters

Name Located in Description Required Type
clientid path Yes string
userid path Yes string

Responses

Code Description Type
default Unexpected error

GET /users

Summary

List Users

Description

Retrieve a page of User objects.

Parameters

Name Located in Description Required Type
maxResults query No integer
nextPageToken query No string

Responses

Code Description Type
200 UsersResponse
default Unexpected error

POST /users

Summary

Create Users

Description

Create a new User.

Parameters

Name Located in Description Required Type
body Yes UserCreateRequest

Responses

Code Description Type
200 UserCreateResponse
default Unexpected error

GET /users/{id}

Summary

Get Users

Description

Get a single User object by id.

Parameters

Name Located in Description Required Type
id path Yes string

Responses

Code Description Type
200 UserResponse
default Unexpected error

POST /users/{id}/disable

Summary

Disable Users

Description

Enable or disable a user.

Parameters

Name Located in Description Required Type
id path Yes string
body Yes UserDisableRequest

Responses

Code Description Type
200 UserDisableResponse
default Unexpected error

POST /users/{id}/resend-invitation

Summary

ResendEmailInvitation Users

Description

Resend invitation email to an existing user with unverified email.

Parameters

Name Located in Description Required Type
id path Yes string
body Yes ResendEmailInvitationRequest

Responses

Code Description Type
200 ResendEmailInvitationResponse
default Unexpected error