blob: c19294f7a07d3016b5226c887a1b232f08bfce58 [file] [log] [blame]
{
"basePath" : "${basePath}",
"swaggerVersion" : "1.1-SHAPSHOT.121026",
"apiVersion" : "0.1",
"apis" : [ {
"path" : "/management/token",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_auth_password_get",
"summary" : "Get management access token",
"notes" : "Get the management access token. See the OAuth2 specification for details.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "grant_type",
"dataType" : "string",
"description" : "Grant type",
"defaultValue" : "password",
"allowableValues" : {
"values" : [ "password", "client_credentials", "refresh_token", "authorization_code" ],
"valueType" : "LIST"
},
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "username",
"dataType" : "string",
"description" : "Username (for grant_type=password)",
"required" : false,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "password",
"dataType" : "string",
"description" : "Password (for grant_type=password)",
"required" : false,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "client_id",
"dataType" : "string",
"description" : "Client ID (for grant_type=client_credentials)",
"required" : false,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "client_secret",
"dataType" : "string",
"description" : "Client Secret (for grant_type=client_credentials)",
"required" : false,
"allowMultiple" : false,
"paramType" : "query"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Organization not found",
"code" : 404
} ]
}, {
"httpMethod" : "POST",
"nickname" : "mgt_auth_password_post",
"summary" : "Get management access token",
"notes" : "Get the management access token. See the OAuth2 specification for details.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "grant_type",
"dataType" : "string",
"description" : "Grant type",
"defaultValue" : "password",
"allowableValues" : {
"values" : [ "password", "client_credentials", "refresh_token", "authorization_code" ],
"valueType" : "LIST"
},
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "username",
"dataType" : "string",
"description" : "Username (for grant_type=password)",
"required" : false,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "password",
"dataType" : "string",
"description" : "Password (for grant_type=password)",
"required" : false,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "client_id",
"dataType" : "string",
"description" : "Client ID (for grant_type=client_credentials)",
"required" : false,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "client_secret",
"dataType" : "string",
"description" : "Client Secret (for grant_type=client_credentials)",
"required" : false,
"allowMultiple" : false,
"paramType" : "post"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Organization not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/authorize",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_authorize_get",
"summary" : "Authorize client",
"notes" : "Authorize the client. See the OAuth2 specification.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "response_type",
"dataType" : "string",
"description" : "Response type",
"defaultValue" : "token",
"allowableValues" : {
"values" : [ "token", "code" ],
"valueType" : "LIST"
},
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "client_id",
"dataType" : "string",
"description" : "Client ID",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "redirect_uri",
"dataType" : "string",
"description" : "Redirect URI",
"required" : false,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "scope",
"dataType" : "string",
"description" : "Access Token Scope",
"required" : false,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "state",
"dataType" : "string",
"description" : "Client State",
"required" : false,
"allowMultiple" : false,
"paramType" : "query"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Organization not found",
"code" : 404
} ]
}, {
"httpMethod" : "POST",
"nickname" : "mgt_authorize_post",
"summary" : "Authorize client",
"notes" : "Authorize the client. See the OAuth2 specification.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "response_type",
"dataType" : "string",
"description" : "Response type",
"defaultValue" : "token",
"allowableValues" : {
"values" : [ "token", "code" ],
"valueType" : "LIST"
},
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "client_id",
"dataType" : "string",
"description" : "Client ID",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "redirect_uri",
"dataType" : "string",
"description" : "Redirect URI",
"required" : false,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "scope",
"dataType" : "string",
"description" : "Access Token Scope",
"required" : false,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "state",
"dataType" : "string",
"description" : "Client State",
"required" : false,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "username",
"dataType" : "string",
"description" : "Username",
"required" : false,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "password",
"dataType" : "string",
"description" : "Password",
"required" : false,
"allowMultiple" : false,
"paramType" : "post"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Organization not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/orgs",
"description" : "Management",
"operations" : [ {
"httpMethod" : "POST",
"nickname" : "mgt_org_json_post",
"summary" : "Create new organization",
"notes" : "Create new organization. See Usergrid documentation for JSON format of body.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "json",
"dataType" : "string",
"description" : "Organization to post",
"required" : true,
"allowMultiple" : false,
"paramType" : "body"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Organization not found",
"code" : 404
} ]
}, {
"httpMethod" : "POST",
"nickname" : "mgt_org_form_post",
"summary" : "Create new organization",
"notes" : "Create new organization using form post parameters.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "organization",
"dataType" : "string",
"description" : "Organization",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "username",
"dataType" : "string",
"description" : "Admin Username",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "name",
"dataType" : "string",
"description" : "Admin Name",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "email",
"dataType" : "string",
"description" : "Admin Email",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "password",
"dataType" : "string",
"description" : "Admin Password",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Organization not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/orgs/{org_name_or_uuid}",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_org_get",
"summary" : "Find organization by name or UUID",
"notes" : "Returns the organization details",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Organization not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/orgs/{org_name_or_uuid}/activate",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_org_activate_get",
"summary" : "Activates the organization",
"notes" : "Activates the organization from link provided in email notification.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "token",
"dataType" : "string",
"description" : "Activation Token (supplied via email)",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "confirm",
"dataType" : "boolean",
"description" : "Send confirmation email",
"required" : false,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/orgs/{org_name_or_uuid}/reactivate",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_org_reactivate_get",
"summary" : "Reactivates the organization",
"notes" : "Request organization reactivation.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/orgs/{org_name_or_uuid}/feed",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_org_feed_get",
"summary" : "Get organization activity feed",
"notes" : "Get organization activity feed.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/orgs/{org_name_or_uuid}/credentials",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_org_credentials_get",
"summary" : "Get organization client credentials",
"notes" : "Get the organization client credentials.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
}, {
"httpMethod" : "POST",
"nickname" : "mgt_org_credentials_post",
"summary" : "Generate organization client credentials",
"notes" : "Generate new organization client credentials.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/orgs/{org_name_or_uuid}/users",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_org_users_get",
"summary" : "Get admin users for organization",
"notes" : "Get admin users for organization.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
}, {
"httpMethod" : "POST",
"nickname" : "mgt_org_users_json_post",
"summary" : "Create new admin user for organization",
"notes" : "Create new admin user for organization using JSON payload.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "json",
"dataType" : "string",
"description" : "Admin user to create",
"required" : true,
"allowMultiple" : false,
"paramType" : "body"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
}, {
"httpMethod" : "POST",
"nickname" : "mgt_org_users_form_post",
"summary" : "Create new admin user for organization",
"notes" : "Create new admin user for organization using form parameters.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "username",
"dataType" : "string",
"description" : "Admin Username",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "name",
"dataType" : "string",
"description" : "Admin Name",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "email",
"dataType" : "string",
"description" : "Admin Email",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "password",
"dataType" : "string",
"description" : "Admin Password",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/orgs/{org_name_or_uuid}/users/{user_username_email_or_uuid}",
"description" : "Management",
"operations" : [ {
"httpMethod" : "PUT",
"nickname" : "mgt_org_user_put",
"summary" : "Add admin users to organization",
"notes" : "Adds existing admin users for organization.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "user_username_email_or_uuid",
"dataType" : "string",
"description" : "Admin user username, email, or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
}, {
"httpMethod" : "DELETE",
"nickname" : "mgt_org_user_delete",
"summary" : "Remove admin user from organization",
"notes" : "Remove an admin user from organization.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "user_username_email_or_uuid",
"dataType" : "string",
"description" : "Admin user username, email, or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/orgs/{org_name_or_uuid}/apps",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_org_apps_get",
"summary" : "Get apps for organization",
"notes" : "Get apps for organization.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Application not found",
"code" : 404
} ]
}, {
"httpMethod" : "POST",
"nickname" : "mgt_org_apps_json_post",
"summary" : "Create new applicationfor organization",
"notes" : "Create new application for organization using JSON payload.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "json",
"dataType" : "string",
"description" : "Application to create",
"required" : true,
"allowMultiple" : false,
"paramType" : "body"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Application not found",
"code" : 404
} ]
}, {
"httpMethod" : "POST",
"nickname" : "mgt_org_apps_form_post",
"summary" : "Create new application for organization",
"notes" : "Create new application for organization using form parameters.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "name",
"dataType" : "string",
"description" : "Application Name",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Application not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/orgs/{org_name_or_uuid}/apps/{app_name_or_uuid}",
"description" : "Management",
"operations" : [ {
"httpMethod" : "DELETE",
"nickname" : "mgt_org_app_delete",
"summary" : "Delete an application in an organization",
"notes" : "Delete an application in an organization.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "app_name_or_uuid",
"dataType" : "string",
"description" : "Application name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Application not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/orgs/{org_name_or_uuid}/apps/{app_name_or_uuid}/credentials",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_org_app_credentials_get",
"summary" : "Get application keys",
"notes" : "Get application keys.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "app_name_or_uuid",
"dataType" : "string",
"description" : "Application name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Application not found",
"code" : 404
} ]
}, {
"httpMethod" : "POST",
"nickname" : "mgt_org_app_credentials_post",
"summary" : "Generate application keys",
"notes" : "Generate application keys.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "app_name_or_uuid",
"dataType" : "string",
"description" : "Application name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Application not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/users",
"description" : "Management",
"operations" : [ {
"httpMethod" : "POST",
"nickname" : "mgt_org_user_json_post",
"summary" : "Create new admin user",
"notes" : "Create new admin user. See Usergrid documentation for JSON format of body.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "json",
"dataType" : "string",
"description" : "Admin user to post",
"required" : true,
"allowMultiple" : false,
"paramType" : "body"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Organization not found",
"code" : 404
} ]
}, {
"httpMethod" : "POST",
"nickname" : "mgt_org_user_form_post",
"summary" : "Create new organization",
"notes" : "Create new admin using form post parameters.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "username",
"dataType" : "string",
"description" : "Admin Username",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "name",
"dataType" : "string",
"description" : "Admin Name",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "email",
"dataType" : "string",
"description" : "Admin Email",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "password",
"dataType" : "string",
"description" : "Admin Password",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Organization not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/users/resetpw",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_org_user_reset_password_get",
"summary" : "Initiate a user password reset",
"notes" : "Initiate a user password reset. Returns browser-viewable HTML page.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Organization not found",
"code" : 404
} ]
}, {
"httpMethod" : "POST",
"nickname" : "mgt_org_user_reset_password_form_post",
"summary" : "Complete a user password reset",
"notes" : "Complete a user password reset. Handles form POST response.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "email",
"dataType" : "string",
"description" : "Admin Email",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "recaptcha_challenge_field",
"dataType" : "string",
"description" : "Recaptcha Challenge Field",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "recaptcha_response_field",
"dataType" : "string",
"description" : "Recaptcha Response Field",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Organization not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/users/{user_username_email_or_uuid}",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_admin_user_get",
"summary" : "Returns the admin user details",
"notes" : "Returns the admin user details.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "user_username_email_or_uuid",
"dataType" : "string",
"description" : "Admin username, email or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Organization not found",
"code" : 404
} ]
}, {
"httpMethod" : "PUT",
"nickname" : "mgt_admin_user_json_put",
"summary" : "Updates the admin user details",
"notes" : "Updates the admin user details.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "user_username_email_or_uuid",
"dataType" : "string",
"description" : "Admin username, email or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "json",
"dataType" : "string",
"description" : "Admin user details",
"required" : true,
"allowMultiple" : false,
"paramType" : "body"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Organization not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/users/{user_username_email_or_uuid}/activate",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_admin_user_activate_get",
"summary" : "Activates the admin user",
"notes" : "Activates the admin user from link provided in email notification.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "token",
"dataType" : "string",
"description" : "Activation Token (supplied via email)",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "confirm",
"dataType" : "boolean",
"description" : "Send confirmation email",
"required" : false,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "user_username_email_or_uuid",
"dataType" : "string",
"description" : "Admin username, email or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/users/{user_username_email_or_uuid}/reactivate",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_admin_user_reactivate_get",
"summary" : "Reactivates the admin user",
"notes" : "Request admin user reactivation.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "user_username_email_or_uuid",
"dataType" : "string",
"description" : "Admin username, email or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/users/{user_username_email_or_uuid}/feed",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_admin_user_feed_get",
"summary" : "Get admin user activity feed",
"notes" : "Get admin user activity feed.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "user_username_email_or_uuid",
"dataType" : "string",
"description" : "Admin username, email or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/users/{user_username_email_or_uuid}/password",
"description" : "Management",
"operations" : [ {
"httpMethod" : "PUT",
"nickname" : "mgt_admin_user_password_json_put",
"summary" : "Set admin user password",
"notes" : "Set admin user password. See Usergrid documentation for JSON format of body.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "user_username_email_or_uuid",
"dataType" : "string",
"description" : "Admin username, email or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "json",
"dataType" : "string",
"description" : "Old and new password",
"required" : true,
"allowMultiple" : false,
"paramType" : "body"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/users/{user_username_email_or_uuid}/resetpw",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_admin_user_reset_password_get",
"summary" : "Initiate a user password reset",
"notes" : "Initiate a user password reset. Returns browser-viewable HTML page.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "user_username_email_or_uuid",
"dataType" : "string",
"description" : "Admin username, email or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Organization not found",
"code" : 404
} ]
}, {
"httpMethod" : "POST",
"nickname" : "mgt_admin_user_reset_password_form_post",
"summary" : "Complete a user password reset",
"notes" : "Complete a user password reset. Handles form POST response.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "user_username_email_or_uuid",
"dataType" : "string",
"description" : "Admin username, email or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "recaptcha_challenge_field",
"dataType" : "string",
"description" : "Recaptcha Challenge Field",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "recaptcha_response_field",
"dataType" : "string",
"description" : "Recaptcha Response Field",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "Organization not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/users/{user_username_email_or_uuid}/orgs",
"description" : "Management",
"operations" : [ {
"httpMethod" : "GET",
"nickname" : "mgt_admin_user_orgs_get",
"summary" : "Get organizations for admin user",
"notes" : "Get organizations for admin user.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "user_username_email_or_uuid",
"dataType" : "string",
"description" : "Admin username, email or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
}, {
"httpMethod" : "POST",
"nickname" : "mgt_admin_user_orgs_json_post",
"summary" : "Create new organization for admn user",
"notes" : "Create new organization for admin user using JSON payload.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "json",
"dataType" : "string",
"description" : "Organization to create",
"required" : true,
"allowMultiple" : false,
"paramType" : "body"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
}, {
"httpMethod" : "POST",
"nickname" : "mgt_admin_user_orgs_form_post",
"summary" : "Create new organization for admin user",
"notes" : "Create new organization for admin user using form parameters.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
}, {
"name" : "user_username_email_or_uuid",
"dataType" : "string",
"description" : "Admin username, email or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "organization",
"dataType" : "string",
"description" : "Organization name",
"required" : true,
"allowMultiple" : false,
"paramType" : "post"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
} ]
}, {
"path" : "/management/users/{user_username_email_or_uuid}/orgs/{org_name_or_uuid}",
"description" : "Management",
"operations" : [ {
"httpMethod" : "PUT",
"nickname" : "mgt_admin_user_org_put",
"summary" : "Add admin user to organization",
"notes" : "Add admin users to organization.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "user_username_email_or_uuid",
"dataType" : "string",
"description" : "Admin user username, email, or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
}, {
"httpMethod" : "DELETE",
"nickname" : "mgt_admin_user_org_delete",
"summary" : "Remove admin user from organization",
"notes" : "Remove an admin user from organization.",
"responseTypeInternal" : "",
"responseClass" : "response",
"parameters" : [ {
"name" : "access_token",
"dataType" : "string",
"description" : "The OAuth2 access token",
"required" : true,
"allowMultiple" : false,
"paramType" : "query"
}, {
"name" : "user_username_email_or_uuid",
"dataType" : "string",
"description" : "Admin user username, email, or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
}, {
"name" : "org_name_or_uuid",
"dataType" : "string",
"description" : "Organization name or uuid",
"required" : true,
"allowMultiple" : false,
"paramType" : "path"
} ],
"errorResponses" : [ {
"reason" : "Invalid ID supplied",
"code" : 400
}, {
"reason" : "User not found",
"code" : 404
} ]
} ]
} ],
"models" : {
"response" : {
"properties" : {
"id" : {
"type" : "long"
},
"name" : {
"type" : "string"
}
},
"id" : "response"
}
}
}